Nachdem Sie eine Einbettung erstellt haben – entweder öffentlich, privat, mit signierter Einbettung oder über die API – können Sie mit diesen iFrames über JavaScript interagieren. Sie können Ihre Seite basierend auf dem Status des eingebetteten Elements dynamischer gestalten und sogar Änderungen am eingebetteten Element von Ihrer Webseite aus vornehmen.
Beachten Sie, dass Looker nicht die Reihenfolge steuert, in der Browser Ereignisse an Webanwendungen senden. Das bedeutet, dass die Reihenfolge der Ereignisse nicht browser- oder plattformübergreifend garantiert ist. Achten Sie darauf, dass Ihr JavaScript-Code die Ereignisbehandlung verschiedener Browser berücksichtigt.
Sie können JavaScript auf eine der folgenden Arten für eingebettete Looker-Inhalte verwenden:
- Mit dem Looker Embed Software Development Kit (SDK), das auf der Dokumentationsseite Embed SDK beschrieben wird
- JavaScript-Ereignisse, die im Abschnitt Auf Ereignisse in JavaScript zugreifen auf dieser Seite beschrieben werden
Vorbereitung
Bevor Sie mit dem eingebetteten iFrame interagieren können, müssen Sie die folgenden Schritte ausführen:
- Fügen Sie dem iFrame eine ID hinzu.
- Fügen Sie die Einbettungsdomain dem iframe-Attribut
srchinzu. - Fügen Sie die Einbettungsdomain zur Zulassungsliste hinzu.
ID zum iFrame hinzufügen
Wenn Sie später Daten aus dem iFrame abrufen, müssen Sie prüfen, ob die Informationen, mit denen Sie arbeiten, tatsächlich aus dem iFrame von Looker stammen. Fügen Sie dazu Ihrem iFrame eine ID hinzu, falls Sie das noch nicht getan haben. Im folgenden Beispiel wird die ID auf looker festgelegt, indem dem iFrame id="looker" hinzugefügt wird:
<iframe id="looker" src="https://instance_name.looker.com/embed/dashboards/1"></iframe>
Einbettungsdomain zum iframe-Attribut src hinzufügen
Geben Sie im Attribut src des iFrames die Domain an, in der der iFrame verwendet wird. Im folgenden Beispiel können Sie myownpersonaldomain.com als Domain angeben, indem Sie ?embed_domain=https://myownpersonaldomain.com" am Ende der URL im Attribut src hinzufügen:
<iframe
id="looker"
src="https://instance_name.looker.com/embed/dashboards/1?embed_domain=https://myownpersonaldomain.com">
</iframe>
Wenn Sie die signierte Einbettung verwenden, müssen Sie die embed_domain der Einbettungs-URL hinzufügen.
Wenn Sie das Embed SDK verwenden, fügen Sie sdk=3 am Ende der Einbettungs-URL hinzu. Der Parameter sdk=3 gibt an, dass das SDK vorhanden ist und Looker zusätzliche Funktionen des SDK nutzen kann, z. B. die Übergabe von JavaScript-Ereignissen zwischen dem Looker-Iframe und Ihrer Domain. Das SDK kann diesen Parameter nicht selbst hinzufügen, da er Teil der signierten URL ist. Beispiel:
<iframe
id="looker"
src="https://instance_name.looker.com/embed/dashboards/1?embed_domain=https://myownpersonaldomain.com&sdk=2">
</iframe>
Einbettungsdomain zur Zulassungsliste hinzufügen
Schließlich müssen Sie die Domain, in der der iFrame verwendet wird, der Zulassungsliste auf der Seite Einbetten im Admin-Bereich von Looker hinzufügen. Gehen Sie dazu so vor:
Geben Sie im Feld Zulassungsliste für eingebettete Domains die Domain ein, in der der iFrame verwendet wird, und drücken Sie dann die Tabulatortaste, damit die Domain in einem Feld innerhalb des Felds angezeigt wird.
Klicken Sie auf Aktualisieren.
Sie können den Platzhalter * in der Zulassungsliste verwenden, um ein Domainmuster zu erstellen. Beispiel: https://*.myownpersonaldomain.com würde sowohl https://analytics.myownpersonaldomain.com als auch https://data.myownpersonaldomain.com zulassen.
Wenn Sie die cookielose Einbettung mit Looker 23.8 oder höher verwenden, kann die Einbettungsdomain angegeben werden, wenn die cookielose Sitzung erfasst wird. Dies ist eine Alternative zum Hinzufügen der Einbettungsdomain zur Zulassungsliste über den Bereich Admin > Einbetten. Wenn Sie diese Funktion nutzen möchten, lesen Sie die Best Practices für die Sicherheit.
Daten aus dem iFrame abrufen
Nachdem Sie die Vorbereitungsschritte abgeschlossen haben, können Sie auf die Ereignisse zugreifen, die zwischen dem Looker-Iframe und Ihrer Domain übergeben werden, indem Sie auf postMessage-Ereignisse warten.
Der eingebettete iFrame kann einige Ereignistypen erstellen, wie im Abschnitt Referenz zu Ereignistypen auf dieser Seite beschrieben.
Auf Ereignisse in JavaScript zugreifen
Hier ist ein Beispiel dafür, wie Sie in JavaScript auf diese Ereignisse warten und sie dann in der Konsole protokollieren:
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));
}
}
});
Hier ist ein Beispiel dafür, wie Sie in jQuery auf diese Ereignisse warten und sie dann in der Konsole protokollieren:
$(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));
}
}
});
Zusammenfassungstabelle für Ereignistypen
In der folgenden Tabelle sind die Ereignistypen zusammengefasst. Wählen Sie einen Ereignistyp aus, um die Details zu diesem Ereignis aufzurufen.
| Ereignistyp | Ursache des Ereignisses |
|---|---|
dashboard:loaded |
Auf Dashboards, auf denen die Tiles nicht automatisch ausgeführt werden, wurden ein Dashboard und seine Elemente geladen, aber die Abfragen werden noch nicht ausgeführt. |
dashboard:run:start |
Ein Dashboard wird geladen und die zugehörigen Tiles werden geladen und fragen Daten ab. |
dashboard:run:complete |
Ein Dashboard wurde ausgeführt und alle Tiles wurden geladen und abgefragt. |
dashboard:download |
Der Download einer PDF-Datei eines Dashboards wurde gestartet. |
dashboard:edit:start |
Hinzugefügt in 22.20
Ein Dashboard wurde in den Bearbeitungsmodus versetzt. Das Ereignis dashboard:save:complete wird ausgelöst, wenn das Dashboard gespeichert wurde. |
dashboard:edit:cancel |
Hinzugefügt am 22.20 Ein Dashboard, das sich im Bearbeitungsmodus befindet, wurde ohne Speichern verlassen. |
dashboard:save:complete |
Ein Dashboard wurde bearbeitet und gespeichert. |
dashboard:delete:complete |
Ein Dashboard wurde gelöscht. |
dashboard:tile:start |
Eine Tile hat mit dem Laden oder Abfragen von Daten begonnen. |
dashboard:tile:complete |
Eine Tile hat die Abfrage abgeschlossen. |
dashboard:tile:download |
Der Download der Daten einer Kachel wurde gestartet. |
dashboard:tile:explore |
Ein Nutzer hat in einer Dashboard-Tile auf die Option Von hier aus explorativ analysieren geklickt. |
dashboard:tile:merge |
Hinzugefügt am 25.14 Ein Nutzer hat auf die Schaltfläche oder den Menüpunkt „Zusammengeführte Abfrage bearbeiten“ geklickt. |
dashboard:tile:view |
Ein Nutzer hat in einer Dashboard-Tile auf die Option Original-Look ansehen geklickt. |
dashboard:filters:changed |
Die Filter eines Dashboards wurden angewendet oder geändert. |
look:ready |
Ein Look hat mit dem Laden von Abfragedaten begonnen, unabhängig davon, ob die Abfrage ausgeführt wird oder nicht. |
look:run:start |
Ein Look hat mit dem Laden von Abfragedaten begonnen und die Abfrage wird ausgeführt. |
look:run:complete |
Ein Look hat die Abfrage abgeschlossen. |
look:edit:start |
Hinzugefügt am 25.10.
Ein Look wurde in den Bearbeitungsmodus versetzt. Das Ereignis look:save:complete wird ausgelöst, wenn der Look gespeichert wird. |
look:edit:cancel |
Hinzugefügt in 25.10 Ein Look, der sich im Bearbeitungsmodus befindet, wurde ohne Speichern aus dem Bearbeitungsmodus beendet. |
look:save:complete |
Ein Look wurde bearbeitet und gespeichert. |
look:delete:complete |
Ein Look wurde in den Papierkorb verschoben. |
drillmenu:click |
Ein Nutzer hat in einem Dashboard, das mit dem LookML-Parameter link erstellt wurde, auf ein Aufschlüsselungsmenü geklickt. |
drillmodal:download |
Ein Nutzer hat ein Aufschlüsselungsdialogfeld über eine Dashboard-Tile geöffnet und auf die Option Herunterladen geklickt. |
drillmodal:explore |
Ein Nutzer hat in einem Aufschlüsselungsdialogfeld auf die Option Von hier aus explorativ analysieren geklickt. |
explore:ready |
Ein Explore hat mit dem Laden von Abfragedaten begonnen, unabhängig davon, ob die Abfrage ausgeführt wird oder nicht. |
explore:run:start |
Ein Explore hat mit dem Laden von Abfragedaten begonnen und die Abfrage wird ausgeführt. |
explore:run:complete |
Ein Explore hat die Abfrage abgeschlossen. |
explore:state:changed |
Die URL einer Explore-Seite hat sich aufgrund der Aktionen des Benutzers geändert. |
merge:ready |
Eine Zusammenführungsabfrage hat das Laden der ersten Abfragedaten abgeschlossen. |
merge:run:start |
Eine Zusammenführungsabfrage wird ausgeführt. |
merge:run:complete |
Eine Zusammenführungsabfrage wurde abgeschlossen. |
merge:run:fail |
Eine Zusammenführungsabfrage konnte nicht ausgeführt werden und hat einen Fehler zurückgegeben. |
page:changed |
Ein Nutzer hat eine neue Seite im iFrame aufgerufen. |
page:properties:changed |
Die Höhe eines Dashboard-iFrames hat sich geändert. |
session:tokens |
Der Looker-Client benötigt Tokens, um fortzufahren. |
session:expired |
Hinzugefügt am 25.10. Die Sitzung des Nutzers ist abgelaufen. |
session:status |
Sendet Informationen zum Status einer Sitzung. |
env:client:dialog |
Es wurde ein Dialogfeld geöffnet, das möglicherweise teilweise nicht sichtbar ist, z. B. ein Aufschlüsselungsdialogfeld. Dieses Ereignis ermöglicht es der Hostanwendung, das Dialogfeld in die Ansicht zu scrollen. |
Referenz zu Ereignistypen
Der eingebettete iFrame kann viele verschiedene Arten von Ereignissen erstellen:
dashboard:loaded
Bei Dashboards, bei denen die Tiles nicht auf automatische Ausführung eingestellt sind, wird dieses Ereignis erstellt, nachdem ein Dashboard und seine Elemente geladen wurden, aber bevor Abfragen ausgeführt werden.
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 | Beschreibung |
|---|---|---|
status |
String | Gibt an, ob das Dashboard und seine Elemente erfolgreich geladen wurden. |
dashboard.id |
Zahl/String | Die ID des Dashboards. |
dashboard.title |
String | Der Titel, wie er oben im Dashboard angezeigt wird. |
dashboard.canEdit |
Boolesch |
In 22.20 hinzugefügt
Wenn true, kann der Nutzer das Dashboard bearbeiten. |
dashboard.dashboard_filters |
Objekt | Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}. |
dashboard.absoluteUrl |
String | Die vollständige Dashboard-URL. |
dashboard.url |
String | Die relative Dashboard-URL (nur der Pfad). |
dashboard.options |
Objekt | Die Eigenschaften und Werte für Dashboard-Layout, Dashboard-Layoutkomponente und Dashboard-Element. Alle im options-Objekt zurückgegebenen Properties können mit dem Ereignis dashboard:options:set aktualisiert werden. |
dashboard:run:start
Dieses Ereignis wird erstellt, wenn ein Dashboard geladen wird und die zugehörigen Tiles geladen und Daten abgefragt werden.
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 | Beschreibung |
|---|---|---|
dashboard.id |
Zahl/String | Die ID des Dashboards. |
dashboard.title |
String | Der Titel, wie er oben im Dashboard angezeigt wird. |
dashboard.canEdit |
Boolesch |
In 22.20 hinzugefügt
Wenn true, kann der Nutzer das Dashboard bearbeiten. |
dashboard.url |
String | Die relative Dashboard-URL (nur der Pfad). |
dashboard.absoluteUrl |
String | Die vollständige Dashboard-URL. |
dashboard.dashboard_filters |
Objekt | Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}. |
dashboard:run:complete
Dieses Ereignis wird erstellt, wenn ein Dashboard ausgeführt wurde und alle Tiles geladen und abgefragt wurden. Dieses Ereignis wird erstellt, unabhängig davon, ob alle Kacheln erfolgreich geladen wurden oder nicht.
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 | Beschreibung |
|---|---|---|
status |
String | Gibt an, ob das Dashboard und seine Elemente erfolgreich ausgeführt wurden. Wenn das Dashboard und seine Elemente erfolgreich ausgeführt wurden, gibt status "complete" zurück. Andernfalls gibt status "error" zurück. Wenn das laufende Dashboard entweder über die Benutzeroberfläche oder mit der Aktion dashboard:stop beendet wurde, gibt status den Wert "stopped" zurück. |
dashboard.id |
Zahl/String | Die ID des Dashboards. |
dashboard.title |
String | Der Titel, wie er oben im Dashboard angezeigt wird. |
dashboard.canEdit |
Boolesch |
In 22.20 hinzugefügt
Wenn true, kann der Nutzer das Dashboard bearbeiten. |
dashboard.url |
String | Die relative Dashboard-URL (nur der Pfad). |
dashboard.absoluteUrl |
String | Die vollständige Dashboard-URL. |
dashboard.dashboard_filters |
Objekt | Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}. |
dashboard.options |
Objekt | Die Eigenschaften und Werte für Dashboard-Layout, Dashboard-Layoutkomponente und Dashboard-Element. Alle im options-Objekt zurückgegebenen Properties können mit der Aktion dashboard:options:set aktualisiert werden. |
dashboard.tileStatuses |
Objekt-Array | Ein Array von Objekten, die Kachelstatus angeben. Objekteigenschaften sind:
|
dashboard:download
Dieses Ereignis wird erstellt, wenn der Download einer PDF-Datei eines Dashboards gestartet wurde.
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 | Beschreibung |
|---|---|---|
dashboard.id |
Zahl/String | Die ID des Dashboards. |
dashboard.title |
String | Der Titel, wie er oben im Dashboard angezeigt wird. |
dashboard.canEdit |
Boolesch |
In 22.20 hinzugefügt
Wenn true, kann der Nutzer das Dashboard bearbeiten. |
dashboard.url |
String | Die relative Dashboard-URL (nur der Pfad). |
dashboard.absoluteUrl |
String | Die vollständige Dashboard-URL. |
dashboard.dashboard_filters |
Objekt | Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}. |
fileFormat |
String | Das Format des heruntergeladenen Dashboards (derzeit nur "pdf"). |
dashboard:edit:start
Hinzugefügt am 22.20 Dieses Ereignis wird erstellt, wenn ein Dashboard in den Bearbeitungsmodus wechselt.
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 | Beschreibung |
|---|---|---|
dashboard.id |
Zahl/String | Die ID des Dashboards. |
dashboard.title |
String | Der Titel, wie er oben im Dashboard angezeigt wird. |
dashboard.canEdit |
Boolesch |
In 22.20 hinzugefügt
Wenn true, kann der Nutzer das Dashboard bearbeiten. |
dashboard.url |
String | Die relative Dashboard-URL (nur der Pfad). |
dashboard.absoluteUrl |
String | Die vollständige Dashboard-URL. |
dashboard.dashboard_filters |
Objekt | Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}. |
dashboard:edit:cancel
Hinzugefügt in 22.20 Dieses Ereignis wird erstellt, wenn ein Dashboard, das sich im Bearbeitungsmodus befindet, ohne Speichern verlassen wird.
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 | Beschreibung |
|---|---|---|
dashboard.id |
Zahl/String | Die ID des Dashboards. |
dashboard.title |
String | Der Titel, wie er oben im Dashboard angezeigt wird. |
dashboard.canEdit |
Boolesch |
In 22.20 hinzugefügt
Wenn true, kann der Nutzer das Dashboard bearbeiten. |
dashboard.url |
String | Die relative Dashboard-URL (nur der Pfad). |
dashboard.absoluteUrl |
String | Die vollständige Dashboard-URL. |
dashboard.dashboard_filters |
Objekt | Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}. |
dashboard:save:complete
Dieses Ereignis wird erstellt, wenn ein Dashboard bearbeitet und dann gespeichert wird.
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 | Beschreibung |
|---|---|---|
dashboard.id |
Zahl/String | Die ID des Dashboards. |
dashboard.title |
String | Der Titel, wie er oben im Dashboard angezeigt wird. |
dashboard.canEdit |
Boolesch |
In 22.20 hinzugefügt
Wenn true, kann der Nutzer das Dashboard bearbeiten. |
dashboard.dashboard_filters |
Objekt | Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}. |
dashboard.absoluteUrl |
String | Die vollständige Dashboard-URL. |
dashboard.url |
String | Die relative Dashboard-URL (nur der Pfad). |
dashboard.options |
Objekt | Die Eigenschaften und Werte für Dashboard-Layout, Dashboard-Layoutkomponente und Dashboard-Element. Alle im options-Objekt zurückgegebenen Properties können mit dem dashboard:options:set-Ereignis aktualisiert werden. |
dashboard:delete:complete
Dieses Ereignis wird erstellt, wenn ein Dashboard gelöscht wird.
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 | Beschreibung |
|---|---|---|
dashboard.id |
Zahl/String | Die ID des Dashboards. |
dashboard.title |
String | Der Titel, wie er oben im Dashboard angezeigt wird. |
dashboard.canEdit |
Boolesch |
In 22.20 hinzugefügt
Wenn true, kann der Nutzer das Dashboard bearbeiten. |
dashboard.dashboard_filters |
Objekt | Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}. |
dashboard.absoluteUrl |
String | Die vollständige Dashboard-URL. |
dashboard.url |
String | Die relative Dashboard-URL (nur der Pfad). |
dashboard.options |
Objekt | Die Eigenschaften und Werte für Dashboard-Layout, Dashboard-Layoutkomponente und Dashboard-Element. Alle im options-Objekt zurückgegebenen Properties können mit dem Ereignis dashboard:options:set aktualisiert werden. |
dashboard:tile:start
Dieses Ereignis wird erstellt, wenn eine Tile mit dem Laden oder Abfragen von Daten beginnt.
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 | Beschreibung |
|---|---|---|
dashboard.id |
Zahl/String | Die ID des Dashboards, zu dem die Tile gehört. |
dashboard.title |
String | Der Dashboard-Titel, wie er oben im Dashboard angezeigt wird, zu dem die Tile gehört. |
dashboard.canEdit |
Boolesch |
In 22.20 hinzugefügt
Wenn true, kann der Nutzer das Dashboard bearbeiten. |
dashboard.url |
String | Die relative Dashboard-URL (nur der Pfad), zu der die Kachel gehört. |
dashboard.absoluteUrl |
String | Die vollständige Dashboard-URL, zu der die Tile gehört. |
dashboard.dashboard_filters |
Objekt | Die Filter, die auf das Dashboard angewendet werden, zu dem die Tile gehört. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}. |
tile.id |
Ganzzahl | Die ID-Nummer des Ereignisses, nicht der Kachel. |
tile.title |
String | Der Titel der Tile, wie er oben in der Tile angezeigt wird. |
tile.listen |
Objekt | Die globalen Dashboard-Filter, auf die diese Tile reagiert. Dieses Objekt hat das Format {"Filter Label": "Filter Field", ...}. |
dashboard:tile:complete
Dieses Ereignis wird erstellt, wenn die Abfrage für eine Tile abgeschlossen ist.
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 | Beschreibung |
|---|---|---|
dashboard.id |
Zahl/String | Die ID des Dashboards, zu dem die Tile gehört. |
dashboard.title |
String | Der Dashboard-Titel, wie er oben im Dashboard angezeigt wird, zu dem die Tile gehört. |
dashboard.canEdit |
Boolesch |
In 22.20 hinzugefügt
Wenn true, kann der Nutzer das Dashboard bearbeiten. |
dashboard.url |
String | Die relative Dashboard-URL (nur der Pfad), zu der die Kachel gehört. |
dashboard.absoluteUrl |
String | Die vollständige Dashboard-URL, zu der die Tile gehört. |
dashboard.dashboard_filters |
Objekt | Die Filter, die auf das Dashboard angewendet werden, zu dem die Tile gehört. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}. |
status |
String | Gibt an, ob die Kachelabfrage erfolgreich abgeschlossen wurde. Mögliche Werte sind "complete" und "error". |
truncated |
Boolesch | Gibt an, ob die Ergebnisse der Tile-Abfrage abgeschnitten wurden, weil die Abfrage mehr Zeilen zurückgegeben hat, als das Zeilenlimit der Abfrage zulässt. Das Zeilenlimit kann ein vom Benutzer angegebenes Zeilenlimit oder das Looker-Standardzeilenlimit von 5.000 Zeilen sein. |
tile.id |
Ganzzahl | Die ID-Nummer des Ereignisses, nicht der Kachel. |
tile.title |
String | Der Titel der Tile, wie er oben in der Tile angezeigt wird. |
tile.listen |
Objekt | Die globalen Dashboard-Filter, auf die diese Tile reagiert. Dieses Objekt hat das Format {"Filter Label": "Filter Field", ...}. |
tile.errors |
Objekt-Array | Wird ausgefüllt, wenn die Property status den Wert "error" hat. Ein Array von Objekten mit Details zum Fehler, einschließlich des Fehlermeldungstexts, einer detaillierteren Beschreibung des Fehlers und der SQL-Abfrage der Tile, die den Fehler verursacht hat. |
dashboard:tile:download
Dieses Ereignis wird erstellt, wenn der Download der Daten einer Kachel gestartet wurde.
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 | Beschreibung |
|---|---|---|
dashboard.id |
Zahl/String | Die ID des Dashboards, zu dem die Tile gehört. |
dashboard.title |
String | Der Dashboard-Titel, wie er oben im Dashboard angezeigt wird, zu dem die Tile gehört. |
dashboard.canEdit |
Boolesch |
In 22.20 hinzugefügt
Wenn true, kann der Nutzer das Dashboard bearbeiten. |
dashboard.url |
String | Die relative Dashboard-URL (nur der Pfad), zu der die Kachel gehört. |
dashboard.absoluteUrl |
String | Die vollständige Dashboard-URL, zu der die Tile gehört. |
dashboard.dashboard_filters |
Objekt | Die Filter, die auf das Dashboard angewendet werden, zu dem die Tile gehört. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}. |
tile.id |
Ganzzahl | Die ID-Nummer des Ereignisses, nicht der Kachel. |
tile.title |
String | Der Titel der Tile, wie er oben in der Tile angezeigt wird. |
tile.listen |
Objekt | Die globalen Dashboard-Filter, auf die diese Tile reagiert. Dieses Objekt hat das Format {"Filter Label": "Filter Field", ...}. |
fileFormat |
String | Das Format der heruntergeladenen Kachel (derzeit nur "pdf"). |
dashboard:tile:explore
Dieses Ereignis wird erstellt, wenn ein Nutzer auf einer Dashboard-Tile auf die Option Von hier aus explorieren klickt.
Dieses Ereignis kann abgebrochen werden. Das bedeutet, dass die einbettende Anwendung {cancel: true} zurückgeben kann und Looker das auslösende Ereignis nicht fortsetzt.
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 | Beschreibung |
|---|---|---|
label |
String | Das Button-Label. |
url |
String | Die relative URL (nur der Pfad) des anzusehenden Explores. |
dashboard.id |
Zahl/String | Die ID des Dashboards, zu dem die Tile gehört. |
dashboard.title |
String | Der Dashboard-Titel, wie er oben im Dashboard angezeigt wird, zu dem die Tile gehört. |
dashboard.canEdit |
Boolesch |
In 22.20 hinzugefügt
Wenn true, kann der Nutzer das Dashboard bearbeiten. |
dashboard.url |
String | Die relative Dashboard-URL (nur der Pfad), zu der die Kachel gehört. |
dashboard.absoluteUrl |
String | Die vollständige Dashboard-URL, zu der die Tile gehört. |
dashboard.dashboard_filters |
Objekt | Die Filter, die auf das Dashboard angewendet werden, zu dem die Tile gehört. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}. |
tile.id |
Ganzzahl | Die ID-Nummer des Ereignisses, nicht der Kachel. |
tile.title |
String | Der Titel der Tile, wie er oben in der Tile angezeigt wird. |
tile.listen |
Objekt | Die globalen Dashboard-Filter, auf die diese Tile reagiert. Dieses Objekt hat das Format {"Filter Label": "Filter Field", ...}. |
dashboard:tile:view
Dieses Ereignis wird erstellt, wenn ein Nutzer in einer Dashboard-Tile auf die Option Original-Look ansehen klickt.
Dieses Ereignis kann abgebrochen werden. Das bedeutet, dass die einbettende Anwendung {cancel: true} zurückgeben kann und Looker das auslösende Ereignis nicht fortsetzt.
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 | Beschreibung |
|---|---|---|
label |
String | Das Button-Label. |
url |
String | Die relative URL (nur der Pfad) des anzuzeigenden Looks. |
dashboard.id |
Zahl/String | Die ID des Dashboards, zu dem die Tile gehört. |
dashboard.title |
String | Der Dashboard-Titel, wie er oben im Dashboard angezeigt wird, zu dem die Tile gehört. |
dashboard.canEdit |
Boolesch |
In 22.20 hinzugefügt
Wenn true, kann der Nutzer das Dashboard bearbeiten. |
dashboard.url |
String | Die relative Dashboard-URL (nur der Pfad), zu der die Kachel gehört. |
dashboard.absoluteUrl |
String | Die vollständige Dashboard-URL, zu der die Tile gehört. |
dashboard.dashboard_filters |
Objekt | Die Filter, die auf das Dashboard angewendet werden, zu dem die Tile gehört. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}. |
tile.id |
Ganzzahl | Die ID-Nummer des Ereignisses, nicht der Kachel. |
tile.title |
String | Der Titel der Tile, wie er oben in der Tile angezeigt wird. |
tile.listen |
Objekt | Die globalen Dashboard-Filter, auf die diese Tile reagiert. Dieses Objekt hat das Format {"Filter Label": "Filter Field", ...}. |
dashboard:tile:merge
Hinzugefügt in Version 25.14 Dieses Ereignis wird generiert, wenn der Nutzer auf den Button Zusammengeführte Abfrage bearbeiten oder den Menüpunkt Zusammengeführte Abfrage bearbeiten klickt. Standardmäßig wird über diese Schaltfläche ein neues Fenster auf oberster Ebene geöffnet, in dem die Zusammenführungsabfrage bearbeitet werden kann.
Dieses Ereignis kann abgebrochen werden. Das bedeutet, dass die einbettende Anwendung {cancel: true} zurückgeben kann und Looker das auslösende Ereignis nicht fortsetzt. Mit diesem Ereignis kann die einbettende Anwendung die Bearbeitung der Zusammenführungsabfrage in einem iFrame statt in einem Fenster der obersten Ebene öffnen. Die einbettende Anwendung sollte nicht versuchen, die URL in dem iFrame zu laden, der das Ereignis ausgelöst hat. Stattdessen sollte ein neuer iFrame erstellt werden.
javascript
type: dashboard:tile:merge,
label: 'Edit Merged Query',
dashboard_id: '13',
dashboard_modified: false,
tile_id: '218',
tile_title: 'Untitled',
url: '/embed/merge/edit?did=218&dbnx=1',
absoluteUrl: 'https://.../embed/merge/edit?did=218&dbnx=1',
target: '_blank',
| Attribut | Format | Beschreibung |
|---|---|---|
label |
String | Das Button-Label. |
dashboard_id |
String | Die ID des Dashboards, zu dem die Tile mit der zusammengeführten Abfrage gehört. |
dashboard_modified |
boolean | Wenn true, gibt dieses Attribut an, dass das Dashboard geändert wurde. Aktualisierungen des Dashboards können verloren gehen, wenn die Bearbeitung der Zusammenführungsabfrage fortgesetzt wird. Die einbettende Anwendung kann entweder die Bearbeitung der Zusammenführungsabfrage abbrechen oder den Nutzer warnen, dass er möglicherweise nicht gespeicherte Änderungen hat, wenn er fortfährt. |
tile_id |
String | Die ID der Kachel mit der zusammengeführten Abfrage. |
tile_title |
String | Der Titel der Tile. |
url |
String | Die URL der zusammengeführten Abfrage. Dieses Attribut kann mit dem Einbettungs-SDK verwendet werden, um einen neuen iFrame für die zusammengeführte Abfrage zu erstellen. |
absoluteUrl |
String | Die vollständige URL der zusammengeführten Abfrage. Dieses Attribut kann als src des iframe-Elements verwendet werden. Zusätzliche Attribute sind erforderlich. |
target |
String | Die ID, die für den Namen des zu öffnenden Fensters verwendet werden soll. |
dashboard:filters:changed
Dieses Ereignis wird erstellt, wenn die Filter eines Dashboards angewendet oder geändert wurden.
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 | Beschreibung |
|---|---|---|
dashboard.id |
Zahl/String | Die ID des Dashboards. |
dashboard.title |
String | Der Titel, wie er oben im Dashboard angezeigt wird. |
dashboard.canEdit |
Boolesch |
In 22.20 hinzugefügt
Wenn true, kann der Nutzer das Dashboard bearbeiten. |
dashboard.url |
String | Die relative Dashboard-URL (nur der Pfad). |
dashboard.absoluteUrl |
String | Die vollständige Dashboard-URL. |
dashboard.dashboard_filters |
Objekt | Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}. |
dashboard.options |
Objekt | Die Eigenschaften und Werte für Dashboard-Layout, Dashboard-Layoutkomponente und Dashboard-Element. Alle im options-Objekt zurückgegebenen Properties können mit dem Ereignis dashboard:options:set aktualisiert werden. |
look:ready
Dieses Ereignis wird erstellt, wenn ein Look mit dem Laden von Abfragedaten beginnt, unabhängig davon, ob die Abfrage ausgeführt wird oder nicht.
type: "look:ready",
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
}
| Attribut | Format | Beschreibung |
|---|---|---|
look.url |
String | Die relative Look-URL (nur der Pfad) |
look.absoluteUrl |
String | Die vollständige Look-URL |
look:run:start
Dieses Ereignis wird erstellt, wenn ein Look mit dem Laden von Abfragedaten beginnt und die Abfrage ausgeführt wird.
type: "look:run:start",
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
}
| Attribut | Format | Beschreibung |
|---|---|---|
look.url |
String | Die relative Look-URL (nur der Pfad) |
look.absoluteUrl |
String | Die vollständige Look-URL |
look:run:complete
Dieses Ereignis wird erstellt, wenn ein Look die Abfrage abgeschlossen hat.
type: look:run:complete
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
}
| Attribut | Format | Beschreibung |
|---|---|---|
look.url |
String | Die relative Look-URL (nur der Pfad) |
look.absoluteUrl |
String | Die vollständige Look-URL |
look:edit:start
Hinzugefügt am 25.10. Dieses Ereignis wird ausgelöst, wenn ein Look in den Bearbeitungsmodus wechselt.
type: "look:edit:start",
look: {
id: 46,
title: "My Look",
url: "/embed/looks/46",
absoluteUrl: "https://instance_name.looker.com/embed/looks/46",
}
| Attribut | Format | Beschreibung |
|---|---|---|
look.id |
String | Die ID des Looks. |
look.title |
String | Der Titel des Looks. |
url |
String | Die relative Look-URL (nur der Pfad). |
absoluteUrl |
String | Die vollständige Look-URL. |
look:edit:cancel
Hinzugefügt am 25.10. Dieses Ereignis wird ausgelöst, wenn ein Look, der sich im Bearbeitungsmodus befindet, ohne Speichern verlassen wird.
type: "look:edit:cancel",
look: {
id: 46,
title: "My Look",
url: "/embed/looks/46",
absoluteUrl: "https://instance_name.looker.com/embed/looks/46",
}
| Attribut | Format | Beschreibung |
|---|---|---|
look.id |
String | Die ID des Looks. |
look.title |
String | Der Titel des Looks. |
url |
String | Die relative Look-URL (nur der Pfad). |
absoluteUrl |
String | Die vollständige Look-URL. |
look:save:complete
Dieses Ereignis wird erstellt, wenn ein Look bearbeitet und gespeichert wird. Dieses Ereignis wird erstellt, wenn ein Nutzer eine der folgenden Aufgaben ausführt:
- Klickt auf die Schaltfläche Bearbeiten, um den Look zu bearbeiten, und dann auf Speichern.
- Speichert einen Look mit der Menüoption Speichern > Speichern unter…
- Verschiebt einen Look von einem Ordner in einen anderen
Dieses Ereignis wird nicht erstellt, wenn der Look mit der Menüoption Speichern > In vorhandenem Dashboard oder Einstellungen bearbeiten gespeichert wird.
type: look:save:complete
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
folderid: 123
}
| Attribut | Format | Beschreibung |
|---|---|---|
look.url |
String | Die relative Look-URL (nur der Pfad) |
look.absoluteUrl |
String | Die vollständige Look-URL |
look.folderid |
Ganzzahl | Die Ordner-ID, unter der der Look gespeichert ist |
look:delete:complete
Dieses Ereignis wird erstellt, wenn ein Look in den Papierkorb verschoben wird.
type: look:delete:complete
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
}
| Attribut | Format | Beschreibung |
|---|---|---|
look.url |
String | Die relative Look-URL (nur der Pfad) |
look.absoluteUrl |
String | Die vollständige Look-URL |
drillmenu:click
Dieses Ereignis wird erstellt, wenn ein Nutzer in einem Dashboard, das mit dem LookML-Parameter link erstellt wurde, auf ein Aufschlüsselungsmenü klickt. Mit dem folgenden LookML-Code wird beispielsweise ein Drilldown-Menü erstellt, in dem ein Nutzer Daten nach der Dimension state filtern kann:
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"
}
}
Wenn der Filter state auf Illinois festgelegt ist, gibt das Ereignis drillmenu:click Folgendes an den Host des iFrames zurück:
type: "drillmenu:click",
label: "Filter by Illinois",
link_type: "url",
modal: false,
target: '_self',
url: "#filter::state=Illinois"
context: ' '
Dieses Ereignis kann abgebrochen werden. Das bedeutet, dass die einbettende Anwendung {cancel: true} zurückgeben kann und Looker das auslösende Ereignis nicht fortsetzt.
| Attribut | Format | Beschreibung |
|---|---|---|
label |
String | Das Linklabel, wie es im Untersuchungsmenü angezeigt wird |
link_type |
String | Der Objekttyp am Linkziel |
modal |
Boolesch | Ob das Aufschlüsselungsdialogfeld anstelle der Browsernavigation verwendet wird |
target |
String | _self, wenn das Linkziel den aktuellen iFrame ersetzt, _blank, wenn das Linkziel in einem neuen Fenster geöffnet wird |
url |
String | Die URL des Linkziels |
context |
String | Internes Attribut, das von einigen Visualisierungstypen verwendet wird |
Wenn Sie den iFrame in einer Sandbox ausführen, wird verhindert, dass Klicks im Aufschlüsselungsmenü in einem neuen Fenster geöffnet werden. Verwenden Sie die folgenden Sandboxing-Werte im iFrame-Tag:
sandbox = "allow-same-origin allow-scripts"
drillmodal:download
Dieses Ereignis wird erstellt, wenn ein Nutzer ein Aufschlüsselungsdialogfeld über eine Dashboard-Tile öffnet und auf die Option Herunterladen klickt.
{
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 | Beschreibung |
|---|---|---|
dashboard.id |
Zahl/String | Die ID des Dashboards, zu dem die Tile gehört. |
dashboard.title |
String | Der Dashboard-Titel, wie er oben im Dashboard angezeigt wird, zu dem die Tile gehört. |
dashboard.url |
String | Die relative Dashboard-URL (nur der Pfad), zu der die Kachel gehört. |
dashboard.absoluteUrl |
String | Die vollständige Dashboard-URL, zu der die Tile gehört. |
dashboard.dashboard_filters |
Objekt | Die Filter, die auf das Dashboard angewendet werden, zu dem die Tile gehört. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}. |
drillExploreUrl |
String | Die relative Explore-URL (nur der Pfad), die heruntergeladen werden soll. |
fileFormat |
String | Das Dateiformat des Datendownloads. |
drillmodal:explore
Dieses Ereignis wird erstellt, wenn ein Nutzer in einem Aufschlüsselungsdialogfeld auf die Option Von hier aus erkunden klickt.
Dieses Ereignis kann abgebrochen werden. Das bedeutet, dass die einbettende Anwendung {cancel: true} zurückgeben kann und Looker das auslösende Ereignis nicht fortsetzt.
type: "drillmodal:explore",
label: "Explore From Here",
url: "/embed/explore/model/view..."
| Attribut | Format | Beschreibung |
|---|---|---|
label |
String | Die Schaltflächenbeschriftung, wie sie im Aufschlüsselungsmenü angezeigt wird |
url |
String | Die relative Explore-URL (nur der Pfad), die angezeigt werden soll |
explore:ready
Dieses Ereignis wird erstellt, wenn ein Explore mit dem Laden von Abfragedaten beginnt, unabhängig davon, ob die Abfrage ausgeführt wird oder nicht.
type: "explore:ready",
explore: {
url: "/embed/explore/...",
absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
}
| Attribut | Format | Beschreibung |
|---|---|---|
explore.url |
String | Die relative Explore-URL (nur der Pfad) |
explore.absoluteUrl |
String | Die vollständige Explore-URL |
explore:run:start
Dieses Ereignis wird erstellt, wenn ein Explore mit dem Laden von Abfragedaten beginnt und die Abfrage ausgeführt wird.
type: "explore:run:start",
explore: {
url: "/embed/explore/...",
absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
}
| Attribut | Format | Beschreibung |
|---|---|---|
explore.url |
String | Die relative Explore-URL (nur der Pfad) |
explore.absoluteUrl |
String | Die vollständige Explore-URL |
explore:run:complete
Dieses Ereignis wird erstellt, wenn ein Explore die Abfrage abgeschlossen hat.
type: "explore:run:complete",
explore: {
url: "/embed/explore/...",
absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
}
}
| Attribut | Format | Beschreibung |
|---|---|---|
explore.url |
String | Die relative Explore-URL (nur der Pfad) |
explore.absoluteUrl |
String | Die vollständige Explore-URL |
explore:state:changed
Dieses Ereignis wird erstellt, wenn sich die URL einer Explore-Seite aufgrund von Nutzeraktionen ändert.
type: "explore:state:changed",
explore: {
url: "/embed/explore/...",
absoluteUrl: "https://instance_name.looker.com/embed/explore/..."
}
| Attribut | Format | Beschreibung |
|---|---|---|
explore.url |
String | Die relative Explore-URL (nur der Pfad) |
explore.absoluteUrl |
String | Die vollständige Explore-URL |
merge:ready
Dieses Ereignis wird erstellt, wenn eine Zusammenführungsabfrage das Laden der ersten Abfragedaten abgeschlossen hat.
{
type: "merge:ready",
mergeQuery: {
id: "123",
client_id: "abc"
}
}
| Attribut | Format | Beschreibung |
|---|---|---|
mergeQuery.id |
String | Die ID der Zusammenführungsabfrage. |
mergeQuery.client_id |
String | Die Client-ID der Zusammenführungsabfrage. |
merge:run:start
Dieses Ereignis wird erstellt, wenn eine Zusammenführungsabfrage ausgeführt wird.
{
type: "merge:run:start",
mergeQuery: {
id: "123",
client_id: "abc"
}
}
| Attribut | Format | Beschreibung |
|---|---|---|
mergeQuery.id |
String | Die ID der Zusammenführungsabfrage. |
mergeQuery.client_id |
String | Die Client-ID der Zusammenführungsabfrage. |
merge:run:complete
Dieses Ereignis wird erstellt, wenn die Ausführung einer Zusammenführungsabfrage abgeschlossen ist.
{
type: "merge:run:complete",
mergeQuery: {
id: "123",
client_id: "abc"
}
}
| Attribut | Format | Beschreibung |
|---|---|---|
mergeQuery.id |
String | Die ID der Zusammenführungsabfrage. |
mergeQuery.client_id |
String | Die Client-ID der Zusammenführungsabfrage. |
merge:run:fail
Dieses Ereignis wird erstellt, wenn eine Zusammenführungsabfrage nicht ausgeführt werden kann und einen Fehler zurückgibt.
{
type: "merge:run:fail",
mergeQuery: {
id: "123",
client_id: "abc"
},
error: "Execution timeout"
}
| Attribut | Format | Beschreibung |
|---|---|---|
mergeQuery.id |
String | Die ID der Zusammenführungsabfrage. |
mergeQuery.client_id |
String | Die Client-ID der Zusammenführungsabfrage. |
error |
String | Die Fehlermeldung, die zurückgegeben wird, wenn die Zusammenführungsabfrage nicht ausgeführt werden kann. |
page:changed
Dieses Ereignis wird erstellt, wenn ein Nutzer im iFrame zu einer neuen Seite wechselt.
type: "page:changed",
page: {
type: "dashboard",
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/..."
}
| Attribut | Format | Beschreibung |
|---|---|---|
page.type |
String | Der Typ der Seite, die gerade aufgerufen wurde, z. B. "dashboard", "look" oder "explore" |
page.url |
String | Die relative URL (nur der Pfad) der Seite, die gerade aufgerufen wurde |
page.absoluteUrl |
String | Die vollständige URL der Seite, die gerade aufgerufen wurde |
page:properties:changed
Dieses Ereignis wird erstellt, wenn sich die Höhe eines Dashboard-iFrames ändert. Sie ist für Looks oder Explores nicht verfügbar, da diese Elemente ihre Höhe automatisch an die Größe des iFrames anpassen.
type: "page:properties:changed",
height: 1000
| Attribut | Format | Beschreibung |
|---|---|---|
height |
Ganzzahl | Die Höhe des Dashboard-iFrames in Pixeln |
session:tokens
Dieses Ereignis gibt an, dass der Looker-Client Tokens benötigt, um fortzufahren. Dieses Ereignis wird sofort nach dem Erstellen des iFrames und danach regelmäßig während der Sitzung erstellt.
{
"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 | Beschreibung |
|---|---|---|
authentication_token |
String | Authentifizierungstoken. Wird beim Erstellen des iFrames hinzugefügt. Nicht in einer Antwort auf eine Anfrage zum Generieren von Tokens enthalten oder wenn die Sitzung abgelaufen ist. |
authentication_token_ttl |
Zahl | Gültigkeitsdauer des Authentifizierungstokens in Sekunden. Wird beim Erstellen des iFrames hinzugefügt. Nicht in einer Antwort auf eine Anfrage zum Generieren von Tokens enthalten oder wenn die Sitzung abgelaufen ist. |
api_token |
String | API-Token. Nicht enthalten, wenn die Sitzung abgelaufen ist. |
api_token_ttl |
Zahl | Gültigkeitsdauer des API-Tokens in Sekunden. Nicht enthalten, wenn die Sitzung abgelaufen ist. |
navigation_token |
String | Navigationstoken. Nicht enthalten, wenn die Sitzung abgelaufen ist. |
navigation_token_ttl |
Zahl | Gültigkeitsdauer des Navigations-Tokens in Sekunden. Nicht enthalten, wenn die Sitzung abgelaufen ist. |
session_references_token_ttl |
Zahl | Gültigkeitsdauer der Sitzung in Sekunden. Der Wert ist 0, wenn die Sitzung abgelaufen ist. Zur Wiederherstellung muss die einbettende Anwendung eine neue Sitzung abrufen. |
session:expired
Hinzugefügt am 25.10. Dieses Ereignis wird ausgelöst, wenn die Sitzung des eingebetteten Nutzers abläuft.
type: "session:expired",
Dieses Ereignis hat keine Nutzlast.
session:status
Das Ereignis wird generiert, wenn die eingebettete Looker-Anwendung Anfragen für Sitzungstokens verarbeitet.
{
"type": "session:status",
"session_ttl": 0,
"expired": true,
"interrupted": false
}
| Attribut | Format | Beschreibung |
|---|---|---|
session_ttl |
Zahl | Gültigkeitsdauer der Sitzung in Sekunden. |
expired |
Boolesch | Wenn true, ist die Sitzung abgelaufen. |
interrupted |
Boolesch | Wenn true, gibt an, dass eine Anfrage für Sitzungstokens nicht beantwortet wurde. Das kann darauf hindeuten, dass ein Server vorübergehend nicht verfügbar ist. |
recoverable |
Boolesch | Wird nur ausgefüllt, wenn „interrupted“ true ist. Gibt an, ob die Sitzung wiederhergestellt werden kann oder nicht. Der Wert false bedeutet wahrscheinlich, dass ein Problem mit der einbettenden Anwendung vorliegt. |
env:client:dialog
Das Ereignis wird generiert, wenn ein Dialogfeld geöffnet wurde, das möglicherweise teilweise nicht sichtbar ist, z. B. ein Aufschlüsselungsdialogfeld. Mit diesem Ereignis kann die gehostete Anwendung das Dialogfeld mit der Aktion env:host:scroll in die Ansicht scrollen.
{
type: "env:client:dialog",
dialogType: 'drilling',
placement: 'cover',
open: true
}
| Attribut | Format | Beschreibung |
|---|---|---|
type |
String | env:client:dialog gibt an, dass ein Dialogfeld geöffnet oder geschlossen wurde. Derzeit wird nur das Aufschlüsselungsdialogfeld unterstützt, in Zukunft können jedoch weitere Dialogfelder hinzugefügt werden. Es kann sein, dass der obere Teil des Aufschlüsselungsdialogs nicht sichtbar ist, da der Dialog den iFrame-Darstellungsbereich verdeckt. Mit diesem Ereignis kann die Hostanwendung den oberen Bereich des Dialogfelds in die Ansicht scrollen. |
dialogType |
String | Der Typ des Dialogfelds. Dieses Ereignis wird nur ausgelöst, wenn der Dialogtyp „Aufschlüsselung“ geöffnet oder geschlossen wird. |
placement |
String | Die Platzierung des Dialogfelds. Dialogfelder vom Typ „drilling“ verwenden immer den placement-Wert „cover“. |
open |
Boolesch | Gibt an, ob das Dialogfeld geöffnet oder gescrollt wird. |
Änderungen am iFrame vornehmen
Nachdem Sie den iFrame für den Datenabruf vorbereitet haben, können Sie ihn mit den folgenden Schritten ändern:
Anfrage im JSON-Format schreiben
Sie können mehrere Änderungen am iFrame vornehmen, die Sie im JSON-Format einreichen. Die verfügbaren Optionen werden auf dieser Seite im Abschnitt Aktionsreferenz beschrieben. Vergessen Sie nicht, JSON.stringify zu verwenden, um Ihre Aktion in JSON umzuwandeln, z. B. so:
var my_request = JSON.stringify(
{
type: "dashboard:run"
}
);
Anfrage an das Attribut contentWindow des iFrames senden
Posten Sie die Nachricht schließlich im contentWindow des iFrames:
var my_iframe = document.getElementById("my_iframe_id");
my_iframe.contentWindow.postMessage(my_request, 'https://instance_name.looker.com');
Tabelle mit Aktionsübersicht
In der folgenden Tabelle sind die Aktionen zusammengefasst. Wählen Sie eine Aktion aus, um die Details dazu aufzurufen.
| Aktion | Aktionsbeschreibung |
|---|---|
page:load |
Lädt eine neue Seite im iFrame und ersetzt die vorhandene Seite. |
dashboard:load |
Lädt ein neues Dashboard im iFrame und ersetzt ein vorhandenes Dashboard. |
dashboard:run |
Führt das Dashboard im iFrame aus. |
dashboard:edit |
In 22.20 hinzugefügt Schaltet das Dashboard in den Bearbeitungsmodus um. |
dashboard:filters:update |
Aktualisiert einen vorhandenen Dashboard-Filter im iFrame. |
dashboard:options:set |
Schreibt neue Werte in die Eigenschaften des Dashboard-Layouts und der Dashboard-Elemente. |
dashboard:schedule_modal:open |
Öffnet den Planer, mit dem Nutzer Looker-Inhalte an verschiedene Ziele senden können. |
dashboard:stop |
Beendet ein Dashboard, das ausgeführt wird oder Daten neu lädt. |
look:run |
Führt den Look im iFrame aus. |
look:filters:update |
Aktualisiert einen vorhandenen Look-Filter im iFrame. |
explore:run |
Führt den Explore im iFrame aus. |
explore:filters:update |
Aktualisiert oder entfernt einen vorhandenen Explore-Filter im iFrame. |
merge:run |
Führt die Zusammenführungsabfrage im iFrame aus. |
session:tokens:request |
Sendet Tokens als Antwort auf ein session:tokens:request-Ereignis. |
env:host:scroll |
Sendet Informationen zur aktuellen Scrollposition des Host-iFrames an die eingebettete Looker-Anwendung. |
Aktionsreferenz
Folgende Aktionen können Sie im eingebetteten iFrame posten:
page:load
Mit dieser Aktion können Sie zu neuen Inhalten im iFrame wechseln und die vorhandenen Inhalte ersetzen. Diese Aktion ähnelt der Aktion dashboard:load, ist aber flexibler, da in der URL zusätzliche Parameter angegeben werden können.
Es gibt Unterschiede im Verhalten, die vor der Verwendung von page:load berücksichtigt werden sollten. dashboard:load verhindert die Navigation, wenn das aktuelle Dashboard gerade bearbeitet wird. page:load verhindert die Navigation nicht. Die gehostete Anwendung kann feststellen, ob ein Dashboard oder Look bearbeitet wird, indem sie dashboard:edit:start, look:edit:start und die entsprechenden Ereignisse zum Beenden der Bearbeitung verfolgt. Aus diesem Grund empfehlen wir die Verwendung des Einbettungs-SDK. Das Einbettungs-SDK verfolgt, ob ein Dashboard oder Look bearbeitet wird. Daher kann die Verbindung abgefragt werden, um zu sehen, ob Inhalte vor der Navigation bearbeitet werden.
{
type: 'page:load',
url: '/embed/dashboard/32?state=california,
pushHistory: false
}
| Attribut | Format | Beschreibung |
|---|---|---|
type |
String | Mit dem Typ page:load geben Sie an, dass Sie neue Inhalte in den iFrame laden möchten. |
url |
String | Die URL des zu ladenden Inhalts. |
pushHistory |
Boolesch | Wenn true, wird für den geladenen Inhalt ein neuer Eintrag im Browserverlauf erstellt und der Nutzer kann über den Button „Zurück“ des Browsers zum vorherigen Inhalt zurückkehren. Wenn false, wird der aktuelle Inhalt ersetzt und es ist nicht möglich, über die Browsernavigation dorthin zurückzukehren. |
dashboard:load
Mit dieser Aktion können Sie ein neues Dashboard im iFrame laden und ein vorhandenes Dashboard ersetzen. Das neue Dashboard führt Abfragen so aus, als wäre eine neue Dashboard-Seite geöffnet worden.
{
type: "dashboard:load",
id: "101",
pushHistory: false
}
| Attribut | Format | Beschreibung |
|---|---|---|
type |
String | Der Typ dashboard:load gibt an, dass Sie ein neues Dashboard in den iFrame laden möchten. |
id |
String | Die ID des zu ladenden Dashboards. |
pushHistory |
Boolesch | Wenn true, wird für das geladene Dashboard ein neuer Eintrag im Browserverlauf erstellt und der Nutzer kann über den Button „Zurück“ des Browsers zum vorherigen Dashboard zurückkehren. Wenn false, wird das aktuelle Dashboard ersetzt und Sie können nicht über die Browsernavigation dorthin zurückkehren. |
dashboard:run
Verwenden Sie diese Aktion, um das Dashboard im iFrame auszuführen. Dies entspricht dem Klicken auf die Schaltfläche Ausführen oder Daten neu laden im Dashboard.
{
type: "dashboard:run"
}
| Attribut | Format | Beschreibung |
|---|---|---|
type |
String | Der Typ dashboard:run gibt an, dass Sie das Dashboard ausführen möchten. |
dashboard:edit
In 22.20 hinzugefügt Mit dieser Aktion können Sie ein vorhandenes Dashboard im iFrame in den Bearbeitungsmodus versetzen. Dies entspricht der Auswahl von Dashboard bearbeiten im Dashboard-Menü.
{
type: "dashboard:edit"
}
| Attribut | Format | Beschreibung |
|---|---|---|
type |
String | Mit dem Typ dashboard:edit geben Sie an, dass Sie das Dashboard in den Bearbeitungsmodus versetzen möchten. |
dashboard:filters:update
Mit dieser Aktion können Sie einen vorhandenen Dashboard-Filter im iFrame aktualisieren. Mit dieser Methode können Sie dem Dashboard keinen neuen Filter hinzufügen.
{
type: "dashboard:filters:update",
filters: {
"Sale date": "Last 28 days",
"Sale amount": "Greater than 100"
}
}
| Attribut | Format | Beschreibung |
|---|---|---|
type |
String | Der Typ dashboard:filters:update gibt an, dass Sie die vom Dashboard verwendeten Filter aktualisieren möchten. |
filters |
Objekt | Die neuen Filter, die Sie auf das Dashboard anwenden möchten. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}. |
dashboard:options:set
Diese Aktion ist verfügbar, nachdem das Ereignis dashboard:run:complete aufgetreten ist.
Der Einbettende erstellt die Nachricht und sendet sie an den iFrame. Das Dashboard antwortet jedoch erst, wenn dashboard:run:complete eintritt. Mit der Aktion dashboard:options:set werden neue Werte in die Eigenschaften des Dashboard-Layouts und der Dashboard-Elemente geschrieben. Nur Properties, die im Attribut options des Ereignisses dashboard:run:complete zurückgegeben wurden, können mit dashboard:options:set aktualisiert werden. Alle festgelegten Properties, die zuvor nicht vom Attribut options des Ereignisses dashboard:run:complete zurückgegeben wurden, werden ignoriert.
{
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 | Beschreibung |
|---|---|---|
type |
String | Mit dem Typ dashboard:options:set geben Sie an, dass Sie neue Werte in die Eigenschaften des Dashboard-Layouts und der Dashboard-Elemente schreiben möchten. |
layouts |
Objekt | Die Eigenschaften des Dashboard-Layouts, die vom Attribut options im Ereignis dashboard:run:complete zurückgegeben werden. Diese haben ein Format ähnlich dem folgenden:
|
layouts.dashboard_layout_components |
Objekt | Ein oder mehrere Dashboard-Layoutkomponentenobjekte, die vom Attribut options im Ereignis dashboard:run:complete zurückgegeben werden. Diese haben ein Format ähnlich dem folgenden:
|
elements |
Objekt | Ein oder mehrere Dashboard-Elementobjekte, die vom Attribut options im Ereignis dashboard:run:complete zurückgegeben werden. Diese haben ein Format ähnlich dem folgenden:id: { title: "string", title_hidden: boolean, vis_config: { type: "string", title: "string" }} |
dashboard:schedule_modal:open
Mit dieser Aktion wird der Planer geöffnet, über den Nutzer Looker-Inhalte an verschiedene Ziele senden können.
{
type: "dashboard:schedule_modal:open"
}
| Attribut | Format | Beschreibung |
|---|---|---|
type |
String | Mit dem Typ dashboard:schedule_modal:open geben Sie an, dass Sie das Dialogfeld Zeitplan öffnen möchten. |
dashboard:stop
Mit dieser Aktion können Sie ein Dashboard stoppen, das gerade ausgeführt wird oder Daten neu lädt. Dies entspricht dem Klicken auf den Button Abbrechen im Dashboard. Ein Dashboard, das mit dashboard:stop beendet wird, sendet ein dashboard:run:complete-Ereignis, wobei status: auf "stopped" gesetzt ist.
{
type: "dashboard:stop"
}
| Attribut | Format | Beschreibung |
|---|---|---|
type |
String | Mit dem Typ dashboard:stop geben Sie an, dass Sie das laufende Dashboard beenden möchten. |
look:run
Mit dieser Aktion können Sie die Abfrage, auf der der Look basiert, im iFrame ausführen. Diese Aktion ähnelt dem Klicken auf die Schaltfläche Ausführen im Look. Der Unterschied besteht darin, dass look:run die Datenbank immer direkt abfragt und keine Daten aus dem Looker-Cache abruft.
{
type: "look:run"
}
| Attribut | Format | Beschreibung |
|---|---|---|
type |
String | Mit dem Typ look:run geben Sie an, dass Sie den Look ausführen möchten. |
look:filters:update
Verwenden Sie diese Aktion, um einen vorhandenen Look-Filter im iFrame zu aktualisieren. Mit dieser Methode können Sie dem Look keinen neuen Filter hinzufügen.
{
type: "look:filters:update",
filters: {
"orders.created_at": "90 days",
"products.department": "sweaters"
}
}
| Attribut | Format | Beschreibung |
|---|---|---|
type |
String | Mit dem Typ look:filters:update geben Sie an, dass Sie die vom Look verwendeten Filter aktualisieren möchten. |
filters |
Objekt | Die neuen Filter, die Sie auf den Look anwenden möchten. Dieses Objekt hat das Format {"view_name.field_name_1": "value 1", "view_name.field_name_1": "value 2", ...}. |
explore:run
Verwenden Sie diese Aktion, um den Explore im iFrame auszuführen. Diese Aktion ähnelt dem Klicken auf den Button Ausführen im Explore, mit dem Unterschied, dass explore:run immer die Datenbank direkt abfragt und keine Daten aus dem Looker-Cache abruft.
{
type: "explore:run"
}
| Attribut | Format | Beschreibung |
|---|---|---|
type |
String | Der Typ explore:run gibt an, dass Sie den Explore ausführen möchten. |
explore:filters:update
Mit dieser Aktion können Sie einen vorhandenen Explore-Filter im iFrame aktualisieren oder entfernen. Wenn Sie einen neuen Filter hinzufügen, der auf ein gültiges Feld verweist, wird der neue Filter dem Explore hinzugefügt.
{
type: "explore:filters:update",
filters: {
"orders.created_at": "90 days",
"orders.status": "complete"
}
deleteFilters: ["products.department"]
}
| Attribut | Format | Beschreibung |
|---|---|---|
type |
String | Mit dem Typ explore:filters:update geben Sie an, dass Sie die vom Explore verwendeten Filter aktualisieren möchten. |
filters |
Objekt | Die neuen Filter, die Sie auf den Explore anwenden möchten. Wenn filters einen Filter enthält, der im Explore nicht vorhanden ist, aber auf ein gültiges Feld verweist, wird dieser Filter dem Explore hinzugefügt. Dieses Objekt hat das Format {"view_name.field_name_1": "value 1", "view_name.field_name_1": "value 2", ...}. |
deleteFilters |
Array | Die vorhandenen Filter, die Sie aus dem Explore entfernen möchten. Das Array hat das Format ["view_name.field_name_1", "view_name.field_name_2", ...]. |
merge:run
Mit dieser Aktion wird die Zusammenführungsabfrage im iFrame ausgeführt.
{
type: "merge:run"
}
| Attribut | Format | Beschreibung |
|---|---|---|
type |
String | Mit dem Typ merge:run geben Sie an, dass Sie die Zusammenführungsabfrage ausführen möchten. |
session:tokens:request
Verwenden Sie diese Aktion, um Tokens als Antwort auf eine session:tokens:request-Anfrage zu senden.
{
type: "session:tokens:request",
}
| Attribut | Format | Beschreibung |
|---|---|---|
type |
String | Der Typ session:tokens:request gibt an, dass Sie als Antwort auf ein session:tokens:request-Ereignis Tokens senden möchten. |
env:host:scroll
Mit dieser Aktion können Sie Informationen zur aktuellen Scrollposition des Host-iFrames an die eingebettete Looker-Anwendung senden.
{
type: "env:host:scroll",
offsetTop: 10,
offsetLeft: 10,
scrollX: 5,
scrollY: 5
}
| Attribut | Format | Beschreibung |
|---|---|---|
type |
String | Der Typ env:host:scroll gibt an, dass Sie Informationen zur aktuellen Scrollposition des Host-iFrames an die eingebettete Looker-Anwendung senden möchten. |
offsetTop |
Zahl | Der obere Versatz des iFrames. |
offsetLeft |
Zahl | Der Offset links vom iFrame. |
scrollX |
Zahl | Die scrollX-Position des Anwendungshosts. |
scrollY |
Zahl | Die scrollY-Position des Anwendungshosts. |