Eingebettete JavaScript-Ereignisse

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. Sie können Ihre Seite je nach Status des eingebetteten Elements dynamischer gestalten und sogar Änderungen am eingebetteten Element direkt auf Ihrer Website 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, Ihr JavaScript so zu schreiben, dass die Ereignisbehandlung in verschiedenen Browsern berücksichtigt wird.

Sie haben folgende Möglichkeiten, JavaScript für eingebettete Looker-Inhalte zu verwenden:

  • Mit dem eingebetteten Software Development Kit (SDK) von Looker, wie auf der Dokumentationsseite zum Embed SDK beschrieben
  • Mit JavaScript-Ereignissen, wie im Abschnitt Auf Ereignisse in JavaScript zugreifen auf dieser Seite beschrieben

Vorbereitung

Bevor Sie mit dem eingebetteten iFrame interagieren können, müssen Sie die folgenden Schritte ausführen:

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üge deinem Iframe dazu eine ID hinzu, falls du das noch nicht getan hast. 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>

Die 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 Sie das Embed SDK verwenden, fügen Sie am Ende der Einbettungs-URL sdk=2 hinzu. Der Parameter sdk=2 gibt an, dass das SDK vorhanden ist und dass Looker zusätzliche Funktionen des SDKs nutzen kann, z. B. das Übergeben 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 auf die Zulassungsliste setzen

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:

  1. 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 im Feld angezeigt wird.

  2. 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 das Einbetten ohne Cookies mit Looker 23.8 oder höher verwenden, kann die Einbettungsdomain beim Abrufen der Sitzung ohne Cookies angegeben werden. Dies ist eine Alternative dazu, die Einbettungsdomain über das Steuerfeld 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 Vorbereitungsschritte ausgeführt haben, können Sie auf die Ereignisse zugreifen, die zwischen dem Looker-Iframe und Ihrer Domain übergeben werden. Dazu müssen Sie postMessage-Ereignisse überwachen.

Der eingebettete iFrame kann mehrere 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 dafür, wie diese Ereignisse in jQuery überwacht und dann in der Konsole protokolliert werden:

$(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 Ereignistypzusammenfassung

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 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 ist fertig und alle Kacheln wurden geladen und abgefragt.
dashboard:download Der Download einer PDF-Datei eines Dashboards wurde gestartet.
dashboard:edit:start HINZUGEFÜGT 22.20 Ein Dashboard wurde in den Bearbeitungsmodus versetzt. Das dashboard:save:complete-Ereignis wird ausgelöst, wenn das Dashboard erfolgreich gespeichert wurde.
dashboard:edit:cancel HINZUGEFÜGT 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 Kachel wird geladen oder es wird eine Abfrage gestartet.
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 Für einen Look wurde mit dem Laden von Abfragedaten begonnen, unabhängig davon, ob die Abfrage ausgeführt wird oder nicht.
look:run:start Für einen Look werden Abfragedaten geladen und die Abfrage wird ausgeführt.
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 in einem Dashboard, das mit dem LookML-Parameter link erstellt wurde, auf ein Aufschlüsselungsmenü geklickt.
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 Von hier erkunden geklickt.
explore:ready Für eine explorative Datenanalyse wurde mit dem Laden von Abfragedaten begonnen, unabhängig davon, ob die Abfrage ausgeführt wird oder nicht.
explore:run:start Für ein Explore werden Abfragedaten geladen und die Abfrage wird ausgeführt.
explore:run:complete Die Abfrage für ein Explore ist abgeschlossen.
explore:state:changed Die URL einer Explore-Seite hat sich aufgrund der Aktionen des Nutzers geändert.
page:changed Ein Nutzer ist innerhalb des iframes zu einer neuen Seite weitergeleitet worden.
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 sichtbar ist, z. B. ein Drilldown-Dialogfeld. Mit diesem Ereignis kann die Hostinganwendung das Dialogfeld in den Blickbereich scrollen.

Ereignistypreferenz

Der eingebettete iFrame kann viele verschiedene Arten von Ereignissen erstellen:

dashboard:loaded

Bei Dashboards, bei denen die Kacheln nicht automatisch ausgeführt werden, 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, der oben im Dashboard angezeigt wird.
dashboard.canEdit Boolesch HINZUGEFÜGT 22.20 Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten.
dashboard.dashboard_filters Object 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 Object 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 das Laden eines Dashboards begonnen hat und die Kacheln 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/Zeichenfolge Die ID des Dashboards.
dashboard.title String Der Titel, der oben im Dashboard angezeigt wird.
dashboard.canEdit Boolesch HINZUGEFÜGT 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 Object 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 "complete" zurück. Andernfalls wird "error" zurückgegeben. 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/String Die ID des Dashboards.
dashboard.title String Der Titel, der oben im Dashboard angezeigt wird.
dashboard.canEdit Boolesch HINZUGEFÜGT 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 Object Die auf das Dashboard angewendeten Filter. Dieses Objekt hat folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.options Object Die Eigenschaften und Werte für Dashboard-Layout, Dashboard-Layoutkomponente und Dashboard-Element 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:

  • tileId: Die ID der Kachel.
  • status: Wenn die Kachelnabfrage erfolgreich ausgeführt wurde, gibt status den Wert "complete" zurück. Andernfalls wird "error" zurückgegeben.
  • errors: Wird ausgefüllt, wenn die Eigenschaft status den Wert "error" hat. Ein Array von Objekten mit Details zum Fehler, einschließlich des Texts der Fehlermeldung, einer detaillierteren Beschreibung des Fehlers und der SQL-Abfrage der Kachel, die den Fehler verursacht hat.

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, der oben im Dashboard angezeigt wird.
dashboard.canEdit Boolesch HINZUGEFÜGT 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 Object 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

HINZUGEFÜGT 22.20 Dieses Ereignis wird erstellt, wenn ein Dashboard in den Bearbeitungsmodus gewechselt wird.

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, der oben im Dashboard angezeigt wird.
dashboard.canEdit Boolesch HINZUGEFÜGT 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 Object Die auf das Dashboard angewendeten Filter. Dieses Objekt hat folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}

dashboard:edit:cancel

HINZUGEFÜGT 22.20 Dieses Ereignis wird erstellt, wenn ein Dashboard im Bearbeitungsmodus den Bearbeitungsmodus ohne Speichern verlassen.

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, der oben im Dashboard angezeigt wird.
dashboard.canEdit Boolesch HINZUGEFÜGT 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 Object 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, der oben im Dashboard angezeigt wird.
dashboard.canEdit Boolesch HINZUGEFÜGT 22.20 Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten.
dashboard.dashboard_filters Object 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 Object Die Eigenschaften und Werte für Dashboard-Layout, Dashboard-Layoutkomponente und Dashboard-Element 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, der oben im Dashboard angezeigt wird.
dashboard.canEdit Boolesch HINZUGEFÜGT 22.20 Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten.
dashboard.dashboard_filters Object 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 Object Die Eigenschaften und Werte für Dashboard-Layout, Dashboard-Layoutkomponente und Dashboard-Element Alle im options-Objekt zurückgegebenen Properties können über das 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/Zeichenfolge Die ID des Dashboards, zu dem die Kachel 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 HINZUGEFÜGT 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 Kachel gehört.
dashboard.absoluteUrl String Die vollständige Dashboard-URL, zu der die Kachel gehört.
dashboard.dashboard_filters Object 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 Ganzzahl Die ID-Nummer des Ereignisses, nicht der Kachel.
tile.title String Der Titel der Kachel, der oben in der Kachel angezeigt wird.
tile.listen Object Die globalen Dashboard-Filter, auf die diese Kachel wartet. Dieses Objekt hat folgendes Format: {"Filter Label": "Filter Field", ...}

dashboard:tile:complete

Dieses Ereignis wird erstellt, wenn die Abfrage für eine Kachel abgeschlossen wurde.

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 Kachel 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 HINZUGEFÜGT 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 Kachel gehört.
dashboard.absoluteUrl String Die vollständige Dashboard-URL, zu der die Kachel gehört.
dashboard.dashboard_filters Object Die Filter, die auf das Dashboard angewendet werden, zu dem die Kachel 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 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 Kachel, der oben in der Kachel angezeigt wird.
tile.listen Object 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 die Property status den Wert "error" hat. Ein Array von Objekten mit Details zum Fehler, einschließlich des Texts der Fehlermeldung, 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 Kachel 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 HINZUGEFÜGT 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 Kachel gehört.
dashboard.absoluteUrl String Die vollständige Dashboard-URL, zu der die Kachel gehört.
dashboard.dashboard_filters Object 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 Ganzzahl Die ID-Nummer des Ereignisses, nicht der Kachel.
tile.title String Der Titel der Kachel, der oben in der Kachel angezeigt wird.
tile.listen Object 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 Das Label der Schaltfläche.
url String Die relative URL (nur der Pfad) des zu öffnenden Explores.
dashboard.id Zahl/Zeichenfolge Die ID des Dashboards, zu dem die Kachel 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 HINZUGEFÜGT 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 Kachel gehört.
dashboard.absoluteUrl String Die vollständige Dashboard-URL, zu der die Kachel gehört.
dashboard.dashboard_filters Object 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 Ganzzahl Die ID-Nummer des Ereignisses, nicht der Kachel.
tile.title String Der Titel der Kachel, der oben in der Kachel angezeigt wird.
tile.listen Object Die globalen Dashboard-Filter, auf die diese Kachel wartet. Dieses Objekt hat folgendes Format: {"Filter Label": "Filter Field", ...}

dashboard:tile:view

Dieses Ereignis wird erstellt, wenn ein Nutzer in einer Dashboardkachel auf die Option Original-Look ansehen 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 Das Label der Schaltfläche.
url String Die relative URL (nur der Pfad) des gewünschten Looks.
dashboard.id Zahl/String Die ID des Dashboards, zu dem die Kachel 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 HINZUGEFÜGT 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 Kachel gehört.
dashboard.absoluteUrl String Die vollständige Dashboard-URL, zu der die Kachel gehört.
dashboard.dashboard_filters Object 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 Ganzzahl Die ID-Nummer des Ereignisses, nicht der Kachel.
tile.title String Der Titel der Kachel, der oben in der Kachel angezeigt wird.
tile.listen Object Die globalen Dashboard-Filter, auf die diese Kachel wartet. 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, der oben im Dashboard angezeigt wird.
dashboard.canEdit Boolesch HINZUGEFÜGT 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 Object Die auf das Dashboard angewendeten Filter. Dieses Objekt hat folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.options Object Die Eigenschaften und Werte für Dashboard-Layout, Dashboard-Layoutkomponente und Dashboard-Element Alle im options-Objekt zurückgegebenen Properties können über das 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 in einem Look Abfragedaten geladen 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 die Abfrage für einen Look abgeschlossen ist.

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:

Dieses Ereignis wird nicht erstellt, wenn der Look über die Schaltfläche Save > Auf ein vorhandenes Dashboard oder auf die Menüoption Einstellungen bearbeiten.

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, in der 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 state-Filter auf Illinois gesetzt ist, gibt das drillmenu:click-Ereignis 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 Drilldown-Menü angezeigt wird
link_type String Der Typ des Objekts am Linkziel
modal Boolesch Legt fest, ob das Dialogfeld zur Aufschlüsselung anstelle der Browsernavigation verwendet wird
target String „_self“, wenn das Linkziel den aktuellen iframe ersetzt, „_blank“, wenn das Linkziel ein neues Fenster öffnet
url String Die URL des Linkziels
context String Internes Attribut, das von einigen Visualisierungstypen verwendet wird

Wenn Sie den Iframe in einer Sandbox platzieren, wird verhindert, dass Klicks auf das Drilldown-Menü in einem neuen Fenster geöffnet werden. 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 Kachel 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 Kachel gehört.
dashboard.absoluteUrl String Die vollständige Dashboard-URL, zu der die Kachel gehört.
dashboard.dashboard_filters Object Die Filter, die auf das Dashboard angewendet werden, zu dem die Kachel 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 des Datendownloads.

drillmodal:explore

Dieses Ereignis wird erstellt, wenn ein Nutzer in einem Drilldown-Dialogfeld auf die Option Hier analysieren 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 URL für die Datenanalyse (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 URL für die Explore-Ansicht (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 URL für die Explore-Ansicht (nur der Pfad)
explore.absoluteUrl String Die vollständige Explore-URL

explore:run:complete

Dieses Ereignis wird erstellt, wenn die Abfrage in einem Explore abgeschlossen wurde.

type: "explore:run:complete",
explore: {
  url: "/embed/explore/...",
  absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
  }
}
Attribut Format Beschreibung
explore.url String Die relative URL für die Explore-Ansicht (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 URL für die Explore-Ansicht (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 Die Art der Seite, zu der gerade weitergeleitet wurde, z. B. "dashboard", "look" oder "explore"
page.url String Die relative URL (nur der Pfad) der Seite, auf die gerade zugegriffen 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 Ganzzahl 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 Zahl 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 Wird nicht berücksichtigt, 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. Wird nicht berücksichtigt, wenn die Sitzung abgelaufen ist.
navigation_token_ttl Zahl Gültigkeitsdauer des Navigationstokens in Sekunden. Wird nicht berücksichtigt, wenn die Sitzung abgelaufen ist.
session_references_token_ttl Zahl Gültigkeitsdauer der Sitzung in Sekunden. Wenn die Sitzung abgelaufen ist, 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 Zahl Gültigkeitsdauer der Sitzung 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 kann darauf hindeuten, dass ein Server vorübergehend nicht verfügbar ist.
recoverable Boolesch Wird nur ausgefüllt, wenn „unterbrochen“ true ist. Gibt an, ob die Sitzung wiederhergestellt werden kann oder nicht. Der Wert false bedeutet wahrscheinlich, dass ein Problem mit der Einbettungsanwendung vorliegt.

env:client:dialog

Das Ereignis wird generiert, wenn ein Dialogfeld geöffnet wird, das teilweise nicht sichtbar 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 „Aufschlüsseln“ unterstützt. Weitere Dialogfelder werden aber möglicherweise in Zukunft hinzugefügt. Es kann sein, dass der obere Bereich des Dialogfelds nicht sichtbar ist, da das Dialogfeld den iFrame-Darstellungsbereich bedeckt. 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 nur das Öffnen oder Schließen des Dialogfeldtyp löst dieses Ereignis aus.
placement String Die Platzierung des Dialogfelds. Dialogfelder vom Typ „Bohren“ immer das placement-Attribut „Cover“ verwenden.
open Boolesch Gibt an, ob das Dialogfeld geöffnet oder gescrollt ist.

Änderungen am iFrame vornehmen

Nachdem Sie den iFrame für den Datenabruf vorbereitet haben, können Sie ihn so ändern:

  1. Schreiben Sie Ihre Anfrage im JSON-Format.
  2. Poste die Anfrage an die contentWindow des Iframes.

Anfrage in JSON schreiben

Sie können mehrere Änderungen am Iframe vornehmen, den Sie in JSON-Form einreichen. Die verfügbaren Optionen werden auf dieser Seite im Abschnitt Referenz für Aktionen beschrieben. Vergessen Sie nicht, Ihre Aktion mit JSON.stringify in ein JSON-Format umzuwandeln:

var my_request = JSON.stringify(
  {
    type: "dashboard:run"
  }
);

Anfrage an die contentWindow-Property des iframes posten

Poste deine Nachricht abschließend in der contentWindow des iFrames, z. B. so:

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 zu sehen.

Aktion Aktionsbeschreibung
dashboard:load Lädt ein neues Dashboard im iFrame und ersetzt damit ein vorhandenes Dashboard.
dashboard:run Führt das Dashboard im iFrame aus.
dashboard:edit HINZUGEFÜGT 22.20 Damit wird das Dashboard in den Bearbeitungsmodus versetzt.
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 den Scheduler, 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 die Suche 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 explorativen Datenanalyse-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 kannst du im eingebetteten iFrame posten:

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 Mit dem Typ dashboard:load geben Sie an, 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 wird das Dashboard im iFrame ausgeführt. Das entspricht dem Drücken der Schaltfläche Ausführen oder Daten neu laden im Dashboard.

{
  type: "dashboard:run"
}
Attribut Format Beschreibung
type String Mit dem Typ dashboard:run geben Sie an, dass Sie das Dashboard ausführen möchten.

dashboard:edit

HINZUGEFÜGT 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 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 Mit dem Typ dashboard:filters:update geben Sie an, dass Sie die vom Dashboard verwendeten Filter aktualisieren möchten.
filters Object 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 aufgetreten ist.

Der Einbettungscode erstellt die Nachricht und sendet sie an den Iframe. Das Dashboard reagiert jedoch erst, nachdem dashboard:run:complete eingetreten ist. Die Aktion dashboard:options:set schreibt neue Werte in das Dashboard-Layout und 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 Object Die Eigenschaften des Dashboard-Layouts, die vom options-Attribut im dashboard:run:complete-Ereignis zurückgegeben werden. Sie haben ein ähnliches Format wie:

  • id: "string",
  • dashboard_id: "string",
  • type: "newspaper",
  • active: boolean,
  • column_width: number,
  • width: number
layouts.dashboard_layout_components Object Ein oder mehrere Dashboard-Layout-Komponenten, die vom Attribut options im Ereignis dashboard:run:complete zurückgegeben werden. Sie haben ein Format wie das:

  • id: "string",
  • dashboard_layout_id: "string",
  • dashboard_element_id: "string",
  • row: number,
  • column: number,
  • width: number,
  • height: number,
  • deleted: boolean,
elements Object 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

Mit dieser Aktion wird der Scheduler geöffnet, 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, wird das Dialogfeld Zeitplan geöffnet.

dashboard:stop

Mit dieser Aktion können Sie ein Dashboard beenden, das gerade ausgeführt wird oder Daten neu lädt. 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 bedeutet, 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. Der Unterschied besteht darin, dass look:run immer direkt die Datenbank 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 Wenn Sie den Typ look:filters:update verwenden, geben Sie an, dass Sie die vom Look verwendeten Filter aktualisieren möchten.
filters Object Die neuen Filter, die du auf den Look anwenden möchtest. 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 Mit dem Typ explore:run geben Sie an, dass Sie die explorative Datenanalyse 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 Object 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 der explorativen Datenanalyse entfernen möchten. Das Array hat das 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

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 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 Zahl Der vertikale Versatz des iFrames.
offsetLeft Zahl Der Versatz links vom iFrame.
scrollX Zahl Die scrollX-Position des Anwendungshosts.
scrollY Zahl Die Scrolly-Position des Anwendungshosts.