Eingebettete JavaScript-Ereignisse

Nachdem du ein öffentliches, privates, signiertes oder API-basiertes Embed erstellt hast, kannst du mit diesen Iframes über JavaScript 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.

Die Reihenfolge, in der Browser Ereignisse an Webanwendungen senden, wird nicht von Looker gesteuert. Das bedeutet, dass die Reihenfolge der Ereignisse nicht plattform- oder browserübergreifend garantiert ist. 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:

Vorbereitung

Bevor du mit dem eingebetteten iframe interagieren kannst, musst du die folgenden Schritte ausführen:

IFrame eine ID 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>

src-Attribut des iframes die Domain für die Einbettung 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 signiertes Einbetten verwendest, musst du der URL zum Einbetten 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

Fügen Sie abschließend die Domain, in der der Iframe verwendet wird, auf der Seite Embed (Einbetten) im Bereich Admin (Verwaltung) von Looker der Zulassungsliste hinzu. 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. Beispiel: Für https://*.myownpersonaldomain.com sind sowohl https://analytics.myownpersonaldomain.com als auch https://data.myownpersonaldomain.com zulässig.

Wenn Sie das Einbetten ohne Cookies mit Looker 23.8 oder höher verwenden, kann die Domain für das Einbetten beim Abrufen der Sitzung ohne Cookies angegeben werden. Das ist eine Alternative dazu, die Domain für das Einbetten ü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 abrufen

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.

Auf Ereignisse in JavaScript zugreifen

Hier ist ein Beispiel dafür, wie diese Ereignisse in nativem 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 Ereignisursache
dashboard:loaded Bei Dashboards, bei denen die Kacheln nicht automatisch ausgeführt werden, sind das Dashboard und seine Elemente zwar geladen, aber es werden noch keine Abfragen ausgeführt.
dashboard:run:start Ein Dashboard wird geladen und die Kacheln werden geladen und es werden Daten abgefragt.
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 Ereignis dashboard:save:complete 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 Die Abfrage für eine Kachel ist abgeschlossen.
dashboard:tile:download Der Download der Daten einer Kachel hat begonnen.
dashboard:tile:explore Ein Nutzer hat in einer Dashboard-Kachel auf die Option Hier beginnen geklickt.
dashboard:tile:view Ein Nutzer hat in einer Dashboardkachel auf die Option Original-Look ansehen 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 Die Abfrage für einen Look ist abgeschlossen.
look:save:complete Ein Look wurde bearbeitet und gespeichert.
look:delete:complete Ein Look wurde in den Ordner 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 Aufschlüsselungsdialogfeld geöffnet und auf die Option Herunterladen geklickt.
drillmodal:explore Ein Nutzer hat in einem Drilldown-Dialogfeld auf die Option Hier analysieren 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.

Referenz zum Ereignistyp

Der eingebettete iframe kann viele verschiedene Arten von Ereignissen auslösen:

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 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: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/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:run:complete

Dieses Ereignis wird erstellt, wenn die Ausführung eines Dashboards abgeschlossen ist und das Laden und Abfragen aller Kacheln abgeschlossen ist. Dieses Ereignis wird unabhängig davon erstellt, ob alle Kacheln erfolgreich geladen wurden.

type: "dashboard:run:complete",
status: "complete",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://my.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
  options: {
    layouts: [
      {
        id: 1,
        dashboard_id: 1,
        type: "newspaper",
        active: true,
        column_width: null,
        width: null,
        deleted: false,
        dashboard_layout_components: [
          {
            id: 1,
            dashboard_layout_id: 1,
            dashboard_element_id: 1,
            row: 0,
            column: 0,
            width: 8,
            height: 4,
            deleted: false
          },
          {
            id: 2,
            dashboard_layout_id: 1,
            dashboard_element_id: 2,
            row: 0,
            column: 8,
            width: 8,
            height: 4,
            deleted: false
          }
        ]
      }
    ],
    elements: {
      1: {
        title: "Total Orders",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          font_size: "medium",
          title: "Total Orders"
        }
      },
      2: {
        title: "Average Order Profit",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          title: "Average Order Profit"
        }
      }
    }
  }
}
Attribut Format Beschreibung
status String Gibt an, ob das Dashboard und seine Elemente erfolgreich ausgeführt wurden. Wenn das Dashboard und seine Elemente erfolgreich ausgeführt wurden, gibt status "complete" zurück. Andernfalls gibt status "error" zurück. Wenn das laufende Dashboard entweder über die Benutzeroberfläche oder mit der Aktion dashboard:stop angehalten wurde, gibt status "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 Properties können mit der Aktion dashboard:options:set aktualisiert werden.
dashboard.tileStatuses Objektarray Ein Array von Objekten mit Kachelnstatus. Objekteigenschaften sind:

  • tileId: Die ID der Kachel.
  • status: Wenn die Kachelnabfrage erfolgreich ausgeführt wurde, gibt status den Wert "complete" zurück. Andernfalls gibt status den Wert "error" zurück.
  • errors: 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:download

Dieses Ereignis wird erstellt, wenn der Download einer PDF-Datei eines Dashboards gestartet wurde.

type: "dashboard:download",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
fileFormat: "pdf"
Attribut Format Beschreibung
dashboard.id Zahl/String Die ID des Dashboards.
dashboard.title String Der Titel, 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/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:edit:cancel

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

type: "dashboard:edit:cancel",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
Attribut Format Beschreibung
dashboard.id Zahl/String Die ID des Dashboards.
dashboard.title String Der Titel, 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/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 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:delete:complete

Dieses Ereignis wird erstellt, wenn ein Dashboard gelöscht wird.

type: "dashboard:delete:complete",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  url: "/embed/dashboards/...",
  options: {
    layouts: [
      {
        id: 1,
        dashboard_id: 1,
        type: "newspaper",
        active: true,
        column_width: null,
        width: null,
        deleted: false,
        dashboard_layout_components: [
          {
            id: 1,
            dashboard_layout_id: 1,
            dashboard_element_id: 1,
            row: 0,
            column: 0,
            width: 8,
            height: 4,
            deleted: false
          },
          {
            id: 2,
            dashboard_layout_id: 1,
            dashboard_element_id: 2,
            row: 0,
            column: 8,
            width: 8,
            height: 4,
            deleted: false
          }
        ]
      }
    ],
    elements: {
      1: {
        title: "Total Orders",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          font_size: "medium",
          title: "Total Orders"
        }
      },
      2: {
        title: "Average Order Profit",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          title: "Average Order Profit"
        }
      }
    }
  }
}
Attribut Format Beschreibung
dashboard.id Zahl/String Die ID des Dashboards.
dashboard.title String Der Titel, 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 Kachel geladen wird oder Daten abgefragt werden.

type: "dashboard:tile:start",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
tile: {
  id: 123,
  title: "Quarterly Sales",
  listen: {
    "Date": "order.date",
    "Total Orders": "order.count"
  }
}
Attribut Format Beschreibung
dashboard.id Zahl/String Die ID des Dashboards, zu dem die Kachel gehört.
dashboard.title String Der Dashboard-Titel, der oben im Dashboard angezeigt wird, zu dem die Kachel 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", ...}
tile.id Ganzzahl Die ID 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/String Die ID des Dashboards, zu dem die Kachel gehört.
dashboard.title String Der Dashboard-Titel, der oben im Dashboard angezeigt wird, zu dem die Kachel 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 Kachelnabfrage erfolgreich abgeschlossen wurde. Mögliche Werte sind "complete" und "error".
truncated Boolesch Gibt an, ob die Ergebnisse der Kachelnabfrage 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 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", ...}
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/String Die ID des Dashboards, zu dem die Kachel gehört.
dashboard.title String Der Dashboard-Titel, der oben im Dashboard angezeigt wird, zu dem die Kachel 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", ...}
tile.id Ganzzahl Die ID 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", ...}
fileFormat String Das Format der heruntergeladenen Kachel (derzeit nur "pdf").

dashboard:tile:explore

Dieses Ereignis wird erstellt, wenn ein Nutzer in einer Dashboardkachel auf die Option Hier beginnen 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/String Die ID des Dashboards, zu dem die Kachel gehört.
dashboard.title String Der Dashboard-Titel, der oben im Dashboard angezeigt wird, zu dem die Kachel 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", ...}
tile.id Ganzzahl Die ID 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, der oben im Dashboard angezeigt wird, zu dem die Kachel 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", ...}
tile.id Ganzzahl Die ID 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/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 Properties können über das Ereignis dashboard:options:set aktualisiert werden.

look:ready

Dieses Ereignis wird erstellt, wenn in einem Look Abfragedaten geladen werden, 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 Aktionen ausführt:

Dieses Ereignis wird nicht erstellt, wenn der Look über die Menüoption Speichern > Im vorhandenen Dashboard oder Einstellungen bearbeiten gespeichert wird.

type: look:save:complete
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  folderid: 123
  }
}
Attribut Format Beschreibung
look.url String Die relative Look-URL (nur der Pfad)
look.absoluteUrl String Die vollständige Look-URL
look.folderid Ganzzahl Die Ordner-ID, 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 in einem Dashboard, das mit dem LookML-Parameter link erstellt wurde, auf ein Drilldown-Menü klickt. Mit der folgenden LookML-Anweisung wird beispielsweise ein Aufschlüsselungsmenü erstellt, in dem Nutzer Daten sehen können, die nach der Dimension state gefiltert sind:


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 Ob das Dialogfeld zum Aufschlüsseln statt der Browsernavigation verwendet werden soll
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 die folgenden Sandbox-Werte im iframe-Tag:

sandbox = "allow-same-origin allow-scripts"

drillmodal:download

Dieses Ereignis wird erstellt, wenn ein Nutzer über eine Dashboardkachel ein Dialogfeld für die Aufschlüsselung öffnet und auf die Option Herunterladen klickt.

{
type: "drillmodal:download",
dashboard: {
  id: 23,
  title: "My Dashboard",
  url: "/embed/dashboards/…",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/…",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
drillExploreUrl: "/embed...",
fileFormat: "pdf"
}
Attribut Format Beschreibung
dashboard.id Zahl/String Die ID des Dashboards, zu dem die Kachel gehört.
dashboard.title String Der Dashboard-Titel, der oben im Dashboard angezeigt wird, zu dem die Kachel 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 URL des zu ladenden Explores (nur der Pfad).
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 Das Schaltflächenlabel, das im Drilldown-Menü angezeigt wird
url String Die relative URL des zu öffnenden Explores (nur der Pfad)

explore:ready

Dieses Ereignis wird erstellt, wenn in einem Explore Abfragedaten geladen werden, 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 URL der explorativen Datenanalyse

explore:run:start

Dieses Ereignis wird erstellt, wenn in einem Explore Abfragedaten geladen 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 URL der explorativen Datenanalyse

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 URL der explorativen Datenanalyse

explore:state:changed

Dieses Ereignis wird erstellt, wenn sich die URL einer Explore-Seite aufgrund 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 URL der explorativen Datenanalyse

page:changed

Dieses Ereignis wird erstellt, wenn ein Nutzer innerhalb des Iframes zu einer neuen Seite wechselt.

type: "page:changed",
page: {
  type: "dashboard",
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/..."
}
Attribut Format Beschreibung
page.type String 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, auf die gerade zugegriffen wurde

page:properties:changed

Dieses Ereignis wird erstellt, wenn sich die Höhe eines Dashboard-Iframes ändert. Für Looks oder Explores ist sie nicht verfügbar, da diese Elemente ihre Höhe automatisch an die Größe des Iframes anpassen.

type: "page:properties:changed",
height: 1000
Attribut Format Beschreibung
height Ganzzahl Die Höhe des Dashboard-Iframes in Pixeln

session:tokens

Dieses Ereignis gibt an, dass der Looker-Client Tokens benötigt, um fortzufahren. Dieses Ereignis wird sofort beim Erstellen des Iframes und danach regelmäßig während der Sitzung erstellt.

{
  "type": "session:tokens",
  "api_token": "eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczovL3NlbGYtc2lnbmVkLmxvb2tlci5jb206OTk5OSIsImV4cCI6MTY3MDYyNjMzMCwic3ViIjoiYVdrNWFGUzM4RnRwNzFFWXhuS3ZaMXdKRmV3ZjB2VzYtTV9zLWtCcHE1dXIiLCJ0b2tlbl90eXBlIjoiYXBpX3Rva2VuIiwicmFuZG9taXplciI6IkxjYnpOeDNTVjNOb3o3UVlqTVJjNmhlMkdodjh1a2UwWUhiZWNRMHVCYm1KIn0.CBv1__QGc_H7bKNe31SHMMQCsc5ya1xOiEv1UDWAyxM",
  "api_token_ttl": 463,
  "navigation_token": "eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczovL3NlbGYtc2lnbmVkLmxvb2tlci5jb206OTk5OSIsImV4cCI6MTY3MDYyNjMzMCwic3ViIjoiYVdrNWFGUzM4RnRwNzFFWXhuS3ZaMXdKRmV3ZjB2VzYtTV9zLWtCcHE1dXIiLCJ0b2tlbl90eXBlIjoibmF2aWdhdGlvbl90b2tlbiIsInJhbmRvbWl6ZXIiOiJHVVNlc00tdTRPRDlNdktodFJDU2pEcVFhUkJNeTh5dm42Q1FDUXhuLTNxMiJ9.sWo7LUEI5LeragVmeDamUR7u2myXpFJ0aqK_IIALUqI",
  "navigation_token_ttl": 463,
  "session_reference_token_ttl": 2924
}
Attribut Format Beschreibung
authentication_token String Authentifizierungstoken Wird beim Erstellen des iFrames eingefügt. Nicht enthalten in einer Antwort auf eine Anfrage zum Generieren von Tokens oder wenn die Sitzung abgelaufen ist.
authentication_token_ttl Zahl Gültigkeitsdauer des Authentifizierungstokens in Sekunden. Wird beim Erstellen des iFrames eingefügt. Nicht enthalten in einer Antwort auf eine Anfrage zum Generieren von Tokens 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 Anwendung zum Einbetten 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 true gibt an, dass die Sitzung abgelaufen ist.
interrupted Boolesch Wenn true, gibt an, dass eine Anfrage für Sitzungstokens nicht beantwortet 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. Ein Wert von 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. Mit diesem Ereignis kann die Hostinganwendung das Dialogfeld mit der Aktion env:host:scroll in den Blickbereich scrollen.

{
  type: "env:client:dialog",
  dialogType: 'drilling',
  placement: 'cover',
  open: true
}
Attribut Format Beschreibung
type String env:client:dialog gibt an, dass ein Dialogfeld geöffnet oder geschlossen wurde. Derzeit wird nur das Dialogfeld „Aufschlüsseln“ unterstützt. Weitere Dialogfelder werden jedoch 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. Mit diesem Ereignis kann die Hostanwendung den oberen Bereich des Dialogfelds in den Blick bringen.
dialogType String Der Typ des Dialogfelds. Derzeit wird dieses Ereignis nur durch das Öffnen oder Schließen des Dialogfelds „Aufschlüsselung“ ausgelöst.
placement String Die Platzierung des Dialogfelds. Für Dialogfelder vom Typ „Aufschlüsselung“ wird immer eine placement vom Typ „Abdeckung“ verwendet.
open Boolesch Gibt an, ob das Dialogfeld geöffnet oder gescrollt wurde.

Änderungen am iFrame vornehmen

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

  1. Erstellen Sie Ihre Anfrage in JSON.
  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, JSON.stringify zu verwenden, um Ihre Aktion in JSON umzuwandeln. So gehts:

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

Anfrage an die contentWindow-Property des iframes posten

Poste deine Nachricht dann 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 die Eigenschaften des Dashboard-Layouts und der Dashboard-Elemente.
dashboard:schedule_modal:open Öffnet den Scheduler, mit dem Nutzer Looker-Inhalte an verschiedene Ziele senden können.
dashboard:stop Ein Dashboard wird beendet, das gerade 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 die explorative Datenanalyse im iFrame aus.
explore:filters:update Aktualisiert oder entfernt einen vorhandenen explorativen Datenanalyse-Filter im IFrame.
session:tokens:request Sendet Tokens als Reaktion 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 im eingebetteten iFrame gepostet werden:

dashboard:load

Mit dieser Aktion wird ein neues Dashboard im IFrame geladen und ein vorhandenes Dashboard ersetzt. Im neuen Dashboard werden Abfragen ausgeführt, als wäre eine neue Dashboardseite geöffnet worden.

{
  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 festgelegt ist, wird durch das Laden des Dashboards ein neuer Eintrag im Browserverlauf erstellt. Der Nutzer kann dann über die Schaltfläche „Zurück“ des Browsers zum vorherigen Dashboard zurückkehren. Wenn false, wird das aktuelle Dashboard ersetzt und es kann nicht über die Browsernavigation wiederhergestellt werden.

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. Das 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. Mit der Aktion dashboard:options:set werden neue Werte in die Eigenschaften des Dashboard-Layouts und der Dashboard-Elemente geschrieben. Nur Properties, die im options-Attribut des dashboard:run:complete-Ereignisses zurückgegeben wurden, können mit dashboard:options:set aktualisiert werden. Alle festgelegten Properties, die zuvor nicht vom options-Attribut des dashboard:run:complete-Ereignisses 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 Wenn Sie den Typ dashboard:options:set verwenden, geben Sie an, dass Sie neue Werte in die Eigenschaften 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 Objekte der Dashboard-Layoutkomponente, die vom options-Attribut im dashboard:run:complete-Ereignis zurückgegeben werden. Sie haben ein ähnliches Format wie:

  • 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 options-Attribut im dashboard:run:complete-Ereignis zurückgegeben werden. Sie haben ein ähnliches Format wie:

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. Das entspricht dem Klicken auf die Schaltfläche Abbrechen im Dashboard. Wenn für ein Dashboard die Verwendung von dashboard:stop beendet wurde, wird ein dashboard:run:complete-Ereignis mit status: = "stopped" gesendet.

{
  type: "dashboard:stop"
}
Attribut Format Beschreibung
type String Mit dem Typ dashboard:stop geben Sie an, dass Sie das laufende Dashboard beenden möchten.

look:run

Mit dieser Aktion wird die Abfrage, auf der der Look basiert, im IFrame ausgeführt. 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 Mit dem Typ look:run geben Sie an, dass Sie das 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

Mit dieser Aktion wird die explorative Datenanalyse im IFrame ausgeführt. Diese Aktion ähnelt dem Klicken auf die Schaltfläche Ausführen im Explore. Der Unterschied besteht darin, dass explore:run immer direkt die Datenbank 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 den Explore ausführen möchten.

explore:filters:update

Mit dieser Aktion können Sie einen vorhandenen explorativen Datenanalysefilter im iFrame aktualisieren oder entfernen. Wenn Sie einen neuen Filter hinzufügen, der auf ein gültiges Feld verweist, wird er dem Explore hinzugefügt.

{
  type: "explore:filters:update",
  filters: {
    "orders.created_at": "90 days",
    "orders.status": "complete"
  }
  deleteFilters:  ["products.department"]
}
Attribut Format Beschreibung
type String Mit dem Typ explore:filters:update geben Sie an, dass Sie die vom explorativen Datenanalyse 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 kannst du Tokens als Antwort auf eine session:tokens:request-Anfrage senden.

{
  type: "session:tokens:request",
}
Attribut Format Beschreibung
type String Wenn Sie den Typ session:tokens:request verwenden, geben Sie an, dass Sie Tokens als Reaktion 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 Abstand links vom iFrame.
scrollX Zahl Die scrollX-Position des Anwendungshosts.
scrollY Zahl Die scrollY-Position des Anwendungshosts.