Nachdem du eine Einbettung erstellt hast, was öffentlich, privat mit signierter Einbettung oder über die API möglich ist, kannst du über JavaScript mit diesen iFrames interagieren. Je nach Status des eingebetteten Elements können Sie Ihre Seite dynamischer gestalten. Sie können sogar Änderungen am eingebetteten Element auf Ihrer Webseite vornehmen.
Beachten Sie, dass Looker nicht die Reihenfolge steuert, in der Browser Ereignisse an Webanwendungen senden. Das bedeutet, dass die Reihenfolge der Ereignisse für alle Browser und Plattformen nicht garantiert werden kann. Achten Sie darauf, dass Sie Ihren JavaScript-Code richtig schreiben, um die Ereignisverarbeitung verschiedener Browser zu berücksichtigen.
Sie können JavaScript auf eine der folgenden Arten für eingebettete Inhalte in Looker verwenden:
- Mit dem eingebetteten Software Development Kit (SDK) von Looker, wie auf der Dokumentationsseite zum Embed SDK beschrieben
- JavaScript-Ereignisse verwenden, wie im Abschnitt In JavaScript auf Ereignisse zugreifen auf dieser Seite beschrieben
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 Domain für die Einbettung dem iFrame-Attribut
src
hinzu. - Fügen Sie die eingebettete Domain der 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 Ihrem iFrame eine ID hinzu, falls Sie dies noch nicht getan haben. Im folgenden Beispiel setzen Sie die ID auf looker
, indem Sie id="looker"
in den iFrame einfügen:
<iframe id="looker" src="https://instance_name.looker.com/embed/dashboards/1"></iframe>
Einbettungsdomain dem 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 du signierte Einbettung verwendest, musst du der Einbettungs-URL die embed_domain
hinzufügen.
Wenn du das Embed SDK verwendest, füge sdk=2
am Ende der Einbettungs-URL hinzu. Der Parameter sdk=2
gibt an, dass das SDK vorhanden ist und dass Looker die zusätzlichen 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 der Zulassungsliste hinzufügen
Abschließend müssen Sie die Domain, in der der iFrame verwendet wird, auf der Seite Einbetten im Admin-Bereich von Looker auf die Zulassungsliste setzen. Gehen Sie dazu so vor:
Geben Sie im Feld Zulassungsliste für eingebettete Domains die Domain ein, in der der iFrame verwendet wird. 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. https://*.myownpersonaldomain.com
lässt beispielsweise sowohl https://analytics.myownpersonaldomain.com
als auch https://data.myownpersonaldomain.com
zu.
Wenn Sie eine Einbettung ohne Cookies mit Looker 23.8 oder höher verwenden, kann die Einbettungsdomain angegeben werden, wenn die Sitzung ohne Cookies abgerufen wird. Das ist eine Alternative, um die Domain eingebetteter Inhalte über den Bereich Verwaltung > Einbetten auf die Zulassungsliste zu setzen. Lesen Sie die Best Practices für die Sicherheit, wenn Sie diese Funktion nutzen möchten.
Daten aus dem iFrame werden abgerufen
Nachdem Sie die Vorbereitung abgeschlossen haben, können Sie auf die Ereignisse zugreifen, die zwischen dem Looker-iFrame und Ihrer Domain übergeben werden. Warten Sie dazu auf postMessage
-Ereignisse.
Mit dem eingebetteten iFrame lassen sich einige Ereignistypen erstellen, wie im Abschnitt Referenz zu Ereignistypen auf dieser Seite beschrieben.
Ereignisse in JavaScript aufrufen
Im Folgenden finden Sie ein Beispiel dafür, wie diese Ereignisse im nativen JavaScript überwacht und dann in der Konsole protokolliert werden:
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, wie Sie diese Ereignisse in jQuery überwachen und 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));
}
}
});
Tabelle mit Zusammenfassung der Ereignistypen
In der folgenden Tabelle sind die Ereignistypen zusammengefasst. Wählen Sie einen Ereignistyp aus, um die Details zu diesem Termin aufzurufen.
Ereignistyp | Ursache des Ereignisses |
---|---|
dashboard:loaded |
In Dashboards, in denen die Tiles nicht auf die automatische Ausführung eingestellt sind, wurden ein Dashboard und seine Elemente geladen, aber es werden noch keine Abfragen ausgeführt. |
dashboard:run:start |
Ein Dashboard hat mit dem Laden begonnen, und seine Tiles haben mit dem Laden und Abfragen von Daten begonnen. |
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 |
ADDED 22.20
Ein Dashboard wurde in den Bearbeitungsmodus gewechselt. Das dashboard:save:complete -Ereignis wird ausgelöst, wenn das Dashboard erfolgreich gespeichert wurde. |
dashboard:edit:cancel |
ADDED 22.20 Bei einem Dashboard, das sich im Bearbeitungsmodus befindet, wurde der Bearbeitungsmodus ohne Speichern beendet. |
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 Ausführung der Abfrage beendet. |
dashboard:tile:download |
Der Download der Daten einer Kachel wurde gestartet. |
dashboard:tile:explore |
Ein Nutzer hat in einer Dashboard-Kachel auf die Option Explore From Here geklickt. |
dashboard:tile:view |
Ein Nutzer hat in einer Dashboard-Tile auf die Option Ursprünglichen Look anzeigen geklickt. |
dashboard:filters:changed |
Die Filter eines Dashboards wurden angewendet oder geändert. |
look:ready |
Ein Look hat begonnen, Abfragedaten zu laden, unabhängig davon, ob die Abfrage ausgeführt wird oder nicht. |
look:run:start |
Ein Look hat begonnen, Abfragedaten zu laden, und die Abfrage hat begonnen, die Abfrage auszuführen. |
look:run:complete |
Ein Look hat die Ausführung der Abfrage 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 auf ein Aufschlüsselungsmenü in einem Dashboard geklickt, das mit dem LookML-Parameter link erstellt wurde. |
drillmodal:download |
Ein Nutzer hat über eine Dashboardkachel ein Dialogfeld zur Aufschlüsselung geöffnet und auf die Option Herunterladen geklickt. |
drillmodal:explore |
Ein Nutzer hat in einem Aufschlüsselungsdialogfeld auf die Option Explore From Here geklickt. |
explore:ready |
Ein Explore hat begonnen, Abfragedaten zu laden, unabhängig davon, ob die Abfrage ausgeführt wird oder nicht. |
explore:run:start |
Ein Explore hat begonnen, Abfragedaten zu laden, und die Abfrage hat begonnen, die Abfrage auszuführen. |
explore:run:complete |
Ein Explore hat die Ausführung der Abfrage abgeschlossen. |
explore:state:changed |
Die URL einer Explore-Seite hat sich aufgrund der Aktionen des Nutzers geändert. |
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:status |
Sendet Informationen zum Status einer Sitzung. |
env:client:dialog |
Ein Dialogfeld wurde geöffnet, das teilweise nicht zu sehen ist, z. B. ein Drilldown-Dialogfeld. Dieses Ereignis ermöglicht der Hosting-Anwendung, das Dialogfeld sichtbar zu machen. |
Ereignistypreferenz
Der eingebettete iFrame kann viele verschiedene Arten von Ereignissen erstellen:
dashboard:loaded
In Dashboards, in denen die Tiles nicht auf die 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/Zeichenfolge | Die ID des Dashboards. |
dashboard.title |
String | Der Titel, wie oben im Dashboard angezeigt. |
dashboard.canEdit |
Boolesch |
ADDED 22.20
Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten. |
dashboard.dashboard_filters |
Objekt | Die auf das Dashboard angewendeten Filter. Dieses Objekt hat folgendes 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 | Das Dashboard-Layout, die Komponente für das Dashboard-Layout und die Eigenschaften und Werte von Dashboard-Elementen. Alle im options -Objekt zurückgegebenen Eigenschaften können mit dem dashboard:options:set -Ereignis aktualisierte Werte erhalten. |
dashboard:run:start
Dieses Ereignis wird erstellt, wenn ein Dashboard mit dem Laden begonnen hat, wenn seine Tiles mit dem Laden und der Abfrage von Daten beginnen.
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/Zeichenfolge | Die ID des Dashboards. |
dashboard.title |
String | Der Titel, wie oben im Dashboard angezeigt. |
dashboard.canEdit |
Boolesch |
ADDED 22.20
Wenn true festgelegt ist, 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 folgendes 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 unabhängig davon erstellt, 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 den Wert "complete" zurück. Andernfalls gibt status den Wert "error" zurück. Wenn das ausgeführte Dashboard entweder über die Benutzeroberfläche oder mit der Aktion dashboard:stop beendet wurde, gibt status den Wert "stopped" zurück. |
dashboard.id |
Zahl/Zeichenfolge | Die ID des Dashboards. |
dashboard.title |
String | Der Titel, wie oben im Dashboard angezeigt. |
dashboard.canEdit |
Boolesch |
ADDED 22.20
Wenn true festgelegt ist, 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 folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard.options |
Objekt | Das Dashboard-Layout, die Komponente für das Dashboard-Layout und die Eigenschaften und Werte von Dashboard-Elementen. Alle im options -Objekt zurückgegebenen Eigenschaften können mit der Aktion dashboard:options:set aktualisierte Werte erhalten. |
dashboard.tileStatuses |
Objektarray | 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/Zeichenfolge | Die ID des Dashboards. |
dashboard.title |
String | Der Titel, wie oben im Dashboard angezeigt. |
dashboard.canEdit |
Boolesch |
ADDED 22.20
Wenn true festgelegt ist, 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 folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
fileFormat |
String | Das Format des heruntergeladenen Dashboards (derzeit nur "pdf" ). |
dashboard:edit:start
ADDED 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/Zeichenfolge | Die ID des Dashboards. |
dashboard.title |
String | Der Titel, wie oben im Dashboard angezeigt. |
dashboard.canEdit |
Boolesch |
ADDED 22.20
Wenn true festgelegt ist, 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 folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard:edit:cancel
ADDED 22.20 Dieses Ereignis wird erstellt, wenn ein Dashboard im Bearbeitungsmodus ohne Speichern den Bearbeitungsmodus beendet 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/Zeichenfolge | Die ID des Dashboards. |
dashboard.title |
String | Der Titel, wie oben im Dashboard angezeigt. |
dashboard.canEdit |
Boolesch |
ADDED 22.20
Wenn true festgelegt ist, 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 folgendes 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/Zeichenfolge | Die ID des Dashboards. |
dashboard.title |
String | Der Titel, wie oben im Dashboard angezeigt. |
dashboard.canEdit |
Boolesch |
ADDED 22.20
Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten. |
dashboard.dashboard_filters |
Objekt | Die auf das Dashboard angewendeten Filter. Dieses Objekt hat folgendes 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 | Das Dashboard-Layout, die Komponente für das Dashboard-Layout und die Eigenschaften und Werte von Dashboard-Elementen. Alle im options -Objekt zurückgegebenen Eigenschaften können mit dem dashboard:options:set -Ereignis aktualisierte Werte erhalten. |
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/Zeichenfolge | Die ID des Dashboards. |
dashboard.title |
String | Der Titel, wie oben im Dashboard angezeigt. |
dashboard.canEdit |
Boolesch |
ADDED 22.20
Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten. |
dashboard.dashboard_filters |
Objekt | Die auf das Dashboard angewendeten Filter. Dieses Objekt hat folgendes 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 | Das Dashboard-Layout, die Komponente für das Dashboard-Layout und die Eigenschaften und Werte von Dashboard-Elementen. Alle im options -Objekt zurückgegebenen Eigenschaften können mit dem dashboard:options:set -Ereignis aktualisierte Werte erhalten. |
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/Zeichenfolge | Die ID des Dashboards, zu dem die Tile gehört. |
dashboard.title |
String | Der Dashboard-Titel, wie er oben in dem Dashboard angezeigt wird, zu dem die Tile gehört. |
dashboard.canEdit |
Boolesch |
ADDED 22.20
Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten. |
dashboard.url |
String | Die relative Dashboard-URL (nur der Pfad), zu der die Tile 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 wurden, zu dem die Tile gehört. Dieses Objekt hat folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
tile.id |
Integer | Die ID-Nummer des Ereignisses, nicht die Kachel. |
tile.title |
String | Der Kacheltitel, wie er oben in der Tile angezeigt wird. |
tile.listen |
Objekt | Im globalen Dashboard werden Filter angewendet, die diese Kachel überwacht. Dieses Objekt hat folgendes Format: {"Filter Label": "Filter Field", ...} |
dashboard:tile:complete
Dieses Ereignis wird erstellt, wenn eine Tile die Ausführung der Abfrage abgeschlossen hat.
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/Zeichenfolge | Die ID des Dashboards, zu dem die Tile gehört. |
dashboard.title |
String | Der Dashboard-Titel, wie er oben in dem Dashboard angezeigt wird, zu dem die Tile gehört. |
dashboard.canEdit |
Boolesch |
ADDED 22.20
Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten. |
dashboard.url |
String | Die relative Dashboard-URL (nur der Pfad), zu der die Tile 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 wurden, zu dem die Tile gehört. Dieses Objekt hat folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
status |
String | Gibt an, ob die Tile-Abfrage erfolgreich abgeschlossen wurde. Mögliche Werte sind "complete" und "error" . |
truncated |
Boolesch | Gibt an, ob die Tile-Abfrageergebnisse abgeschnitten wurden, weil die Abfrage mehr Zeilen als das Zeilenlimit der Abfrage zurückgegeben hat. Das Zeilenlimit kann entweder ein benutzerdefiniertes Zeilenlimit oder das Looker-Standardzeilenlimit von 5.000 sein. |
tile.id |
Integer | Die ID-Nummer des Ereignisses, nicht die Kachel. |
tile.title |
String | Der Kacheltitel, wie er oben in der Tile angezeigt wird. |
tile.listen |
Objekt | Im globalen Dashboard werden Filter angewendet, die diese Kachel überwacht. Dieses Objekt hat folgendes Format: {"Filter Label": "Filter Field", ...} |
tile.errors |
Objektarray | Wird ausgefüllt, wenn das Attribut status den Wert "error" hat. Ein Array von Objekten, die Details zum Fehler angeben, einschließlich des Fehlermeldungstextes, einer detaillierteren Beschreibung des Fehlers und der SQL-Abfrage der Kachel, 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/Zeichenfolge | Die ID des Dashboards, zu dem die Tile gehört. |
dashboard.title |
String | Der Dashboard-Titel, wie er oben in dem Dashboard angezeigt wird, zu dem die Tile gehört. |
dashboard.canEdit |
Boolesch |
ADDED 22.20
Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten. |
dashboard.url |
String | Die relative Dashboard-URL (nur der Pfad), zu der die Tile 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 wurden, zu dem die Tile gehört. Dieses Objekt hat folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
tile.id |
Integer | Die ID-Nummer des Ereignisses, nicht die Kachel. |
tile.title |
String | Der Kacheltitel, wie er oben in der Tile angezeigt wird. |
tile.listen |
Objekt | Im globalen Dashboard werden Filter angewendet, die diese Kachel überwacht. Dieses Objekt hat folgendes 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 in einer Dashboard-Kachel auf die Option Explore From Here klickt.
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 | Die Beschriftung der Schaltfläche. |
url |
String | Die relative URL (nur der Pfad) des anzuzeigenden Explores. |
dashboard.id |
Zahl/Zeichenfolge | Die ID des Dashboards, zu dem die Tile gehört. |
dashboard.title |
String | Der Dashboard-Titel, wie er oben in dem Dashboard angezeigt wird, zu dem die Tile gehört. |
dashboard.canEdit |
Boolesch |
ADDED 22.20
Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten. |
dashboard.url |
String | Die relative Dashboard-URL (nur der Pfad), zu der die Tile 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 wurden, zu dem die Tile gehört. Dieses Objekt hat folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
tile.id |
Integer | Die ID-Nummer des Ereignisses, nicht die Kachel. |
tile.title |
String | Der Kacheltitel, wie er oben in der Tile angezeigt wird. |
tile.listen |
Objekt | Im globalen Dashboard werden Filter angewendet, die diese Kachel überwacht. Dieses Objekt hat folgendes Format: {"Filter Label": "Filter Field", ...} |
dashboard:tile:view
Dieses Ereignis wird erstellt, wenn ein Nutzer in einer Dashboard-Kachel auf die Option Ursprünglichen Look anzeigen klickt.
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 | Die Beschriftung der Schaltfläche. |
url |
String | Die relative URL (nur der Pfad) des anzuzeigenden Looks. |
dashboard.id |
Zahl/Zeichenfolge | Die ID des Dashboards, zu dem die Tile gehört. |
dashboard.title |
String | Der Dashboard-Titel, wie er oben in dem Dashboard angezeigt wird, zu dem die Tile gehört. |
dashboard.canEdit |
Boolesch |
ADDED 22.20
Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten. |
dashboard.url |
String | Die relative Dashboard-URL (nur der Pfad), zu der die Tile 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 wurden, zu dem die Tile gehört. Dieses Objekt hat folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
tile.id |
Integer | Die ID-Nummer des Ereignisses, nicht die Kachel. |
tile.title |
String | Der Kacheltitel, wie er oben in der Tile angezeigt wird. |
tile.listen |
Objekt | Im globalen Dashboard werden Filter angewendet, die diese Kachel überwacht. Dieses Objekt hat folgendes Format: {"Filter Label": "Filter Field", ...} |
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/Zeichenfolge | Die ID des Dashboards. |
dashboard.title |
String | Der Titel, wie oben im Dashboard angezeigt. |
dashboard.canEdit |
Boolesch |
ADDED 22.20
Wenn true festgelegt ist, 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 folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard.options |
Objekt | Das Dashboard-Layout, die Komponente für das Dashboard-Layout und die Eigenschaften und Werte von Dashboard-Elementen. Alle im options -Objekt zurückgegebenen Eigenschaften können mit dem dashboard:options:set -Ereignis aktualisierte Werte erhalten. |
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: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:
- Klicken Sie auf die Schaltfläche Bearbeiten, um den Look zu bearbeiten und anschließend auf Speichern.
- Speichert einen Look über die Menüoption Speichern > Speichern unter...
- Verschiebt einen Look von einem Ordner in einen anderen
Dieses Ereignis wird nicht erstellt, wenn der Look über die 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 |
Integer | Die ID des Ordners, in dem der Look gespeichert ist |
look:delete:complete
Dieses Ereignis wird erstellt, wenn ein Look in den Ordner 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 auf ein Aufschlüsselungsmenü in einem Dashboard klickt, das mit dem LookML-Parameter link
erstellt wurde. Mit dem folgenden LookML-Code wird beispielsweise ein Aufschlüsselungsmenü erstellt, in dem ein Nutzer nach der Dimension state
gefilterte Daten ansehen 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
gesetzt 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: ' '
Attribut | Format | Beschreibung |
---|---|---|
label |
String | Das Linklabel, wie es im Aufschlüsselungsmenü angezeigt wird |
link_type |
String | Der Objekttyp am Ziel des Links |
modal |
Boolesch | Legt fest, ob das Dialogfeld zur Aufschlüsselung anstelle der Browsernavigation verwendet wird |
target |
String | Ist _self , wenn das Linkziel den aktuellen iFrame ersetzt, und _blank , wenn durch das Linkziel ein neues Fenster geöffnet wird |
url |
String | Die URL des Linkziels |
context |
String | Internes Attribut, das von einigen Visualisierungstypen verwendet wird |
Durch Sandbox des iFrames werden Klicks auf Drilldown-Menüs nicht in einem neuen Fenster geöffnet. Verwenden Sie diese Sandbox-Werte innerhalb des iFrame-Tags:
sandbox = "allow-same-origin allow-scripts"
drillmodal:download
Dieses Ereignis wird erstellt, wenn ein Nutzer ein Aufschlüsselungsdialogfeld über eine Dashboardkachel ö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/Zeichenfolge | Die ID des Dashboards, zu dem die Tile gehört. |
dashboard.title |
String | Der Dashboard-Titel, wie er oben in dem Dashboard angezeigt wird, zu dem die Tile gehört. |
dashboard.url |
String | Die relative Dashboard-URL (nur der Pfad), zu der die Tile 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 wurden, zu dem die Tile gehört. Dieses Objekt hat folgendes 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 der heruntergeladenen Daten. |
drillmodal:explore
Dieses Ereignis wird erstellt, wenn ein Nutzer in einem Aufschlüsselungsdialogfeld auf die Option Von hier erkunden klickt.
type: "drillmodal:explore",
label: "Explore From Here",
url: "/embed/explore/model/view..."
Attribut | Format | Beschreibung |
---|---|---|
label |
String | Die Bezeichnung der Schaltfläche, 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 Ausführung der 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 infolge der Aktionen des Nutzers ä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 |
page:changed
Dieses Ereignis wird erstellt, wenn ein Nutzer zu einer neuen Seite innerhalb des iFrames navigiert.
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, zu der gerade navigiert 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 nicht für Looks oder Explores verfügbar, da ihre Höhe automatisch an die Größe des iFrame angepasst wird.
type: "page:properties:changed",
height: 1000
Attribut | Format | Beschreibung |
---|---|---|
height |
Integer | Die Höhe des Dashboard-iFrame in Pixeln |
session:tokens
Dieses Ereignis zeigt an, dass der Looker-Client Tokens benötigt, um fortzufahren. Dieses Ereignis wird sofort nach der Erstellung des iFrames und danach regelmäßig für die Dauer 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 Enthalten, wenn der iFrame erstellt wird. Nicht in einer Antwort auf eine Anfrage zum Generieren von Tokens enthalten oder wenn die Sitzung abgelaufen ist. |
authentication_token_ttl |
Nummer | Gültigkeitsdauer des Authentifizierungstokens in Sekunden. Enthalten, wenn der iFrame erstellt wird. 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 |
Nummer | Gültigkeitsdauer des API-Tokens in Sekunden. Nicht enthalten, wenn die Sitzung abgelaufen ist. |
navigation_token |
String | Navigations-Token. Nicht enthalten, wenn die Sitzung abgelaufen ist. |
navigation_token_ttl |
Nummer | Gültigkeitsdauer von Navigationstokens in Sekunden. Nicht enthalten, wenn die Sitzung abgelaufen ist. |
session_references_token_ttl |
Nummer | Sitzungsdauer in Sekunden. Nach Ablauf der Sitzung ist der Wert 0. Zur Wiederherstellung muss die Einbettungsanwendung eine neue Sitzung abrufen. |
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 |
Nummer | Sitzungsdauer in Sekunden. |
expired |
Boolesch | Wenn true , bedeutet dies, dass die Sitzung abgelaufen ist. |
interrupted |
Boolesch | Gibt bei true an, dass auf eine Anfrage nach Sitzungstokens nicht geantwortet wurde. Dies könnte darauf hindeuten, dass ein Server vorübergehend nicht verfügbar ist. |
recoverable |
Boolesch | Wird nur ausgefüllt, wenn es unterbrochen wird: true . Gibt an, ob die Sitzung wiederhergestellt werden kann. Der Wert false bedeutet wahrscheinlich, dass ein Problem mit der Einbettungsanwendung vorliegt. |
env:client:dialog
Das Ereignis wird generiert, wenn ein Dialogfeld geöffnet wurde, das teilweise nicht zu sehen ist, z. B. ein Drilldown-Dialogfeld. Dadurch kann die Hosting-App das Dialogfeld mit der Aktion env:host:scroll
sichtbar machen.
{
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 Dialogfeld zum Drilldown-Vorgang unterstützt. In Zukunft werden möglicherweise weitere Dialogfelder hinzugefügt. Möglicherweise ist der obere Bereich des Dialogfelds für die Aufschlüsselung nicht zu sehen, da das Dialogfeld den iFrame-Darstellungsbereich verdeckt. Dieses Ereignis ermöglicht der Host-Anwendung, den oberen Rand des Dialogfelds in den sichtbaren Bereich zu scrollen. |
dialogType |
String | Der Typ des Dialogfelds. Derzeit wird dieses Ereignis nur durch das Öffnen oder Schließen des Dialogfeldtyps „Bohren“ ausgelöst. |
placement |
String | Die Position des Dialogfelds. In Dialogfeldern vom Typ „Bohren“ wird immer als placement „Cover“ verwendet. |
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 so ändern:
- Schreiben Sie Ihre Anfrage im JSON-Format.
- Posten Sie die Anfrage im
contentWindow
-Element des iFrames.
Anfrage in JSON schreiben
Sie können mehrere Änderungen am iFrame vornehmen, den Sie dann im JSON-Format senden. Die verfügbaren Optionen werden im Abschnitt Aktionsreferenz auf dieser Seite beschrieben. Vergessen Sie nicht, Ihre Aktion mit JSON.stringify
in ein JSON-Format umzuwandeln:
var my_request = JSON.stringify(
{
type: "dashboard:run"
}
);
Anfrage im Attribut contentWindow
des iFrames posten
Posten Sie Ihre Nachricht schließlich wie folgt 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 zugehörigen Details aufzurufen.
Vorgang | Aktionsbeschreibung |
---|---|
dashboard:load |
Lädt ein neues Dashboard im iFrame, sodass ein vorhandenes Dashboard ersetzt wird. |
dashboard:run |
Führt das Dashboard im iFrame aus. |
dashboard:edit |
ADDED 22.20 Versetzt das Dashboard in den Bearbeitungsmodus. |
dashboard:filters:update |
Aktualisiert einen vorhandenen Dashboard-Filter im iFrame. |
dashboard:options:set |
Schreibt neue Werte in Dashboard-Layout- und Dashboard-Elementeigenschaften. |
dashboard:schedule_modal:open |
Öffnet das Planungsprogramm, mit dem Benutzer Looker-Inhalte an verschiedene Ziele liefern 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 das Explore im iFrame aus. |
explore:filters:update |
Aktualisiert oder entfernt einen vorhandenen Explore-Filter im iFrame. |
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 an den eingebetteten iFrame senden:
dashboard:load
Verwenden Sie diese Aktion, um ein neues Dashboard in den iFrame zu laden und ein vorhandenes Dashboard zu ersetzen. Das neue Dashboard beginnt mit der Ausführung von Abfragen, als ob eine neue Dashboard-Seite geöffnet worden wäre.
{
type: "dashboard:load",
id: "101",
pushHistory: false
}
Attribut | Format | Beschreibung |
---|---|---|
type |
String | Wenn Sie den Typ dashboard:load verwenden, bedeutet das, dass Sie ein neues Dashboard in den iFrame laden möchten. |
id |
String | Die ID des zu ladenden Dashboards. |
pushHistory |
Boolesch | Wenn true , erstellt das geladene Dashboard einen neuen Eintrag im Browserverlauf und der Nutzer kann über die Schaltfläche „Zurück“ des Browsers zum vorherigen Dashboard zurückkehren. Wenn false , wird das aktuelle Dashboard ersetzt und die Browsernavigation kann nicht verwendet werden, um zum Dashboard zurückzukehren. |
dashboard:run
Mit dieser Aktion können Sie das Dashboard im iFrame ausführen. Dies entspricht dem Klicken auf die Schaltfläche Ausführen oder Daten neu laden auf dem Dashboard.
{
type: "dashboard:run"
}
Attribut | Format | Beschreibung |
---|---|---|
type |
String | Die Verwendung des Typs dashboard:run gibt an, dass Sie das Dashboard ausführen möchten. |
dashboard:edit
ADDED 22.20 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 | Der Typ dashboard:edit bedeutet, 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 folgendes 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
eingetreten ist.
Der Einbettungscode erstellt die Nachricht und sendet sie an den iFrame, aber das Dashboard antwortet erst nach dashboard:run:complete
. Die Aktion dashboard:options:set
schreibt neue Werte in das Dashboard-Layout und in die Dashboard-Elementeigenschaften. Nur Eigenschaften, die im Attribut options
des Ereignisses dashboard:run:complete
zurückgegeben wurden, können mit dashboard:options:set
aktualisiert werden. Alle festgelegten Eigenschaften, die noch nicht durch das 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 | Die Verwendung des Typs dashboard:options:set gibt an, dass Sie neue Werte in die Attribute 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. Sie haben ein ähnliches Format wie das:
|
layouts.dashboard_layout_components |
Objekt | Ein oder mehrere Dashboard-Layout-Komponenten, die vom Attribut options im Ereignis dashboard:run:complete zurückgegeben werden. Sie haben ein ähnliches Format wie das:
|
elements |
Objekt | Ein oder mehrere Dashboard-Element-Objekte, die vom Attribut options im Ereignis dashboard:run:complete zurückgegeben werden. Sie haben ein ähnliches Format wie das:id: { title: "string", title_hidden: boolean, vis_config: { type: "string", title: "string" }} |
dashboard:schedule_modal:open
Verwenden Sie diese Aktion, um das Planungsprogramm zu öffnen, mit dem Nutzer Looker-Inhalte an verschiedene Ziele senden können.
{
type: "dashboard:schedule_modal:open"
}
Attribut | Format | Beschreibung |
---|---|---|
type |
String | Wenn Sie den Typ dashboard:schedule_modal:open verwenden, geben Sie an, dass Sie das Dialogfeld Zeitplan öffnen möchten. |
dashboard:stop
Verwenden Sie diese Aktion, um ein ausgeführtes Dashboard zu beenden oder Daten neu zu laden. Dies entspricht dem Klick auf die Schaltfläche Abbrechen auf dem Dashboard. Ein Dashboard, das dashboard:stop
nicht mehr verwendet, sendet ein dashboard:run:complete
-Ereignis, wobei status:
auf "stopped"
gesetzt ist.
{
type: "dashboard:stop"
}
Attribut | Format | Beschreibung |
---|---|---|
type |
String | Die Verwendung des Typs dashboard:stop gibt an, dass Sie das ausgeführte Dashboard beenden möchten. |
look:run
Verwenden Sie diese Aktion, um die Abfrage auszuführen, auf der der Look im iFrame basiert. Diese Aktion ähnelt dem Klicken auf die Schaltfläche Ausführen im Look, mit der Ausnahme, dass look:run
die Datenbank immer direkt abfragt und keine Daten aus dem Looker-Cache abruft.
{
type: "look:run"
}
Attribut | Format | Beschreibung |
---|---|---|
type |
String | Die Verwendung des Typs look:run gibt an, dass Sie den Look ausführen möchten. |
look:filters:update
Mit dieser Aktion können Sie einen vorhandenen Look-Filter im iFrame 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 | Die Verwendung des Typs look:filters:update gibt 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 folgendes Format: {"view_name.field_name_1": "value 1", "view_name.field_name_1": "value 2", ...} |
explore:run
Verwenden Sie diese Aktion, um das Explore im iFrame auszuführen. Diese Aktion ähnelt dem Klicken auf die Schaltfläche Ausführen im Explore, mit der Ausnahme, dass explore:run
die Datenbank immer direkt abfragt und keine Daten aus dem Looker-Cache abruft.
{
type: "explore:run"
}
Attribut | Format | Beschreibung |
---|---|---|
type |
String | Die Verwendung des Typs explore:run gibt an, dass Sie das 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 einfü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 | Der Typ explore:filters:update gibt an, dass Sie die vom Explore verwendeten Filter aktualisieren möchten. |
filters |
Objekt | Die neuen Filter, die Sie auf das Explore anwenden möchten. Wenn filters einen Filter enthält, der derzeit nicht im Explore vorhanden ist, aber auf ein gültiges Feld verweist, wird dieser Filter dem Explore hinzugefügt. Dieses Objekt hat folgendes 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 folgendes Format: ["view_name.field_name_1", "view_name.field_name_2", ...] |
session:tokens:request
Mit dieser Aktion können Sie Tokens als Antwort auf eine session:tokens:request
-Anfrage senden.
{
type: "session:tokens:request",
}
Attribut | Format | Beschreibung |
---|---|---|
type |
String | Die Verwendung des Typs session:tokens:request gibt an, dass Sie Tokens als Antwort auf ein session:tokens:request -Ereignis senden möchten. |
env:host:scroll
Verwenden Sie diese Aktion, um Informationen zur aktuellen Scrollposition des Host-iFrames an die eingebettete Looker-Anwendung zu senden.
{
type: "env:host:scroll",
offsetTop: 10,
offsetLeft: 10,
scrollX: 5,
scrollY: 5
}
Attribut | Format | Beschreibung |
---|---|---|
type |
String | Wenn Sie den Typ env:host:scroll verwenden, geben Sie an, dass Sie Informationen zur aktuellen Scrollposition des Host-iFrames an die eingebettete Looker-Anwendung senden möchten. |
offsetTop |
Nummer | Entspricht dem oberen Rand des iFrames. |
offsetLeft |
Nummer | Der Versatz links vom iFrame. |
scrollX |
Nummer | Die ScrollX-Position des Anwendungshosts. |
scrollY |
Nummer | Die Scrolly-Position des Anwendungshosts. |