Une fois que vous avez créé une intégration (que vous pouvez faire en mode public, en privé, via une intégration signée ou à l'aide de l'API), vous pouvez interagir avec ces iFrames à l'aide de JavaScript. Vous pouvez rendre votre page plus dynamique en fonction de l'état de l'élément intégré et même le modifier à partir de votre page Web.
Sachez que Looker ne contrôle pas l'ordre dans lequel les navigateurs envoient les événements aux applications Web. Cela signifie que l'ordre des événements n'est pas garanti sur l'ensemble des navigateurs ou des plates-formes. Veillez à écrire votre code JavaScript de manière appropriée pour tenir compte de la gestion des événements selon les navigateurs.
Vous pouvez utiliser JavaScript de l'une des manières suivantes pour le contenu intégré à Looker:
- En utilisant le kit de développement logiciel (SDK, Software Development Kit) d'intégration de Looker, décrit sur la page de documentation Embed SDK
- Utilisation d'événements JavaScript, comme décrit dans la section Accéder aux événements en JavaScript de cette page
Préparation
Avant de pouvoir interagir avec l'iFrame intégré, procédez comme suit:
- Ajoutez un ID à l'iFrame.
- Ajoutez le domaine d'intégration à l'attribut iFrame
src
. - Ajoutez le domaine intégré à la liste d'autorisation.
Ajouter un ID à l'iFrame
Plus tard, lorsque vous récupérerez des données de l'iFrame, vous devrez vérifier que les informations avec lesquelles vous travaillez proviennent en fait de l'iFrame de Looker. Pour faciliter cette opération, veillez à ajouter un ID à votre iFrame, si vous ne l'avez pas déjà fait. Dans l'exemple suivant, vous définissez l'ID sur looker
en ajoutant id="looker"
à l'iFrame:
<iframe id="looker" src="https://instance_name.looker.com/embed/dashboards/1"></iframe>
Ajouter le domaine d'intégration à l'attribut iFrame src
Dans l'attribut src
de l'iFrame, indiquez le domaine dans lequel l'iFrame est utilisé. Dans l'exemple suivant, vous pouvez spécifier myownpersonaldomain.com
comme domaine en ajoutant ?embed_domain=https://myownpersonaldomain.com"
à la fin de l'URL dans l'attribut src
:
<iframe
id="looker"
src="https://instance_name.looker.com/embed/dashboards/1?embed_domain=https://myownpersonaldomain.com">
</iframe>
Si vous utilisez l'intégration signée, veillez à ajouter embed_domain
à l'URL d'intégration.
Si vous utilisez le SDK Embed, ajoutez sdk=2
à la fin de l'URL d'intégration. Le paramètre sdk=2
indique que le SDK est présent et que Looker peut exploiter les fonctionnalités supplémentaires fournies par le SDK, comme la transmission d'événements JavaScript entre l'iFrame Looker et votre domaine. Le SDK ne peut pas ajouter ce paramètre lui-même, car il fait partie de l'URL signée. Exemple :
<iframe
id="looker"
src="https://instance_name.looker.com/embed/dashboards/1?embed_domain=https://myownpersonaldomain.com&sdk=2">
</iframe>
Ajouter le domaine intégré à la liste d'autorisation
Enfin, vous devez ajouter le domaine sur lequel l'iFrame est utilisé à la liste d'autorisation sur la page Intégrer du panneau Administration de Looker en procédant comme suit:
Dans le champ Embedded Domain Allowlist (Liste d'autorisation de domaine intégré), saisissez le domaine dans lequel l'iFrame est utilisé, puis appuyez sur la touche Tabulation afin que le domaine s'affiche dans un champ du champ.
Cliquez sur Mettre à jour.
Vous pouvez utiliser le caractère générique *
dans la liste d'autorisation pour créer un modèle de domaine. Par exemple, https://*.myownpersonaldomain.com
autorise à la fois https://analytics.myownpersonaldomain.com
et https://data.myownpersonaldomain.com
.
Si vous utilisez l'intégration sans cookie avec Looker 23.8 ou une version ultérieure, le domaine d'intégration peut être spécifié lorsque la session sans cookie est acquise. Il s'agit d'une alternative à l'ajout du domaine intégré à la liste d'autorisation via le menu Admin > Intégrer Consultez les bonnes pratiques de sécurité si vous décidez d'utiliser cette fonctionnalité.
Récupérer des données à partir de l'iFrame
Une fois les étapes de préparation terminées, vous pouvez accéder aux événements transmis entre l'iFrame Looker et votre domaine en écoutant les événements postMessage
.
L'iFrame intégré peut créer plusieurs types d'événements, comme expliqué dans la section Type d'événement de cette page.
Accès aux événements en JavaScript
Voici un exemple d'écoute de ces événements en JavaScript natif, puis de journalisation dans la console:
window.addEventListener("message", function(event) {
if (event.source === document.getElementById("looker").contentWindow) {
if (event.origin === "https://instance_name.looker.com") {
console.log(JSON.parse(event.data));
}
}
});
Voici un exemple d'écoute de ces événements dans jQuery, puis de journalisation dans la console:
$(window).on("message", function(event) {
if (event.originalEvent.source === $("#looker")[0].contentWindow) {
if (event.origin === "https://instance_name.looker.com") {
console.log(JSON.parse(event.data));
}
}
});
Tableau récapitulatif des types d'événements
Le tableau suivant récapitule les types d'événements. Sélectionnez un type d'événement pour en afficher les détails.
Event Type | Cause de l'événement |
---|---|
dashboard:loaded |
Sur les tableaux de bord où les vignettes ne sont pas configurées pour s'exécuter automatiquement, un tableau de bord et ses éléments ont été chargés, mais les requêtes ne sont pas encore exécutées. |
dashboard:run:start |
Un tableau de bord a commencé à se charger, et ses vignettes ont commencé à charger et à interroger des données. |
dashboard:run:complete |
L'exécution d'un tableau de bord est terminée et le chargement et l'interrogation de toutes les vignettes sont terminés. |
dashboard:download |
Le téléchargement du PDF d'un tableau de bord a commencé. |
dashboard:edit:start |
AJOUTÉ LE 22.20
Un tableau de bord est passé en mode Édition. L'événement dashboard:save:complete se déclenchera une fois le tableau de bord enregistré. |
dashboard:edit:cancel |
AJOUTÉ LE 22.20 Un tableau de bord en mode Édition a été quitté du mode Édition sans être enregistré. |
dashboard:save:complete |
Un tableau de bord a été modifié et enregistré. |
dashboard:delete:complete |
Un tableau de bord a été supprimé. |
dashboard:tile:start |
Une carte a commencé à charger ou à interroger des données. |
dashboard:tile:complete |
Une carte a fini d'exécuter la requête. |
dashboard:tile:download |
Le téléchargement des données d'une carte a commencé. |
dashboard:tile:explore |
Un utilisateur a cliqué sur l'option Explorer à partir de ce lieu dans une vignette du tableau de bord. |
dashboard:tile:view |
Un utilisateur a cliqué sur l'option Afficher le Look d'origine dans une vignette du tableau de bord. |
dashboard:filters:changed |
Les filtres d'un tableau de bord ont été appliqués ou modifiés. |
look:ready |
Une présentation a commencé à charger des données de requête, que la requête soit exécutée ou non. |
look:run:start |
Une présentation a commencé à charger des données de requête et la requête a commencé à s'exécuter. |
look:run:complete |
Une présentation a fini d'exécuter la requête. |
look:save:complete |
Une présentation a été modifiée et enregistrée. |
look:delete:complete |
Une présentation a été déplacée dans le dossier Corbeille. |
drillmenu:click |
Un utilisateur a cliqué sur un menu d'analyse dans un tableau de bord créé avec le paramètre LookML link . |
drillmodal:download |
Un utilisateur a ouvert une boîte de dialogue d'analyse à partir d'une vignette de tableau de bord et cliqué sur l'option Télécharger. |
drillmodal:explore |
Un utilisateur a cliqué sur l'option Explorer à partir de ce lieu dans une boîte de dialogue d'analyse. |
explore:ready |
Une exploration commence à charger des données de requête, que la requête soit exécutée ou non. |
explore:run:start |
Une exploration a commencé à charger les données de la requête et la requête a commencé à s'exécuter. |
explore:run:complete |
Une exploration a terminé d'exécuter la requête. |
explore:state:changed |
L'URL d'une page d'exploration a changé suite aux actions de l'utilisateur. |
page:changed |
Un utilisateur a accédé à une nouvelle page dans l'iFrame. |
page:properties:changed |
La hauteur de l'iFrame d'un tableau de bord a changé. |
session:tokens |
Le client Looker a besoin de jetons pour continuer. |
session:status |
Envoie des informations sur l'état d'une session. |
env:client:dialog |
Une boîte de dialogue a été ouverte et peut être partiellement dissimulée (par exemple, une boîte de dialogue d'analyse). Cet événement permet à l'application d'hébergement de faire défiler la boîte de dialogue pour l'afficher. |
Référence de type d'événement
L'iFrame intégré peut créer de nombreux types d'événements différents:
dashboard:loaded
Sur les tableaux de bord où les vignettes ne sont pas configurées pour s'exécuter automatiquement, cet événement est créé après le chargement du tableau de bord et de ses éléments, mais avant l'exécution des requêtes.
type: "dashboard:loaded",
status: "complete",
dashboard: {
id: 1,
title: "Business Pulse",
canEdit: true,
dashboard_filters: {
"date": "Last 6 Years",
"state": ""
},
absoluteUrl: "https://self-signed.looker.com:9999/embed/dashboards/1?embed_domain=https%3A%2F%2Fself-signed.looker.com%3A9999&date=Last+6+Years&state=",
url: "/embed/dashboards/1?embed_domain=https%3A%2F%2Fself-signed.looker.com%3A9999&date=Last+6+Years&state=",
options: {
layouts: [
{
id: 1,
dashboard_id: 1,
type: "newspaper",
active: true,
column_width: null,
width: null,
deleted: false,
dashboard_layout_components: [
{
id: 1,
dashboard_layout_id: 1,
dashboard_element_id: 1,
row: 0,
column: 0,
width: 8,
height: 4,
deleted: false
},
{
id: 2,
dashboard_layout_id: 1,
dashboard_element_id: 2,
row: 0,
column: 8,
width: 8,
height: 4,
deleted: false
}
]
}
],
elements: {
1: {
title: "Total Orders",
title_hidden: false,
vis_config: {
type: "single_value",
font_size: "medium",
title: "Total Orders"
}
},
2: {
title: "Average Order Profit",
title_hidden: false,
vis_config: {
type: "single_value",
title: "Average Order Profit"
}
}
}
}
}
Attribut | Format | Description |
---|---|---|
status |
Chaîne | Indique si le tableau de bord et ses éléments ont bien été chargés. |
dashboard.id |
Nombre/chaîne | ID du tableau de bord. |
dashboard.title |
Chaîne | Titre, tel qu'il apparaît en haut du tableau de bord. |
dashboard.canEdit |
Booléen |
AJOUTÉ LE 22.20
Si la valeur est true , l'utilisateur peut modifier le tableau de bord. |
dashboard.dashboard_filters |
Objet | Filtres appliqués au tableau de bord. Cet objet a le format suivant: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard.absoluteUrl |
Chaîne | URL complète du tableau de bord. |
dashboard.url |
Chaîne | URL relative du tableau de bord (uniquement le chemin d'accès). |
dashboard.options |
Objet | Propriétés et valeurs du tableau de bord, du composant Mise en page du tableau de bord, ainsi que des propriétés et des valeurs des éléments de tableau de bord Toutes les propriétés renvoyées dans l'objet options peuvent recevoir des valeurs mises à jour à l'aide de l'événement dashboard:options:set . |
dashboard:run:start
Cet événement est créé lorsque le chargement d'un tableau de bord commence, lorsque ses vignettes commencent à charger et à interroger des données.
type: "dashboard:run:start",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
Attribut | Format | Description |
---|---|---|
dashboard.id |
Nombre/chaîne | ID du tableau de bord. |
dashboard.title |
Chaîne | Titre, tel qu'il apparaît en haut du tableau de bord. |
dashboard.canEdit |
Booléen |
AJOUTÉ LE 22.20
Si la valeur est true , l'utilisateur peut modifier le tableau de bord. |
dashboard.url |
Chaîne | URL relative du tableau de bord (uniquement le chemin d'accès). |
dashboard.absoluteUrl |
Chaîne | URL complète du tableau de bord. |
dashboard.dashboard_filters |
Objet | Filtres appliqués au tableau de bord. Cet objet a le format suivant: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard:run:complete
Cet événement est créé lorsque l'exécution d'un tableau de bord est terminée et que le chargement et l'interrogation de toutes les vignettes sont terminés. Cet événement est créé, que toutes les cartes se chargent correctement ou non.
type: "dashboard:run:complete",
status: "complete",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://my.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
options: {
layouts: [
{
id: 1,
dashboard_id: 1,
type: "newspaper",
active: true,
column_width: null,
width: null,
deleted: false,
dashboard_layout_components: [
{
id: 1,
dashboard_layout_id: 1,
dashboard_element_id: 1,
row: 0,
column: 0,
width: 8,
height: 4,
deleted: false
},
{
id: 2,
dashboard_layout_id: 1,
dashboard_element_id: 2,
row: 0,
column: 8,
width: 8,
height: 4,
deleted: false
}
]
}
],
elements: {
1: {
title: "Total Orders",
title_hidden: false,
vis_config: {
type: "single_value",
font_size: "medium",
title: "Total Orders"
}
},
2: {
title: "Average Order Profit",
title_hidden: false,
vis_config: {
type: "single_value",
title: "Average Order Profit"
}
}
}
}
}
Attribut | Format | Description |
---|---|---|
status |
Chaîne | Indique si le tableau de bord et ses éléments ont été correctement exécutés. Si le tableau de bord et ses éléments ont bien été exécutés, status renvoie "complete" . sinon status renvoie "error" . Si le tableau de bord en cours d'exécution a été arrêté, que ce soit à partir de l'interface utilisateur ou à l'aide de l'action dashboard:stop , status renvoie "stopped" . |
dashboard.id |
Nombre/chaîne | ID du tableau de bord. |
dashboard.title |
Chaîne | Titre, tel qu'il apparaît en haut du tableau de bord. |
dashboard.canEdit |
Booléen |
AJOUTÉ LE 22.20
Si la valeur est true , l'utilisateur peut modifier le tableau de bord. |
dashboard.url |
Chaîne | URL relative du tableau de bord (uniquement le chemin d'accès). |
dashboard.absoluteUrl |
Chaîne | URL complète du tableau de bord. |
dashboard.dashboard_filters |
Objet | Filtres appliqués au tableau de bord. Cet objet a le format suivant: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard.options |
Objet | Propriétés et valeurs du tableau de bord, du composant Mise en page du tableau de bord, ainsi que des propriétés et des valeurs des éléments de tableau de bord Toutes les propriétés renvoyées dans l'objet options peuvent recevoir des valeurs mises à jour à l'aide de l'action dashboard:options:set . |
dashboard.tileStatuses |
Tableau d'objets | Tableau d'objets fournissant les états des cartes. Les propriétés de l'objet sont les suivantes:
|
dashboard:download
Cet événement est créé lorsque le téléchargement du PDF d'un tableau de bord commence.
type: "dashboard:download",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
fileFormat: "pdf"
Attribut | Format | Description |
---|---|---|
dashboard.id |
Nombre/chaîne | ID du tableau de bord. |
dashboard.title |
Chaîne | Titre, tel qu'il apparaît en haut du tableau de bord. |
dashboard.canEdit |
Booléen |
AJOUTÉ LE 22.20
Si la valeur est true , l'utilisateur peut modifier le tableau de bord. |
dashboard.url |
Chaîne | URL relative du tableau de bord (uniquement le chemin d'accès). |
dashboard.absoluteUrl |
Chaîne | URL complète du tableau de bord. |
dashboard.dashboard_filters |
Objet | Filtres appliqués au tableau de bord. Cet objet a le format suivant: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
fileFormat |
Chaîne | Format du tableau de bord téléchargé (uniquement "pdf" pour le moment). |
dashboard:edit:start
AJOUTÉ LE 22.20 Cet événement est créé lorsqu'un tableau de bord passe en mode Édition.
type: "dashboard:edit:start",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
Attribut | Format | Description |
---|---|---|
dashboard.id |
Nombre/chaîne | ID du tableau de bord. |
dashboard.title |
Chaîne | Titre, tel qu'il apparaît en haut du tableau de bord. |
dashboard.canEdit |
Booléen |
AJOUTÉ LE 22.20
Si la valeur est true , l'utilisateur peut modifier le tableau de bord. |
dashboard.url |
Chaîne | URL relative du tableau de bord (uniquement le chemin d'accès). |
dashboard.absoluteUrl |
Chaîne | URL complète du tableau de bord. |
dashboard.dashboard_filters |
Objet | Filtres appliqués au tableau de bord. Cet objet a le format suivant: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard:edit:cancel
AJOUTÉ LE 22.20 Cet événement est créé lorsqu'un tableau de bord en mode Édition quitte le mode Édition sans être enregistré.
type: "dashboard:edit:cancel",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
Attribut | Format | Description |
---|---|---|
dashboard.id |
Nombre/chaîne | ID du tableau de bord. |
dashboard.title |
Chaîne | Titre, tel qu'il apparaît en haut du tableau de bord. |
dashboard.canEdit |
Booléen |
AJOUTÉ LE 22.20
Si la valeur est true , l'utilisateur peut modifier le tableau de bord. |
dashboard.url |
Chaîne | URL relative du tableau de bord (uniquement le chemin d'accès). |
dashboard.absoluteUrl |
Chaîne | URL complète du tableau de bord. |
dashboard.dashboard_filters |
Objet | Filtres appliqués au tableau de bord. Cet objet a le format suivant: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard:save:complete
Cet événement est créé lorsqu'un tableau de bord est modifié, puis enregistré.
type: "dashboard:save:complete",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
url: "/embed/dashboards/...",
options: {
layouts: [
{
id: 1,
dashboard_id: 1,
type: "newspaper",
active: true,
column_width: null,
width: null,
deleted: false,
dashboard_layout_components: [
{
id: 1,
dashboard_layout_id: 1,
dashboard_element_id: 1,
row: 0,
column: 0,
width: 8,
height: 4,
deleted: false
},
{
id: 2,
dashboard_layout_id: 1,
dashboard_element_id: 2,
row: 0,
column: 8,
width: 8,
height: 4,
deleted: false
}
]
}
],
elements: {
1: {
title: "Total Orders",
title_hidden: false,
vis_config: {
type: "single_value",
font_size: "medium",
title: "Total Orders"
}
},
2: {
title: "Average Order Profit",
title_hidden: false,
vis_config: {
type: "single_value",
title: "Average Order Profit"
}
}
}
}
}
Attribut | Format | Description |
---|---|---|
dashboard.id |
Nombre/chaîne | ID du tableau de bord. |
dashboard.title |
Chaîne | Titre, tel qu'il apparaît en haut du tableau de bord. |
dashboard.canEdit |
Booléen |
AJOUTÉ LE 22.20
Si la valeur est true , l'utilisateur peut modifier le tableau de bord. |
dashboard.dashboard_filters |
Objet | Filtres appliqués au tableau de bord. Cet objet a le format suivant: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard.absoluteUrl |
Chaîne | URL complète du tableau de bord. |
dashboard.url |
Chaîne | URL relative du tableau de bord (uniquement le chemin d'accès). |
dashboard.options |
Objet | Propriétés et valeurs du tableau de bord, du composant Mise en page du tableau de bord, ainsi que des propriétés et des valeurs des éléments de tableau de bord Toutes les propriétés renvoyées dans l'objet options peuvent recevoir des valeurs mises à jour à l'aide de l'événement dashboard:options:set . |
dashboard:delete:complete
Cet événement est créé lorsqu'un tableau de bord est supprimé.
type: "dashboard:delete:complete",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
url: "/embed/dashboards/...",
options: {
layouts: [
{
id: 1,
dashboard_id: 1,
type: "newspaper",
active: true,
column_width: null,
width: null,
deleted: false,
dashboard_layout_components: [
{
id: 1,
dashboard_layout_id: 1,
dashboard_element_id: 1,
row: 0,
column: 0,
width: 8,
height: 4,
deleted: false
},
{
id: 2,
dashboard_layout_id: 1,
dashboard_element_id: 2,
row: 0,
column: 8,
width: 8,
height: 4,
deleted: false
}
]
}
],
elements: {
1: {
title: "Total Orders",
title_hidden: false,
vis_config: {
type: "single_value",
font_size: "medium",
title: "Total Orders"
}
},
2: {
title: "Average Order Profit",
title_hidden: false,
vis_config: {
type: "single_value",
title: "Average Order Profit"
}
}
}
}
}
Attribut | Format | Description |
---|---|---|
dashboard.id |
Nombre/chaîne | ID du tableau de bord. |
dashboard.title |
Chaîne | Titre, tel qu'il apparaît en haut du tableau de bord. |
dashboard.canEdit |
Booléen |
AJOUTÉ LE 22.20
Si la valeur est true , l'utilisateur peut modifier le tableau de bord. |
dashboard.dashboard_filters |
Objet | Filtres appliqués au tableau de bord. Cet objet a le format suivant: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard.absoluteUrl |
Chaîne | URL complète du tableau de bord. |
dashboard.url |
Chaîne | URL relative du tableau de bord (uniquement le chemin d'accès). |
dashboard.options |
Objet | Propriétés et valeurs du tableau de bord, du composant Mise en page du tableau de bord, ainsi que des propriétés et des valeurs des éléments de tableau de bord Toutes les propriétés renvoyées dans l'objet options peuvent recevoir des valeurs mises à jour à l'aide de l'événement dashboard:options:set . |
dashboard:tile:start
Cet événement est créé lorsqu'une carte commence à charger ou à interroger des données.
type: "dashboard:tile:start",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
tile: {
id: 123,
title: "Quarterly Sales",
listen: {
"Date": "order.date",
"Total Orders": "order.count"
}
}
Attribut | Format | Description |
---|---|---|
dashboard.id |
Nombre/chaîne | L'identifiant du tableau de bord auquel la vignette appartient. |
dashboard.title |
Chaîne | Titre du tableau de bord, tel qu'il apparaît en haut du tableau de bord auquel la vignette appartient. |
dashboard.canEdit |
Booléen |
AJOUTÉ LE 22.20
Si la valeur est true , l'utilisateur peut modifier le tableau de bord. |
dashboard.url |
Chaîne | URL relative du tableau de bord (uniquement le chemin d'accès) auquel appartient la vignette. |
dashboard.absoluteUrl |
Chaîne | URL complète du tableau de bord auquel la vignette appartient. |
dashboard.dashboard_filters |
Objet | Filtres appliqués au tableau de bord auquel la vignette appartient. Cet objet a le format suivant: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
tile.id |
Integer | Numéro d'identification de l'événement, pas de la tuile. |
tile.title |
Chaîne | Titre de la vignette, tel qu'il apparaît en haut de la vignette. |
tile.listen |
Objet | Les filtres du tableau de bord global que cette vignette écoute. Cet objet a le format suivant: {"Filter Label": "Filter Field", ...} |
dashboard:tile:complete
Cet événement est créé lorsqu'une carte a fini d'exécuter la requête.
type: "dashboard:tile:complete",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
status: "complete",
truncated: false,
tile: {
id: 123,
title: "Quarterly Sales",
listen: {
"Date": "order.date",
"Total Orders": "order.count"
}
}
Attribut | Format | Description |
---|---|---|
dashboard.id |
Nombre/chaîne | L'identifiant du tableau de bord auquel la vignette appartient. |
dashboard.title |
Chaîne | Titre du tableau de bord, tel qu'il apparaît en haut du tableau de bord auquel la vignette appartient. |
dashboard.canEdit |
Booléen |
AJOUTÉ LE 22.20
Si la valeur est true , l'utilisateur peut modifier le tableau de bord. |
dashboard.url |
Chaîne | URL relative du tableau de bord (uniquement le chemin d'accès) auquel appartient la vignette. |
dashboard.absoluteUrl |
Chaîne | URL complète du tableau de bord auquel la vignette appartient. |
dashboard.dashboard_filters |
Objet | Filtres appliqués au tableau de bord auquel la vignette appartient. Cet objet a le format suivant: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
status |
Chaîne | Indique si la requête de carte a bien été exécutée. Les valeurs possibles sont "complete" ou "error" . |
truncated |
Booléen | Indique si les résultats de la requête de tuiles ont été tronqués à la suite du renvoi de plus de lignes que la limite de lignes de la requête. Il peut s'agir d'une limite spécifiée par l'utilisateur ou de la limite de lignes par défaut de Looker (5 000). |
tile.id |
Integer | Numéro d'identification de l'événement, pas de la tuile. |
tile.title |
Chaîne | Titre de la vignette, tel qu'il apparaît en haut de la vignette. |
tile.listen |
Objet | Les filtres du tableau de bord global que cette vignette écoute. Cet objet a le format suivant: {"Filter Label": "Filter Field", ...} |
tile.errors |
Tableau d'objets | Renseigné lorsque la propriété status est "error" . Tableau d'objets fournissant des détails sur l'erreur, y compris le texte du message d'erreur, une description plus détaillée de l'erreur et la requête SQL de la carte qui a généré l'erreur. |
dashboard:tile:download
Cet événement est créé lorsque le téléchargement des données d'une vignette commence.
type: "dashboard:tile:download",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
tile: {
id: 123,
title: "Quarterly Sales"
listen: {
"Date": "order.date",
"Total Orders": "order.count"
}
}
fileFormat: "pdf"
Attribut | Format | Description |
---|---|---|
dashboard.id |
Nombre/chaîne | L'identifiant du tableau de bord auquel la vignette appartient. |
dashboard.title |
Chaîne | Titre du tableau de bord, tel qu'il apparaît en haut du tableau de bord auquel la vignette appartient. |
dashboard.canEdit |
Booléen |
AJOUTÉ LE 22.20
Si la valeur est true , l'utilisateur peut modifier le tableau de bord. |
dashboard.url |
Chaîne | URL relative du tableau de bord (uniquement le chemin d'accès) auquel appartient la vignette. |
dashboard.absoluteUrl |
Chaîne | URL complète du tableau de bord auquel la vignette appartient. |
dashboard.dashboard_filters |
Objet | Filtres appliqués au tableau de bord auquel la vignette appartient. Cet objet a le format suivant: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
tile.id |
Integer | Numéro d'identification de l'événement, pas de la tuile. |
tile.title |
Chaîne | Titre de la vignette, tel qu'il apparaît en haut de la vignette. |
tile.listen |
Objet | Les filtres du tableau de bord global que cette vignette écoute. Cet objet a le format suivant: {"Filter Label": "Filter Field", ...} |
fileFormat |
Chaîne | Format de la tuile téléchargée ("pdf" uniquement pour le moment). |
dashboard:tile:explore
Cet événement est créé lorsqu'un utilisateur clique sur l'option Explorer à partir de ce lieu dans une vignette du tableau de bord.
type: "dashboard:tile:explore",
label: 'Explore From Here',
url: '/embed/explore/model/view...',
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
tile: {
id: 123,
title: "Quarterly Sales",
listen: {
"Date": "order.date",
"Total Orders": "order.count"
}
}
Attribut | Format | Description |
---|---|---|
label |
Chaîne | Libellé du bouton. |
url |
Chaîne | URL relative (uniquement le chemin d'accès) de l'exploration à afficher. |
dashboard.id |
Nombre/chaîne | L'identifiant du tableau de bord auquel la vignette appartient. |
dashboard.title |
Chaîne | Titre du tableau de bord, tel qu'il apparaît en haut du tableau de bord auquel la vignette appartient. |
dashboard.canEdit |
Booléen |
AJOUTÉ LE 22.20
Si la valeur est true , l'utilisateur peut modifier le tableau de bord. |
dashboard.url |
Chaîne | URL relative du tableau de bord (uniquement le chemin d'accès) auquel appartient la vignette. |
dashboard.absoluteUrl |
Chaîne | URL complète du tableau de bord auquel la vignette appartient. |
dashboard.dashboard_filters |
Objet | Filtres appliqués au tableau de bord auquel la vignette appartient. Cet objet a le format suivant: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
tile.id |
Integer | Numéro d'identification de l'événement, pas de la tuile. |
tile.title |
Chaîne | Titre de la vignette, tel qu'il apparaît en haut de la vignette. |
tile.listen |
Objet | Les filtres du tableau de bord global que cette vignette écoute. Cet objet a le format suivant: {"Filter Label": "Filter Field", ...} |
dashboard:tile:view
Cet événement est créé lorsqu'un utilisateur clique sur l'option Afficher le Look d'origine dans une vignette du tableau de bord.
type: "dashboard:tile:view",
label: 'View Original Look',
url: '/embed/look/...',
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
tile: {
id: 123,
title: "Quarterly Sales",
listen: {
"Date": "order.date",
"Total Orders": "order.count"
}
}
Attribut | Format | Description |
---|---|---|
label |
Chaîne | Libellé du bouton. |
url |
Chaîne | URL relative (uniquement le chemin d'accès) de la présentation à consulter. |
dashboard.id |
Nombre/chaîne | L'identifiant du tableau de bord auquel la vignette appartient. |
dashboard.title |
Chaîne | Titre du tableau de bord, tel qu'il apparaît en haut du tableau de bord auquel la vignette appartient. |
dashboard.canEdit |
Booléen |
AJOUTÉ LE 22.20
Si la valeur est true , l'utilisateur peut modifier le tableau de bord. |
dashboard.url |
Chaîne | URL relative du tableau de bord (uniquement le chemin d'accès) auquel appartient la vignette. |
dashboard.absoluteUrl |
Chaîne | URL complète du tableau de bord auquel la vignette appartient. |
dashboard.dashboard_filters |
Objet | Filtres appliqués au tableau de bord auquel la vignette appartient. Cet objet a le format suivant: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
tile.id |
Integer | Numéro d'identification de l'événement, pas de la tuile. |
tile.title |
Chaîne | Titre de la vignette, tel qu'il apparaît en haut de la vignette. |
tile.listen |
Objet | Les filtres du tableau de bord global que cette vignette écoute. Cet objet a le format suivant: {"Filter Label": "Filter Field", ...} |
dashboard:filters:changed
Cet événement est créé lorsque les filtres d'un tableau de bord ont été appliqués ou modifiés.
type: "dashboard:filters:changed",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
options: {
layouts: [
{
id: 1,
dashboard_id: 1,
type: "newspaper",
active: true,
column_width: null,
width: null,
deleted: false,
dashboard_layout_components: [
{
id: 1,
dashboard_layout_id: 1,
dashboard_element_id: 1,
row: 0,
column: 0,
width: 8,
height: 4,
deleted: false
},
{
id: 2,
dashboard_layout_id: 1,
dashboard_element_id: 2,
row: 0,
column: 8,
width: 8,
height: 4,
deleted: false
}
]
}
],
elements: {
1: {
title: "Total Orders",
title_hidden: false,
vis_config: {
type: "single_value",
font_size: "medium",
title: "Total Orders"
}
},
2: {
title: "Average Order Profit",
title_hidden: false,
vis_config: {
type: "single_value",
title: "Average Order Profit"
}
}
}
}
}
Attribut | Format | Description |
---|---|---|
dashboard.id |
Nombre/chaîne | ID du tableau de bord. |
dashboard.title |
Chaîne | Titre, tel qu'il apparaît en haut du tableau de bord. |
dashboard.canEdit |
Booléen |
AJOUTÉ LE 22.20
Si la valeur est true , l'utilisateur peut modifier le tableau de bord. |
dashboard.url |
Chaîne | URL relative du tableau de bord (uniquement le chemin d'accès). |
dashboard.absoluteUrl |
Chaîne | URL complète du tableau de bord. |
dashboard.dashboard_filters |
Objet | Filtres appliqués au tableau de bord. Cet objet a le format suivant: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard.options |
Objet | Propriétés et valeurs du tableau de bord, du composant Mise en page du tableau de bord, ainsi que des propriétés et des valeurs des éléments de tableau de bord Toutes les propriétés renvoyées dans l'objet options peuvent recevoir des valeurs mises à jour à l'aide de l'événement dashboard:options:set . |
look:ready
Cet événement est créé lorsqu'une présentation commence à charger des données de requête, que la requête soit exécutée ou non.
type: "look:ready",
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
}
}
Attribut | Format | Description |
---|---|---|
look.url |
Chaîne | L'URL de présentation relative (uniquement le chemin d'accès) |
look.absoluteUrl |
Chaîne | URL complète du Look |
look:run:start
Cet événement est créé lorsqu'une présentation commence à charger des données de requête et que la requête commence à s'exécuter.
type: "look:run:start",
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
}
}
Attribut | Format | Description |
---|---|---|
look.url |
Chaîne | L'URL de présentation relative (uniquement le chemin d'accès) |
look.absoluteUrl |
Chaîne | URL complète du Look |
look:run:complete
Cet événement est créé lorsqu'un Look a terminé d'exécuter la requête.
type: look:run:complete
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
}
}
Attribut | Format | Description |
---|---|---|
look.url |
Chaîne | L'URL de présentation relative (uniquement le chemin d'accès) |
look.absoluteUrl |
Chaîne | URL complète du Look |
look:save:complete
Cet événement est créé lorsqu'une présentation est modifiée et enregistrée. Cet événement est créé lorsqu'un utilisateur effectue l'une des tâches suivantes:
- Cliquer sur le bouton Modifier pour modifier la présentation, puis sur Enregistrer
- Permet d'enregistrer une présentation à l'aide de la touche Enregistrer > Option de menu Enregistrer sous
- Permet de déplacer une présentation d'un dossier à un autre
Cet événement n'est pas créé si le Look est enregistré via Enregistrer > Option de menu Dans un tableau de bord existant ou Modifier les paramètres.
type: look:save:complete
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
folderid: 123
}
}
Attribut | Format | Description |
---|---|---|
look.url |
Chaîne | L'URL de présentation relative (uniquement le chemin d'accès) |
look.absoluteUrl |
Chaîne | URL complète du Look |
look.folderid |
Integer | Identifiant du dossier dans lequel la présentation est stockée |
look:delete:complete
Cet événement est créé lorsqu'une présentation est déplacée vers le dossier Corbeille.
type: look:delete:complete
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
}
}
Attribut | Format | Description |
---|---|---|
look.url |
Chaîne | L'URL de présentation relative (uniquement le chemin d'accès) |
look.absoluteUrl |
Chaîne | URL complète du Look |
drillmenu:click
Cet événement est créé lorsqu'un utilisateur clique sur un menu d'analyse détaillée dans un tableau de bord créé avec le paramètre LookML link
. Par exemple, le code LookML suivant crée un menu d'analyse dans lequel un utilisateur peut consulter les données filtrées selon la dimension state
:
dimension: state {
type: string
sql: ${TABLE}.state ;;
link: {
label: "Filter by {{ state | encode_uri }}"
url: "filter::q={{ state | encode_uri }}"
icon_url: "https://google.com/favicon.ico"
}
}
Lorsque le filtre state
est défini sur Illinois
, l'événement drillmenu:click
renvoie le code suivant à l'hôte de l'iFrame:
type: "drillmenu:click",
label: "Filter by Illinois",
link_type: "url",
modal: false,
target: '_self',
url: "#filter::state=Illinois"
context: ' '
Attribut | Format | Description |
---|---|---|
label |
Chaîne | Libellé du lien, tel qu'il apparaît dans le menu d'analyse |
link_type |
Chaîne | Type d'objet à la destination du lien |
modal |
Booléen | Indique si la boîte de dialogue d'analyse détaillée sera utilisée à la place de la navigation dans le navigateur |
target |
Chaîne | La valeur est _self si la destination du lien remplace l'iFrame actuel, ou _blank si la destination du lien ouvre une nouvelle fenêtre. |
url |
Chaîne | URL de destination du lien |
context |
Chaîne | Attribut interne utilisé par certains types de visualisations |
En bac à sable, vous empêchez les clics du menu d'analyse de s'ouvrir dans une nouvelle fenêtre. Indiquez les valeurs de bac à sable suivantes dans le tag iFrame:
sandbox = "allow-same-origin allow-scripts"
drillmodal:download
Cet événement est créé lorsqu'un utilisateur ouvre une boîte de dialogue d'analyse à partir d'une vignette de tableau de bord et clique sur l'option Télécharger.
{
type: "drillmodal:download",
dashboard: {
id: 23,
title: "My Dashboard",
url: "/embed/dashboards/…",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/…",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
drillExploreUrl: "/embed...",
fileFormat: "pdf"
}
Attribut | Format | Description |
---|---|---|
dashboard.id |
Nombre/chaîne | L'identifiant du tableau de bord auquel la vignette appartient. |
dashboard.title |
Chaîne | Titre du tableau de bord, tel qu'il apparaît en haut du tableau de bord auquel la vignette appartient. |
dashboard.url |
Chaîne | URL relative du tableau de bord (uniquement le chemin d'accès) auquel appartient la vignette. |
dashboard.absoluteUrl |
Chaîne | URL complète du tableau de bord auquel la vignette appartient. |
dashboard.dashboard_filters |
Objet | Filtres appliqués au tableau de bord auquel la vignette appartient. Cet objet a le format suivant: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
drillExploreUrl |
Chaîne | URL d'exploration relative (uniquement le chemin d'accès) à télécharger. |
fileFormat |
Chaîne | Format du fichier de téléchargement des données. |
drillmodal:explore
Cet événement est créé lorsqu'un utilisateur clique sur l'option Explorer à partir de ce lieu dans une boîte de dialogue d'analyse.
type: "drillmodal:explore",
label: "Explore From Here",
url: "/embed/explore/model/view..."
Attribut | Format | Description |
---|---|---|
label |
Chaîne | Libellé du bouton, tel qu'il apparaît dans le menu d'analyse |
url |
Chaîne | URL d'exploration relative (uniquement le chemin d'accès) à afficher |
explore:ready
Cet événement est créé lorsqu'une exploration commence à charger des données de requête, que celle-ci soit exécutée ou non.
type: "explore:ready",
explore: {
url: "/embed/explore/...",
absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
}
}
Attribut | Format | Description |
---|---|---|
explore.url |
Chaîne | L'URL d'exploration relative (uniquement le chemin d'accès) |
explore.absoluteUrl |
Chaîne | URL d'exploration complète |
explore:run:start
Cet événement est créé lorsqu'une exploration commence à charger des données de requête et que la requête commence à s'exécuter.
type: "explore:run:start",
explore: {
url: "/embed/explore/...",
absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
}
}
Attribut | Format | Description |
---|---|---|
explore.url |
Chaîne | L'URL d'exploration relative (uniquement le chemin d'accès) |
explore.absoluteUrl |
Chaîne | URL d'exploration complète |
explore:run:complete
Cet événement est créé lorsqu'une exploration a terminé d'exécuter la requête.
type: "explore:run:complete",
explore: {
url: "/embed/explore/...",
absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
}
}
Attribut | Format | Description |
---|---|---|
explore.url |
Chaîne | L'URL d'exploration relative (uniquement le chemin d'accès) |
explore.absoluteUrl |
Chaîne | URL d'exploration complète |
explore:state:changed
Cet événement est créé lorsqu'une URL de page d'exploration change suite aux actions de l'utilisateur.
type: "explore:state:changed",
explore: {
url: "/embed/explore/...",
absoluteUrl: "https://instance_name.looker.com/embed/explore/..."
}
Attribut | Format | Description |
---|---|---|
explore.url |
Chaîne | L'URL d'exploration relative (uniquement le chemin d'accès) |
explore.absoluteUrl |
Chaîne | URL d'exploration complète |
page:changed
Cet événement est créé lorsqu'un utilisateur accède à une nouvelle page dans l'iFrame.
type: "page:changed",
page: {
type: "dashboard",
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/..."
}
Attribut | Format | Description |
---|---|---|
page.type |
Chaîne | Type de page auquel l'utilisateur vient d'accéder (par exemple, "dashboard" , "look" ou "explore" ) |
page.url |
Chaîne | URL relative (uniquement le chemin d'accès) de la page à laquelle l'utilisateur vient d'accéder |
page.absoluteUrl |
Chaîne | L'URL complète de la page à laquelle l'utilisateur vient d'accéder |
page:properties:changed
Cet événement est créé lorsque la hauteur de l'iFrame d'un tableau de bord est modifiée. Elle n'est pas disponible pour les Looks et les explorations, car ces éléments ajustent automatiquement leur hauteur à la taille de l'iFrame.
type: "page:properties:changed",
height: 1000
Attribut | Format | Description |
---|---|---|
height |
Integer | Hauteur de l'iFrame du tableau de bord en pixels |
session:tokens
Cet événement indique que le client Looker a besoin de jetons pour continuer. Cet événement est créé immédiatement après la création de l'iFrame, puis périodiquement pendant toute la durée de la session.
{
"type": "session:tokens",
"api_token": "eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczovL3NlbGYtc2lnbmVkLmxvb2tlci5jb206OTk5OSIsImV4cCI6MTY3MDYyNjMzMCwic3ViIjoiYVdrNWFGUzM4RnRwNzFFWXhuS3ZaMXdKRmV3ZjB2VzYtTV9zLWtCcHE1dXIiLCJ0b2tlbl90eXBlIjoiYXBpX3Rva2VuIiwicmFuZG9taXplciI6IkxjYnpOeDNTVjNOb3o3UVlqTVJjNmhlMkdodjh1a2UwWUhiZWNRMHVCYm1KIn0.CBv1__QGc_H7bKNe31SHMMQCsc5ya1xOiEv1UDWAyxM",
"api_token_ttl": 463,
"navigation_token": "eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczovL3NlbGYtc2lnbmVkLmxvb2tlci5jb206OTk5OSIsImV4cCI6MTY3MDYyNjMzMCwic3ViIjoiYVdrNWFGUzM4RnRwNzFFWXhuS3ZaMXdKRmV3ZjB2VzYtTV9zLWtCcHE1dXIiLCJ0b2tlbl90eXBlIjoibmF2aWdhdGlvbl90b2tlbiIsInJhbmRvbWl6ZXIiOiJHVVNlc00tdTRPRDlNdktodFJDU2pEcVFhUkJNeTh5dm42Q1FDUXhuLTNxMiJ9.sWo7LUEI5LeragVmeDamUR7u2myXpFJ0aqK_IIALUqI",
"navigation_token_ttl": 463,
"session_reference_token_ttl": 2924
}
Attribut | Format | Description |
---|---|---|
authentication_token |
Chaîne | Jeton d'authentification. Inclus lors de la création de l'iFrame. Non incluse dans la réponse à une requête de génération de jetons ou si la session a expiré. |
authentication_token_ttl |
Nombre | Valeur TTL (Time To Live) du jeton d'authentification en secondes Inclus lors de la création de l'iFrame. Non incluse dans la réponse à une requête de génération de jetons ou si la session a expiré. |
api_token |
Chaîne | Jeton d'API. Non incluse si la session a expiré. |
api_token_ttl |
Nombre | Valeur TTL (Time To Live) du jeton d'API en secondes Non incluse si la session a expiré. |
navigation_token |
Chaîne | Jeton de navigation. Non incluse si la session a expiré. |
navigation_token_ttl |
Nombre | Valeur TTL (Time To Live) du jeton de navigation en secondes Non incluse si la session a expiré. |
session_references_token_ttl |
Nombre | Durée de vie de la session en secondes. La valeur sera de 0 lorsque la session aura expiré. Pour effectuer une récupération, l'application d'intégration doit acquérir une nouvelle session. |
session:status
L'événement est généré lorsque l'application Looker intégrée traite les demandes de jetons de session.
{
"type": "session:status",
"session_ttl": 0,
"expired": true,
"interrupted": false
}
Attribut | Format | Description |
---|---|---|
session_ttl |
Nombre | Durée de vie de la session en secondes. |
expired |
Booléen | Lorsque true indique que la session a expiré. |
interrupted |
Booléen | Lorsque true , indique qu'une demande de jetons de session n'a pas fait l'objet d'une réponse. Cela peut indiquer qu'un serveur est temporairement indisponible. |
recoverable |
Booléen | Renseigné uniquement en cas d'interruption pour true . Indique si la session peut être récupérée ou non. La valeur false signifie probablement qu'il y a un problème avec l'application d'intégration. |
env:client:dialog
L'événement est généré lorsqu'une boîte de dialogue s'ouvre et n'est peut-être pas entièrement visible (par exemple, une boîte de dialogue d'analyse détaillée). Cet événement permet à l'application d'hébergement de faire défiler la boîte de dialogue pour l'afficher à l'aide de l'action env:host:scroll
.
{
type: "env:client:dialog",
dialogType: 'drilling',
placement: 'cover',
open: true
}
Attribut | Format | Description |
---|---|---|
type |
Chaîne | env:client:dialog indique qu'une boîte de dialogue a été ouverte ou fermée. Actuellement, seule la boîte de dialogue d'analyse détaillée est disponible, mais d'autres boîtes de dialogue pourront être ajoutées ultérieurement. Il est possible que le haut de la boîte de dialogue d'analyse détaillée ne soit pas visible, car celle-ci recouvre la fenêtre d'affichage iFrame. Cet événement permet à l'application hôte de faire défiler le haut de la boîte de dialogue pour l'afficher. |
dialogType |
Chaîne | Type de boîte de dialogue. Actuellement, seule l'ouverture ou la fermeture du "forage" type de boîte de dialogue déclenche cet événement. |
placement |
Chaîne | Positionnement de la boîte de dialogue. Boîtes de dialogue de type "perçage" utilisez toujours "cover" comme placement . |
open |
Booléen | Indique si la boîte de dialogue est ouverte ou si elle est déroulante. |
Apporter des modifications à l'iFrame
Après avoir préparé votre iFrame pour récupérer les données, vous pouvez le modifier en procédant comme suit:
Écrire votre requête au format JSON
Vous pouvez apporter plusieurs modifications à l'iFrame, puis les envoyer au format JSON. Les options disponibles sont décrites dans la section Documentation de référence sur les actions de cette page. N'oubliez pas d'utiliser JSON.stringify
pour transformer votre action au format JSON, comme ceci:
var my_request = JSON.stringify(
{
type: "dashboard:run"
}
);
Publier la requête dans la propriété contentWindow
de l'iFrame
Enfin, publiez votre message dans le fichier iFrame contentWindow
de l'iFrame, comme ceci:
var my_iframe = document.getElementById("my_iframe_id");
my_iframe.contentWindow.postMessage(my_request, 'https://instance_name.looker.com');
Tableau récapitulatif des actions
Le tableau suivant récapitule les actions. Sélectionnez une action pour en afficher les détails.
Action | Description de l'action |
---|---|
dashboard:load |
Charge un nouveau tableau de bord dans l'iFrame. Il remplace un tableau de bord existant. |
dashboard:run |
Exécute le tableau de bord dans l'iFrame. |
dashboard:edit |
AJOUTÉ LE 22.20 Fait passer le tableau de bord en mode Édition. |
dashboard:filters:update |
Met à jour un filtre de tableau de bord existant dans l'iFrame. |
dashboard:options:set |
Écrit de nouvelles valeurs dans la mise en page du tableau de bord et dans les propriétés des éléments du tableau de bord. |
dashboard:schedule_modal:open |
Ouvre le planificateur, qui permet aux utilisateurs de fournir du contenu Looker à différentes destinations. |
dashboard:stop |
Arrête un tableau de bord en cours d'exécution ou en train d'actualiser des données. |
look:run |
Exécute le Look dans l'iFrame. |
look:filters:update |
Met à jour un filtre de Look existant dans l'iFrame. |
explore:run |
Exécute l'exploration dans l'iFrame. |
explore:filters:update |
Met à jour ou supprime un filtre d'exploration existant dans l'iFrame. |
session:tokens:request |
Envoie des jetons en réponse à un événement session:tokens:request . |
env:host:scroll |
Envoie des informations sur la position de défilement actuelle de l'iFrame hôte à l'application Looker intégrée. |
Référence de l'action
Voici les actions disponibles que vous pouvez publier dans l'iFrame intégré:
dashboard:load
Utilisez cette action pour charger un nouveau tableau de bord dans l'iFrame, en remplacement d'un tableau de bord existant. Le nouveau tableau de bord commencera à exécuter les requêtes comme si une nouvelle page de tableau de bord avait été ouverte.
{
type: "dashboard:load",
id: "101",
pushHistory: false
}
Attribut | Format | Description |
---|---|---|
type |
Chaîne | L'utilisation du type dashboard:load indique que vous souhaitez charger un nouveau tableau de bord dans l'iFrame. |
id |
Chaîne | ID du tableau de bord à charger. |
pushHistory |
Booléen | Si la valeur est true , le tableau de bord chargé crée une entrée dans l'historique du navigateur. L'utilisateur peut cliquer sur le bouton "Retour" du navigateur pour revenir au tableau de bord précédent. Si la valeur est false , le tableau de bord actuel est remplacé et la navigation dans le navigateur ne peut pas être utilisée pour y revenir. |
dashboard:run
Utilisez cette action pour exécuter le tableau de bord dans l'iFrame. Cela revient à appuyer sur le bouton Exécuter ou Actualiser les données du tableau de bord.
{
type: "dashboard:run"
}
Attribut | Format | Description |
---|---|---|
type |
Chaîne | L'utilisation du type dashboard:run indique que vous souhaitez exécuter le tableau de bord. |
dashboard:edit
AJOUTÉ LE 22.20 Cette action vous permet de faire passer un tableau de bord existant dans l'iFrame en mode Édition. Cela revient à sélectionner Modifier le tableau de bord dans le menu correspondant.
{
type: "dashboard:edit"
}
Attribut | Format | Description |
---|---|---|
type |
Chaîne | L'utilisation du type dashboard:edit indique que vous souhaitez passer le tableau de bord en mode Édition. |
dashboard:filters:update
Utilisez cette action pour mettre à jour un filtre de tableau de bord existant dans l'iFrame. Cette méthode ne vous permet pas d'ajouter un nouveau filtre au tableau de bord.
{
type: "dashboard:filters:update",
filters: {
"Sale date": "Last 28 days",
"Sale amount": "Greater than 100"
}
}
Attribut | Format | Description |
---|---|---|
type |
Chaîne | L'utilisation du type dashboard:filters:update indique que vous souhaitez mettre à jour les filtres utilisés par le tableau de bord. |
filters |
Objet | Nouveaux filtres que vous souhaitez appliquer au tableau de bord. Cet objet a le format suivant: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard:options:set
Cette action est disponible une fois que l'événement dashboard:run:complete
s'est produit.
L'outil d'intégration crée le message et l'envoie à l'iFrame, mais le tableau de bord ne répond qu'après dashboard:run:complete
. L'action dashboard:options:set
écrit les nouvelles valeurs dans les propriétés de mise en page et d'élément du tableau de bord. Seules les propriétés renvoyées dans l'attribut options
de l'événement dashboard:run:complete
peuvent être mises à jour à l'aide de dashboard:options:set
. Toutes les propriétés définies qui n'ont pas été renvoyées par l'attribut options
de l'événement dashboard:run:complete
sont ignorées.
{
type: "dashboard:options:set",
layouts: [
{
id: 1,
dashboard_id: 1,
type: "newspaper",
active: true,
column_width: null,
width: null,
deleted: false,
dashboard_layout_components: [
{
id: 1,
dashboard_layout_id: 1,
dashboard_element_id: 1,
row: 0,
column: 0,
width: 8,
height: 4,
deleted: false
},
{
id: 2,
dashboard_layout_id: 1,
dashboard_element_id: 2,
row: 0,
column: 8,
width: 8,
height: 4,
deleted: false
}
]
}
],
elements: {
1: {
title: "Total Orders",
title_hidden: false,
vis_config: {
type: "single_value",
font_size: "medium",
title: "Total Orders"
}
},
2: {
title: "Average Order Profit",
title_hidden: false,
vis_config: {
type: "single_value",
title: "Average Order Profit"
}
}
}
}
Attribut | Format | Description |
---|---|---|
type |
Chaîne | L'utilisation du type dashboard:options:set indique que vous souhaitez écrire de nouvelles valeurs dans les propriétés de mise en page et d'élément de tableau de bord. |
layouts |
Objet | Propriétés de mise en page du tableau de bord renvoyées par l'attribut options dans l'événement dashboard:run:complete . Leur format est semblable à celui-ci:
|
layouts.dashboard_layout_components |
Objet | Un ou plusieurs objets de composant de mise en page de tableau de bord renvoyés par l'attribut options dans l'événement dashboard:run:complete Leur format est semblable à celui-ci:
|
elements |
Objet | Un ou plusieurs objets dashboard item renvoyés par l'attribut options dans l'événement dashboard:run:complete . Leur format est semblable à celui-ci:id: { title: "string", title_hidden: boolean, vis_config: { type: "string", title: "string" }} |
dashboard:schedule_modal:open
Utilisez cette action pour ouvrir le planificateur, qui permet aux utilisateurs d'envoyer du contenu Looker à différentes destinations.
{
type: "dashboard:schedule_modal:open"
}
Attribut | Format | Description |
---|---|---|
type |
Chaîne | L'utilisation du type dashboard:schedule_modal:open indique que vous souhaitez ouvrir la boîte de dialogue Programmer. |
dashboard:stop
Utilisez cette action pour arrêter un tableau de bord en cours d'exécution ou en train d'actualiser des données. Cela revient à cliquer sur le bouton Annuler du tableau de bord. Un tableau de bord a cessé d'utiliser dashboard:stop
envoie un événement dashboard:run:complete
avec status:
défini sur "stopped"
.
{
type: "dashboard:stop"
}
Attribut | Format | Description |
---|---|---|
type |
Chaîne | L'utilisation du type dashboard:stop indique que vous souhaitez arrêter le tableau de bord en cours d'exécution. |
look:run
Utilisez cette action pour exécuter la requête sur laquelle la présentation est basée dans l'iFrame. Cette action est semblable à l'utilisation du bouton Run (Exécuter) de la présentation, à la différence que look:run
interroge toujours directement la base de données et ne récupère pas les données du cache Looker.
{
type: "look:run"
}
Attribut | Format | Description |
---|---|---|
type |
Chaîne | L'utilisation du type look:run indique que vous souhaitez exécuter la présentation. |
look:filters:update
Utilisez cette action pour mettre à jour un filtre de Look existant dans l'iFrame. Cette méthode ne vous permet pas d'ajouter un nouveau filtre à la présentation.
{
type: "look:filters:update",
filters: {
"orders.created_at": "90 days",
"products.department": "sweaters"
}
}
Attribut | Format | Description |
---|---|---|
type |
Chaîne | L'utilisation du type look:filters:update indique que vous souhaitez mettre à jour les filtres utilisés par la présentation. |
filters |
Objet | Nouveaux filtres que vous souhaitez appliquer à la présentation. Cet objet a le format suivant: {"view_name.field_name_1": "value 1", "view_name.field_name_1": "value 2", ...} |
explore:run
Utilisez cette action pour exécuter l'exploration dans l'iFrame. Cette action est semblable à l'utilisation du bouton Run (Exécuter) de l'exploration, à la différence que explore:run
interroge toujours directement la base de données et ne récupère pas les données du cache Looker.
{
type: "explore:run"
}
Attribut | Format | Description |
---|---|---|
type |
Chaîne | L'utilisation du type explore:run indique que vous souhaitez exécuter l'exploration. |
explore:filters:update
Utilisez cette action pour mettre à jour ou supprimer un filtre d'exploration existant dans l'iFrame. Si vous incluez un nouveau filtre qui référence un champ valide, il est ajouté à l'exploration.
{
type: "explore:filters:update",
filters: {
"orders.created_at": "90 days",
"orders.status": "complete"
}
deleteFilters: ["products.department"]
}
Attribut | Format | Description |
---|---|---|
type |
Chaîne | L'utilisation du type explore:filters:update indique que vous souhaitez mettre à jour les filtres utilisés par l'exploration. |
filters |
Objet | Nouveaux filtres que vous souhaitez appliquer à l'exploration. Si filters inclut un filtre qui n'existe pas actuellement dans l'exploration, mais qui fait référence à un champ valide, ce filtre est ajouté à l'exploration. Cet objet a le format suivant: {"view_name.field_name_1": "value 1", "view_name.field_name_1": "value 2", ...} |
deleteFilters |
Tableau | Filtres existants que vous souhaitez supprimer de l'exploration. Le tableau a le format suivant: ["view_name.field_name_1", "view_name.field_name_2", ...] |
session:tokens:request
Utilisez cette action pour envoyer des jetons en réponse à une requête session:tokens:request
.
{
type: "session:tokens:request",
}
Attribut | Format | Description |
---|---|---|
type |
Chaîne | L'utilisation du type session:tokens:request indique que vous souhaitez envoyer des jetons en réponse à un événement session:tokens:request . |
env:host:scroll
Utilisez cette action pour envoyer des informations sur la position de défilement actuelle de l'iFrame hôte à l'application Looker intégrée.
{
type: "env:host:scroll",
offsetTop: 10,
offsetLeft: 10,
scrollX: 5,
scrollY: 5
}
Attribut | Format | Description |
---|---|---|
type |
Chaîne | L'utilisation du type env:host:scroll indique que vous souhaitez envoyer des informations sur la position de défilement actuelle de l'iFrame hôte à l'application Looker intégrée. |
offsetTop |
Nombre | Décalage vers le haut de l'iFrame. |
offsetLeft |
Nombre | Décalage à gauche de l'iFrame. |
scrollX |
Nombre | Position défilementX de l'hôte de l'application. |
scrollY |
Nombre | Position de défilement Y de l'hôte de l'application. |