Eingebettete JavaScript-Ereignisse

Nachdem Sie eine Einbettung erstellt haben, kann dies öffentlich, privat, mit der Einmalanmeldung (SSO) oder über die API erfolgen. Dann können Sie über JavaScript mit diesen iFrames interagieren. Sie können Ihre Seite je nach Status des eingebetteten Elements dynamischer gestalten oder auch Änderungen am eingebetteten Element über Ihre Webseite vornehmen.

Beachten Sie, dass Looker nicht die Reihenfolge steuert, in der Browser Ereignisse an Webanwendungen senden. Das bedeutet, dass die Reihenfolge der Ereignisse nicht in allen Browsern oder auf allen Plattformen garantiert ist. Achten Sie darauf, Ihren JavaScript-Code richtig zu schreiben, um die Ereignisverarbeitung verschiedener Browser zu berücksichtigen.

Für eingebettete Looker-Inhalte gibt es zwei Möglichkeiten:

Vorbereitung

Sie müssen einige Aktionen ausführen, bevor Sie mit dem eingebetteten iFrame interagieren können:

Dem iFrame eine ID hinzufügen

Sie müssen nun überprüfen, ob die Informationen, mit denen Sie arbeiten, tatsächlich aus dem iFrame von Looker stammen. Fügen Sie dazu dem iFrame eine ID hinzu, sofern noch nicht geschehen. Im folgenden Beispiel wurde id="looker" hinzugefügt:

<iframe id="looker" src="https://instance_name.looker.com/embed/dashboards/1"></iframe>

Eingebettete Domain dem iFrame-Attribut src hinzufügen

Fügen Sie im src des iFrames die Domain hinzu, in der der iFrame verwendet wird. Im folgenden Beispiel wurde ?embed_domain=https://mywebsite.com" hinzugefügt:

<iframe
  id="looker"
  src="https://instance_name.looker.com/embed/dashboards/1?embed_domain=https://mywebsite.com">
</iframe>

Wenn Sie SSO-Einbettung verwenden, müssen Sie embed_domain in die Einbettungs-URL einfügen.

Geben Sie im embed_domain keinen Schrägstrich (/) ein.

Eingebettete Domain auf die Zulassungsliste setzen

Abschließend müssen Sie die Domain, in der der iFrame verwendet wird, auf der Seite Einbetten des Admin-Steuerfelds von Looker der Zulassungsliste hinzufügen:

  1. Geben Sie die Domain ein, in der der iFrame verwendet wird. Drücken Sie nach der Eingabe die Tabulatortaste, damit die Domain in einem Feld angezeigt wird. Fügen Sie in der Domain-URL keinen Schrägstrich (/) ein.
  2. Klicken Sie auf die Schaltfläche Aktualisieren.

Sie können den Platzhalter * in der Zulassungsliste verwenden, um ein Domainmuster zu erstellen. Für https://*.mycompany.com wären beispielsweise sowohl https://analytics.mycompany.com als auch https://data.mycompany.com zulässig.

Wenn Sie für Looker 23.8 oder eine höhere Einbettung ohne Cookies sorgen, kann die Domain eingebettet werden, wenn die Sitzung ohne Cookies erfasst wird. Dies ist eine Alternative, um sie über den Bereich Verwaltung > Einbetten der Zulassungsliste hinzuzufügen. Lesen Sie die Best Practices zur Sicherheit, wenn Sie diese Funktion nutzen möchten.

Daten aus dem iFrame abrufen

Nachdem Sie die Vorbereitungsschritte abgeschlossen haben, können Sie auf Ereignisse zugreifen, die zwischen dem Looker-iFrame und Ihrer Domain übergeben werden. Warten Sie dazu auf postMessage-Ereignisse.

Prüfen Sie, ob die Ereignisse aus dem Looker-iFrame und der Looker-Domain stammen, um schädliche Nachrichten zu vermeiden.

Mit dem eingebetteten iFrame können mehrere Ereignistypen erstellt werden, wie auf dieser Seite im Abschnitt Referenz zum Ereignistyp beschrieben.

Ereignisse in JavaScript aufrufen

Hier ist ein Beispiel für die Überwachung dieser Ereignisse im nativen JavaScript und anschließendes Logging in der Konsole:

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 für das Warten auf diese Ereignisse in jQuery und das anschließende Logging in der Konsole:

$(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 der Übersicht über den Ereignistyp

In der folgenden Tabelle werden Ereignistypen zusammengefasst. Klicken Sie auf einen Ereignistyp, um die zugehörigen Details aufzurufen.

Ereignistyp Ursache des Ereignisses
dashboard:loaded Auf Dashboards, auf denen die Kacheln nicht auf „Automatisch“ eingestellt sind, wurden ein Dashboard und dessen Elemente geladen, aber die Abfragen werden noch nicht ausgeführt.
dashboard:run:start Ein Dashboard hat mit dem Laden begonnen und seine Kacheln haben begonnen, Daten zu laden und abzufragen.
dashboard:run:complete Das Dashboard wurde ausgeführt und alle Kacheln wurden vollständig geladen und abgefragt.
dashboard:download Ein PDF des Dashboards wird heruntergeladen.
dashboard:edit:start 22.20 ADDED Ein Dashboard wurde in den Bearbeitungsmodus gewechselt. Das Ereignis dashboard:save:complete wird ausgelöst, wenn das Dashboard erfolgreich gespeichert wurde.
dashboard:edit:cancel Hinzugefügt am 22.20. Ein Dashboard im Bearbeitungsmodus wurde ohne Speichern beendet.
dashboard:save:complete Ein Dashboard wurde bearbeitet und gespeichert.
dashboard:delete:complete Ein Dashboard wurde gelöscht.
dashboard:tile:start Eine Kachel hat mit dem Laden oder Abfragen von Daten begonnen.
dashboard:tile:complete Die Ausführung der Abfrage ist mit einer Kachel abgeschlossen.
dashboard:tile:download Der Download der Daten einer Kachel wird gestartet.
dashboard:tile:explore Ein Nutzer hat auf der Dashboard-Kachel auf die Option Erkunden von hier geklickt.
dashboard:tile:view Ein Nutzer hat in einer Dashboard-Kachel auf die Option Originallook ansehen geklickt.
dashboard:filters:changed Die Filter eines Dashboards wurden angewendet oder geändert.
look:ready Ein Looker hat mit dem Laden von Abfragedaten begonnen, unabhängig davon, ob die Abfrage ausgeführt wird oder nicht.
look:run:start Für einen Look wurde mit dem Laden von Abfragedaten und der Ausführung der Abfrage begonnen.
look:run:complete Ein Looker hat die Ausführung der Abfrage abgeschlossen.
look:save:complete Ein Look wurde bearbeitet und gespeichert.
look:delete:complete Ein Ordner 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 auf einer Dashboard-Kachel ein Dialogfeld mit den Optionen zum Bohren geöffnet und auf die Option Herunterladen geklickt.
drillmodal:explore Ein Nutzer hat in einem Dialogfeld zum Bohren auf die Option Erkunden von hier geklickt.
explore:ready Mit einem explorativen Analysetool wurden damit begonnen, Abfragedaten zu laden, unabhängig davon, ob die Abfrage ausgeführt wird oder nicht.
explore:run:start Eine explorative Datenanalyse hat begonnen, Abfragedaten zu laden, und die Abfrage wurde ausgeführt.
explore:run:complete Die Abfrage wird durch ein Explore-Objekt abgeschlossen.
explore:state:changed Die URL einer Seite „Erkunden“ hat sich aufgrund der Aktionen des Nutzers geändert.
page:changed Ein Nutzer hat im iFrame eine neue Seite aufgerufen.
page:properties:changed Die Höhe eines Dashboard-iFrames hat sich geändert.
session:tokens Zum Fortfahren sind für den Looker-Client Tokens erforderlich.
session:status Sendet Informationen über den Status einer Sitzung.
env:client:dialog Es wurde ein Dialogfeld geöffnet, das zum Teil nicht sichtbar ist, z. B. ein Dialogfeld zum Bohren. Mit diesem Ereignis kann die Hosting-Anwendung das Dialogfeld durchsehen.

Ereignistypreferenz

Mit dem eingebetteten iFrame können viele verschiedene Ereignistypen erstellt werden:

dashboard:loaded

In Dashboards, bei denen die Kacheln nicht auf „automatisch“ eingestellt sind, wird dieses Ereignis erstellt, nachdem ein Dashboard mit den zugehörigen Elementen geladen wurde, aber bevor Abfragen ausgeführt werden.


type: "dashboard:loaded",
status: "complete",
dashboard: {
  id: 1,
  title: "Business Pulse",
  canEdit: true,
  dashboard_filters: {
    "date": "Last 6 Years",
    "state": ""
  },
  absoluteUrl: "https://self-signed.looker.com:9999/embed/dashboards/1?embed_domain=https%3A%2F%2Fself-signed.looker.com%3A9999&date=Last+6+Years&state=",
  url: "/embed/dashboards/1?embed_domain=https%3A%2F%2Fself-signed.looker.com%3A9999&date=Last+6+Years&state=",
  options: {
    layouts: [
      {
        id: 1,
        dashboard_id: 1,
        type: "newspaper",
        active: true,
        column_width: null,
        width: null,
        deleted: false,
        dashboard_layout_components: [
          {
            id: 1,
            dashboard_layout_id: 1,
            dashboard_element_id: 1,
            row: 0,
            column: 0,
            width: 8,
            height: 4,
            deleted: false
          },
          {
            id: 2,
            dashboard_layout_id: 1,
            dashboard_element_id: 2,
            row: 0,
            column: 8,
            width: 8,
            height: 4,
            deleted: false
          }
        ]
      }
    ],
    elements: {
      1: {
        title: "Total Orders",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          font_size: "medium",
          title: "Total Orders"
        }
      },
      2: {
        title: "Average Order Profit",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          title: "Average Order Profit"
        }
      }
    }
  }
}
Attribut Format Beschreibung
status String Gibt an, ob das Dashboard und seine Elemente erfolgreich geladen wurden.
dashboard.id Zahl/String Die ID des Dashboards.
dashboard.title String Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit Boolesch 22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten.
dashboard.dashboard_filters Objekt Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.absoluteUrl String Vollständige Dashboard-URL.
dashboard.url String Die relative Dashboard-URL (nur der Pfad).
dashboard.options Objekt Die Attribute und Werte des Dashboard-Layouts, der Dashboard-Layoutkomponente und des Dashboard-Elements. Allen im Objekt options zurückgegebenen Attributen können über das Ereignis dashboard:options:set aktualisierte Werte zugewiesen werden.

dashboard:run:start

Dieses Ereignis wird erstellt, wenn ein Dashboard mit dem Laden begonnen hat, die entsprechenden Kacheln geladen werden und Daten abgefragt werden.

type: "dashboard:run:start",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
Attribut Format Beschreibung
dashboard.id Zahl/String Die ID des Dashboards.
dashboard.title String Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit Boolesch 22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten.
dashboard.url String Die relative Dashboard-URL (nur der Pfad).
dashboard.absoluteUrl String Vollständige Dashboard-URL.
dashboard.dashboard_filters Objekt Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}

dashboard:run:complete

Dieses Ereignis wird erstellt, wenn ein Dashboard abgeschlossen ist und alle Kacheln geladen und abgefragt wurden. Dieses Ereignis wird unabhängig davon erstellt, ob alle Kacheln erfolgreich geladen wurden oder nicht.

type: "dashboard:run:complete",
status: "complete",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://my.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
  options: {
    layouts: [
      {
        id: 1,
        dashboard_id: 1,
        type: "newspaper",
        active: true,
        column_width: null,
        width: null,
        deleted: false,
        dashboard_layout_components: [
          {
            id: 1,
            dashboard_layout_id: 1,
            dashboard_element_id: 1,
            row: 0,
            column: 0,
            width: 8,
            height: 4,
            deleted: false
          },
          {
            id: 2,
            dashboard_layout_id: 1,
            dashboard_element_id: 2,
            row: 0,
            column: 8,
            width: 8,
            height: 4,
            deleted: false
          }
        ]
      }
    ],
    elements: {
      1: {
        title: "Total Orders",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          font_size: "medium",
          title: "Total Orders"
        }
      },
      2: {
        title: "Average Order Profit",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          title: "Average Order Profit"
        }
      }
    }
  }
}
Attribut Format Beschreibung
status String Gibt an, ob das Dashboard und seine Elemente erfolgreich ausgeführt wurden. Wenn das Dashboard und seine Elemente erfolgreich ausgeführt wurden, gibt status den Wert "complete" und andernfalls status den Wert "error" zurück. Wenn das ausgeführte Dashboard über die Benutzeroberfläche oder mit der Aktion dashboard:stop beendet wurde, gibt status den Wert "stopped" zurück.
dashboard.id Zahl/String Die ID des Dashboards.
dashboard.title String Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit Boolesch 22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten.
dashboard.url String Die relative Dashboard-URL (nur der Pfad).
dashboard.absoluteUrl String Vollständige Dashboard-URL.
dashboard.dashboard_filters Objekt Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.options Objekt Die Attribute und Werte des Dashboard-Layouts, der Dashboard-Layoutkomponente und des Dashboard-Elements. Allen im options-Objekt zurückgegebenen Attributen können über die Aktion dashboard:options:set aktualisierte Werte zugewiesen werden.
dashboard.tileStatuses Objektarray Ein Array mit Objekten, die Kachelstatus bereitstellen. Objektattribute sind:
  • tileId: Die ID-Nummer der Kachel.
  • status: Wenn die Kachelabfrage erfolgreich ausgeführt wurde, gibt status "complete" zurück. Andernfalls gibt status "error" zurück.
  • errors: Wird ausgefüllt, wenn das Attribut status den Wert "error" hat. Ein Array von Objekten mit Details zum Fehler, einschließlich des Texts der Fehlermeldung, einer ausführlicheren Beschreibung des Fehlers und der SQL-Abfrage der Kachel, die den Fehler verursacht hat.

dashboard:download

Dieses Ereignis wird erstellt, wenn der Download eines Dashboards im PDF-Format gestartet wurde.

type: "dashboard:download",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
fileFormat: "pdf"
Attribut Format Beschreibung
dashboard.id Zahl/String Die ID des Dashboards.
dashboard.title String Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit Boolesch 22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten.
dashboard.url String Die relative Dashboard-URL (nur der Pfad).
dashboard.absoluteUrl String Vollständige Dashboard-URL.
dashboard.dashboard_filters Objekt Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
fileFormat String Das Format des heruntergeladenen Dashboards (derzeit nur "pdf").

dashboard:edit:start

22.20 ADDED Dieses Ereignis wird erstellt, wenn ein Dashboard in den Bearbeitungsmodus wechselt.

type: "dashboard:edit:start",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
Attribut Format Beschreibung
dashboard.id Zahl/String Die ID des Dashboards.
dashboard.title String Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit Boolesch 22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten.
dashboard.url String Die relative Dashboard-URL (nur der Pfad).
dashboard.absoluteUrl String Vollständige Dashboard-URL.
dashboard.dashboard_filters Objekt Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}

dashboard:edit:cancel

22.20 ADDED Dieses Ereignis wird erstellt, wenn ein Dashboard, das sich im Bearbeitungsmodus befindet, im Bearbeitungsmodus beendet wird, ohne zu speichern.

type: "dashboard:edit:cancel",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
Attribut Format Beschreibung
dashboard.id Zahl/String Die ID des Dashboards.
dashboard.title String Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit Boolesch 22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten.
dashboard.url String Die relative Dashboard-URL (nur der Pfad).
dashboard.absoluteUrl String Vollständige Dashboard-URL.
dashboard.dashboard_filters Objekt Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}

dashboard:save:complete

Dieses Ereignis wird erstellt, wenn ein Dashboard bearbeitet und dann gespeichert wird.

type: "dashboard:save:complete",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  url: "/embed/dashboards/...",
  options: {
    layouts: [
      {
        id: 1,
        dashboard_id: 1,
        type: "newspaper",
        active: true,
        column_width: null,
        width: null,
        deleted: false,
        dashboard_layout_components: [
          {
            id: 1,
            dashboard_layout_id: 1,
            dashboard_element_id: 1,
            row: 0,
            column: 0,
            width: 8,
            height: 4,
            deleted: false
          },
          {
            id: 2,
            dashboard_layout_id: 1,
            dashboard_element_id: 2,
            row: 0,
            column: 8,
            width: 8,
            height: 4,
            deleted: false
          }
        ]
      }
    ],
    elements: {
      1: {
        title: "Total Orders",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          font_size: "medium",
          title: "Total Orders"
        }
      },
      2: {
        title: "Average Order Profit",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          title: "Average Order Profit"
        }
      }
    }
  }
}
Attribut Format Beschreibung
dashboard.id Zahl/String Die ID des Dashboards.
dashboard.title String Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit Boolesch 22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten.
dashboard.dashboard_filters Objekt Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.absoluteUrl String Vollständige Dashboard-URL.
dashboard.url String Die relative Dashboard-URL (nur der Pfad).
dashboard.options Objekt Die Attribute und Werte des Dashboard-Layouts, der Dashboard-Layoutkomponente und des Dashboard-Elements. Allen im Objekt options zurückgegebenen Attributen können über das Ereignis dashboard:options:set aktualisierte Werte zugewiesen werden.

dashboard:delete:complete

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

type: "dashboard:delete:complete",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  url: "/embed/dashboards/...",
  options: {
    layouts: [
      {
        id: 1,
        dashboard_id: 1,
        type: "newspaper",
        active: true,
        column_width: null,
        width: null,
        deleted: false,
        dashboard_layout_components: [
          {
            id: 1,
            dashboard_layout_id: 1,
            dashboard_element_id: 1,
            row: 0,
            column: 0,
            width: 8,
            height: 4,
            deleted: false
          },
          {
            id: 2,
            dashboard_layout_id: 1,
            dashboard_element_id: 2,
            row: 0,
            column: 8,
            width: 8,
            height: 4,
            deleted: false
          }
        ]
      }
    ],
    elements: {
      1: {
        title: "Total Orders",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          font_size: "medium",
          title: "Total Orders"
        }
      },
      2: {
        title: "Average Order Profit",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          title: "Average Order Profit"
        }
      }
    }
  }
}
Attribut Format Beschreibung
dashboard.id Zahl/String Die ID des Dashboards.
dashboard.title String Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit Boolesch 22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten.
dashboard.dashboard_filters Objekt Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.absoluteUrl String Vollständige Dashboard-URL.
dashboard.url String Die relative Dashboard-URL (nur der Pfad).
dashboard.options Objekt Die Attribute und Werte des Dashboard-Layouts, der Dashboard-Layoutkomponente und des Dashboard-Elements. Allen im Objekt options zurückgegebenen Attributen können über das Ereignis dashboard:options:set aktualisierte Werte zugewiesen werden.

dashboard:tile:start

Dieses Ereignis wird erstellt, wenn eine Kachel mit dem Laden oder Abfragen von Daten beginnt.

type: "dashboard:tile:start",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
tile: {
  id: 123,
  title: "Quarterly Sales",
  listen: {
    "Date": "order.date",
    "Total Orders": "order.count"
  }
}
Attribut Format Beschreibung
dashboard.id Zahl/String Die ID des Dashboards, zu dem die Kachel gehört.
dashboard.title String Der Dashboard-Titel, wie oben im Dashboard angezeigt, zu dem die Kachel gehört.
dashboard.canEdit Boolesch 22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten.
dashboard.url String Die relative Dashboard-URL (nur der Pfad), zu der die Kachel gehört.
dashboard.absoluteUrl String Die vollständige Dashboard-URL, zu der die Kachel gehört.
dashboard.dashboard_filters Objekt Die Filter, die auf das Dashboard angewendet wurden, zu dem die Kachel gehört. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id Integer Die ID des Ereignisses, nicht die Kachel.
tile.title String Der Titel der Kachel wie oben angezeigt
tile.listen Objekt Das globale Dashboard filtert, welche Kachel überwacht wird. Dieses Objekt hat das Format {"Filter Label": "Filter Field", ...}

dashboard:tile:complete

Dieses Ereignis wird erstellt, wenn die Ausführung der Abfrage für eine Kachel abgeschlossen ist.

type: "dashboard:tile:complete",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
status: "complete",
truncated: false,
tile: {
  id: 123,
  title: "Quarterly Sales",
  listen: {
    "Date": "order.date",
    "Total Orders": "order.count"
  }
}
Attribut Format Beschreibung
dashboard.id Zahl/String Die ID des Dashboards, zu dem die Kachel gehört.
dashboard.title String Der Dashboard-Titel, wie oben im Dashboard angezeigt, zu dem die Kachel gehört.
dashboard.canEdit Boolesch 22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten.
dashboard.url String Die relative Dashboard-URL (nur der Pfad), zu der die Kachel gehört.
dashboard.absoluteUrl String Die vollständige Dashboard-URL, zu der die Kachel gehört.
dashboard.dashboard_filters Objekt Die Filter, die auf das Dashboard angewendet wurden, zu dem die Kachel gehört. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
status String Gibt an, ob die Kachelabfrage erfolgreich abgeschlossen wurde. Mögliche Werte sind "complete" und "error".
truncated Boolesch Gibt an, ob die Ergebnisse der Kachelabfrage abgeschnitten wurden, da die Abfrage mehr Zeilen zurückgegeben hat als das Limit der Abfragezeile. Das Zeilenlimit kann entweder ein benutzerdefiniertes Zeilenlimit oder das Looker-Standardzeilenlimit von 5.000 sein.
tile.id Integer Die ID des Ereignisses, nicht die Kachel.
tile.title String Der Titel der Kachel wie oben angezeigt
tile.listen Objekt Das globale Dashboard filtert, welche Kachel überwacht wird. Dieses Objekt hat das Format {"Filter Label": "Filter Field", ...}
tile.errors Objektarray Wird ausgefüllt, wenn das Attribut status den Wert "error" hat. Ein Array von Objekten mit Details zum Fehler, einschließlich des Texts der Fehlermeldung, einer ausführlicheren Beschreibung des Fehlers und der SQL-Abfrage der Kachel, die den Fehler verursacht hat.

dashboard:tile:download

Dieses Ereignis wird erstellt, sobald die Daten einer Kachel heruntergeladen werden.

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, wie oben im Dashboard angezeigt, zu dem die Kachel gehört.
dashboard.canEdit Boolesch 22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten.
dashboard.url String Die relative Dashboard-URL (nur der Pfad), zu der die Kachel gehört.
dashboard.absoluteUrl String Die vollständige Dashboard-URL, zu der die Kachel gehört.
dashboard.dashboard_filters Objekt Die Filter, die auf das Dashboard angewendet wurden, zu dem die Kachel gehört. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id Integer Die ID des Ereignisses, nicht die Kachel.
tile.title String Der Titel der Kachel wie oben angezeigt
tile.listen Objekt Das globale Dashboard filtert, welche Kachel überwacht wird. Dieses Objekt hat das Format {"Filter Label": "Filter Field", ...}
fileFormat String Das Format der heruntergeladenen Kachel (derzeit nur "pdf").

dashboard:tile:explore

Dieses Ereignis wird erstellt, wenn ein Nutzer in einer Dashboard-Kachel auf die Option Erkunden von hier 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 Explore, das angezeigt werden soll.
dashboard.id Zahl/String Die ID des Dashboards, zu dem die Kachel gehört.
dashboard.title String Der Dashboard-Titel, wie oben im Dashboard angezeigt, zu dem die Kachel gehört.
dashboard.canEdit Boolesch 22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten.
dashboard.url String Die relative Dashboard-URL (nur der Pfad), zu der die Kachel gehört.
dashboard.absoluteUrl String Die vollständige Dashboard-URL, zu der die Kachel gehört.
dashboard.dashboard_filters Objekt Die Filter, die auf das Dashboard angewendet wurden, zu dem die Kachel gehört. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id Integer Die ID des Ereignisses, nicht die Kachel.
tile.title String Der Titel der Kachel wie oben angezeigt
tile.listen Objekt Das globale Dashboard filtert, welche Kachel überwacht wird. Dieses Objekt hat das Format {"Filter Label": "Filter Field", ...}

dashboard:tile:view

Dieses Ereignis wird erstellt, wenn ein Nutzer in einer Dashboard-Kachel 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 sichtbaren Designs.
dashboard.id Zahl/String Die ID des Dashboards, zu dem die Kachel gehört.
dashboard.title String Der Dashboard-Titel, wie oben im Dashboard angezeigt, zu dem die Kachel gehört.
dashboard.canEdit Boolesch 22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten.
dashboard.url String Die relative Dashboard-URL (nur der Pfad), zu der die Kachel gehört.
dashboard.absoluteUrl String Die vollständige Dashboard-URL, zu der die Kachel gehört.
dashboard.dashboard_filters Objekt Die Filter, die auf das Dashboard angewendet wurden, zu dem die Kachel gehört. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id Integer Die ID des Ereignisses, nicht die Kachel.
tile.title String Der Titel der Kachel wie oben angezeigt
tile.listen Objekt Das globale Dashboard filtert, welche Kachel überwacht wird. Dieses Objekt hat das 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, wie oben im Dashboard angezeigt.
dashboard.canEdit Boolesch 22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten.
dashboard.url String Die relative Dashboard-URL (nur der Pfad).
dashboard.absoluteUrl String Vollständige Dashboard-URL.
dashboard.dashboard_filters Objekt Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.options Objekt Die Attribute und Werte des Dashboard-Layouts, der Dashboard-Layoutkomponente und des Dashboard-Elements. Allen im Objekt options zurückgegebenen Attributen können über das Ereignis dashboard:options:set aktualisierte Werte zugewiesen werden.

look:ready

Dieses Ereignis wird erstellt, wenn ein Look beginnt, Abfragedaten zu laden, 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 Vollständige Look-URL

look:run:start

Dieses Ereignis wird erstellt, wenn ein Look damit beginnt, Abfragedaten zu laden, und die Abfrage startet.

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 Vollständige Look-URL

look:run:complete

Dieses Ereignis wird erstellt, wenn ein Ausführen der Abfrage durch 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 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 das Design mit der Menüoption Speichern > In vorhandenem Dashboard oder Einstellungen bearbeiten gespeichert wird.

type: look:save:complete
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  spaceId: 123
  }
}
Attribut Format Beschreibung
look.url String Die relative Look-URL (nur der Pfad)
look.absoluteUrl String Vollständige Look-URL
look.spaceID Integer Die Ordner-ID, in der der Look gespeichert wird

look:delete:complete

Dieses Ereignis wird erstellt, wenn ein Look in den Papierkorb verschoben wird.

type: look:delete:complete
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  }
}
Attribut Format Beschreibung
look.url String Die relative Look-URL (nur der Pfad)
look.absoluteUrl String Vollständige Look-URL

drillmenu:click

Dieses Ereignis wird erstellt, wenn ein Nutzer in einem Dashboard, das mit dem LookML-Parameter link erstellt wurde, auf ein Aufschlüsselungsmenü klickt. Im folgenden LookML wird beispielsweise ein Aufschlüsselungsmenü erstellt, in dem ein Nutzer Daten aufrufen kann, 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 Filter state auf Illinois gesetzt ist, gibt das Ereignis drillmenu:click Folgendes an den Host des iFrames zurück:

type: "drillmenu:click",
label: "Filter by Illinois",
link_type: "url",
modal: false,
target: '_self',
url: "#filter::state=Illinois"
context: ' '
Attribut Format Beschreibung
label String Linklabel wie im Drilldown-Menü angezeigt
link_type String Der Objekttyp am Linkziel
modal Boolesch Ob das Dialogfeld für die Aufschlüsselung statt der Browsernavigation verwendet wird
target String Ist _self, wenn das Linkziel durch den Link-Ziel ersetzt wird, _blank, wenn das Linkziel in einem neuen Fenster geöffnet wird
url String Die URL des Linkziels
context String Internes Attribut, das von einigen Visualisierungstypen verwendet wird

Das Sandboxing des iFrames verhindert, dass Klicks auf das Drilldown-Menü in einem neuen Fenster geöffnet werden. Beachten Sie die folgenden Sandbox-Werte im iFrame-Tag:

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

drillmodal:download

Dieses Ereignis wird erstellt, wenn ein Nutzer ein Dialogfeld für die Aufschlüsselung über eine Dashboard-Kachel ö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, wie oben im Dashboard angezeigt, 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 Objekt Die Filter, die auf das Dashboard angewendet wurden, zu dem die Kachel gehört. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
drillExploreUrl String Die relative Explore-URL (nur der Pfad), die heruntergeladen werden soll.
fileFormat String Das Dateiformat des Datendownloads.

drillmodal:explore

Dieses Ereignis wird erstellt, wenn ein Nutzer in einem Drill Dialogfeld auf die Option Erkunden von hier klickt.

type: "drillmodal:explore",
label: "Explore From Here",
url: "/embed/explore/model/view..."
Attribut Format Beschreibung
label String Beschriftung der Schaltfläche, wie im Menü „Details“ angezeigt
url String Die relative Erkundungs-URL (nur der Pfad), die angezeigt werden soll

explore:ready

Dieses Ereignis wird erstellt, wenn ein Explore-Ereignis 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 zum Erkunden (nur der Pfad)
explore.absoluteUrl String Die vollständige URL zum Erkunden

explore:run:start

Dieses Ereignis wird erstellt, wenn das explorative Analysetool mit dem Laden von Abfragedaten beginnt und mit der Ausführung der Abfrage beginnt.

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 zum Erkunden (nur der Pfad)
explore.absoluteUrl String Die vollständige URL zum Erkunden

explore:run:complete

Dieses Ereignis wird erstellt, wenn die Abfrage in einer explorativen Datenanalyse abgeschlossen ist.

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 zum Erkunden (nur der Pfad)
explore.absoluteUrl String Die vollständige URL zum Erkunden

explore:state:changed

Dieses Ereignis wird erstellt, wenn sich die URL einer Seite „Erkunden“ aufgrund von Nutzeraktionen ändert.

type: "explore:state:changed",
explore: {
  url: "/embed/explore/...",
  absoluteUrl: "https://instance_name.looker.com/embed/explore/..."
}
Attribut Format Beschreibung
explore.url String Die relative URL zum Erkunden (nur der Pfad)
explore.absoluteUrl String Die vollständige URL zum Erkunden

page:changed

Dieses Ereignis wird erstellt, wenn ein Nutzer eine neue Seite im iFrame aufruft.

type: "page:changed",
page: {
  type: "dashboard",
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/..."
}
Attribut Format Beschreibung
page.type String Der Typ der Seite, die gerade aufgerufen wurde, z. B. "dashboard", "look" oder "explore"
page.url String Die relative URL (nur der Pfad) der Seite, die gerade aufgerufen wurde
page.absoluteUrl String Die vollständige URL der Seite, zu der gerade navigiert wurde

page:properties:changed

Dieses Ereignis wird erstellt, wenn sich die Höhe eines iFrame-Dashboards ändert. Sie ist nicht für „Ansehen“ oder „Erkunden“ verfügbar, weil ihre Höhe automatisch an die Größe des iFrames angepasst wird.

type: "page:properties:changed",
height: 1000
Attribut Format Beschreibung
height Integer Höhe des iFrame-Dashboards in Pixeln

session:tokens

Dieses Ereignis gibt an, dass für den Looker-Client Tokens erforderlich sind, um fortzufahren. Dieses Ereignis wird direkt beim Erstellen des iFrames und 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. 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 Nummer 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 Nicht enthalten, wenn die Sitzung abgelaufen ist.
api_token_ttl Nummer Gültigkeitsdauer des API-Tokens in Sekunden. Nicht enthalten, wenn die Sitzung abgelaufen ist.
navigation_token String Navigationstoken Nicht enthalten, wenn die Sitzung abgelaufen ist.
navigation_token_ttl Nummer Lebensdauer des Navigationstokens in Sekunden. Nicht enthalten, wenn die Sitzung abgelaufen ist.
session_references_token_ttl Nummer Sitzungsdauer in Sekunden. Der Wert ist 0, wenn die Sitzung abgelaufen ist. Zur Wiederherstellung muss die eingebettete Anwendung eine neue Sitzung erwerben.

session:status

Das Ereignis wird generiert, wenn die eingebettete Looker-Anwendung Anfragen für Sitzungstokens verarbeitet.

{
  "type": "session:status",
  "session_ttl": 0,
  "expired": true,
  "interrupted": false
}
Attribut Format Beschreibung
session_ttl Nummer Sitzungsdauer in Sekunden.
expired Boolesch Wenn true, ist die Sitzung abgelaufen.
interrupted Boolesch Wenn true, bedeutet das, dass eine Anfrage nach Sitzungstokens nicht beantwortet wurde. Dies kann darauf hindeuten, dass ein Server vorübergehend nicht verfügbar ist.
recoverable Boolesch true wird nur bei Unterbrechungen ausgefüllt. Gibt an, ob die Sitzung wiederhergestellt werden kann. Der Wert false bedeutet wahrscheinlich, dass ein Problem mit der eingebetteten Anwendung vorliegt.

env:client:dialog

Das Ereignis wird generiert, wenn ein Dialogfeld geöffnet wird, das teilweise nicht sichtbar ist, z. B. ein Drilling-Dialogfeld. Mit diesem Ereignis kann die Hosting-Anwendung das Dialogfeld mit der Aktion env:host:scroll 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 für die Aufschlüsselung unterstützt. Es können aber weitere Dialogfelder hinzugefügt werden. Möglicherweise wird oben im Dialogfeld das Infofeld des Darstellungsbereichs nicht angezeigt. Mit diesem Ereignis kann die Hostanwendung im oberen Bereich des Dialogfelds scrollen.
dialogType String Der Typ des Dialogfelds. Derzeit wird nur das Öffnen oder Schließen des Dialogfelds „Bohren“ dieses Ereignis ausgelöst.
placement String Die Position des Dialogfelds. Dialogfelder vom Typ „Bohrmaschine“ verwenden immer eine placement der Abdeckung.
open Boolesch Gibt an, ob das Dialogfeld geöffnet oder gescrollt wird.

Änderungen am iFrame vornehmen

Nachdem Sie den iFrame auf den Datenabruf vorbereitet haben, können Sie ihn folgendermaßen ändern:

  1. Verfassen Sie Ihre Anfrage im JSON-Format.
  2. Senden Sie die Anfrage an die Datei contentWindow des iFrames.

Anfrage im JSON-Format schreiben

Sie können mehrere Änderungen am iFrame vornehmen, die Sie dann im JSON-Formular einreichen. Die verfügbaren Optionen werden im Abschnitt Aktionsreferenz auf dieser Seite beschrieben. Vergessen Sie nicht, JSON.stringify zu verwenden, um Ihre Aktion in JSON umzuwandeln. Beispiel:

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

Anfrage in der contentWindow-Property des iFrames veröffentlichen

Zum Schluss senden Sie Ihre Nachricht an die contentWindow des iFrames:

var my_iframe = document.getElementById("my_iframe_id");

my_iframe.contentWindow.postMessage(my_request, 'https://instance_name.looker.com');

Tabelle mit der Aktionsübersicht

In der folgenden Tabelle werden Aktionen zusammengefasst. Klicken Sie auf eine Aktion, um Details dazu aufzurufen.

Aktion Aktionsbeschreibung
dashboard:load Lädt ein neues Dashboard im iFrame, das ein vorhandenes Dashboard ersetzt.
dashboard:run Führt das Dashboard im iFrame aus.
dashboard:edit 22.20 ADDED Das Dashboard wechselt in den Bearbeitungsmodus.
dashboard:filters:update Aktualisiert einen bestehenden Dashboard-Filter im iFrame
dashboard:options:set Neue Werte werden für das Dashboard-Layout und die Dashboard-Elementeigenschaften geschrieben.
dashboard:schedule_modal:open Der Planer wird geöffnet, sodass Nutzer Looker-Inhalte an verschiedene Ziele senden können.
dashboard:stop Beendet ein Dashboard, auf dem Daten ausgeführt werden oder neu geladen werden
look:run Führt den Look im iFrame aus.
look:filters:update Aktualisiert einen vorhandenen Look-Filter im iFrame
explore:run Führt das Explore im iFrame aus.
explore:filters:update Aktualisiert oder entfernt einen vorhandenen Explore-Filter im iFrame.
session:tokens:request Sendet Tokens als Reaktion auf ein session:tokens:request-Ereignis.
env:host:scroll Sendet Informationen über die aktuelle Scrollposition des Host-iFrames an die eingebettete Looker-Anwendung.

Aktionsreferenz

Folgende Aktionen können im eingebetteten iFrame gepostet werden:

dashboard:load

Verwenden Sie diese Aktion, um ein neues Dashboard im 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 wird angegeben, dass Sie ein neues Dashboard in den iFrame laden möchten.
id String Die ID des zu ladenden Dashboards.
pushHistory Boolesch Wenn true aktiviert ist, wird im Dashboard ein neuer Eintrag im Browserverlauf erstellt. 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 dorthin zurückzukehren.

dashboard:run

Führen Sie diese Aktion aus, um das Dashboard im iFrame auszuführen. Dies funktioniert genauso wie die Schaltfläche Ausführen oder Daten neu laden im Dashboard.

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

dashboard:edit

22.20 ADDED Verwenden Sie diese Aktion, um ein vorhandenes Dashboard im iFrame in den Bearbeitungsmodus zu wechseln. Dies entspricht der Auswahl von Dashboard bearbeiten im Dashboard-Menü.

{
  type: "dashboard:edit"
}
Attribut Format Beschreibung
type String Mit dem Typ dashboard:edit wird angegeben, dass Sie das Dashboard in den Bearbeitungsmodus wechseln möchten.

dashboard:filters:update

Mit dieser Aktion können Sie einen bestehenden 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 wird angegeben, dass Sie die vom Dashboard verwendeten Filter aktualisieren möchten.
filters Objekt Die neuen Filter, die Sie auf das Dashboard anwenden möchten. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}

dashboard:options:set

Diese Aktion ist verfügbar, sobald das Ereignis dashboard:run:complete eintritt.

Die Einbettung erstellt die Nachricht und sendet sie an den iFrame. Das Dashboard reagiert aber erst, nachdem dashboard:run:complete eingegangen ist. Die Aktion dashboard:options:set schreibt neue Werte in das Dashboard-Layout und die Dashboard-Elementeigenschaften. Nur Attribute, die im options-Attribut des dashboard:run:complete-Ereignisses zurückgegeben wurden, können mit dashboard:options:set aktualisiert werden. Alle festgelegten Attribute, 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 Mit dem Typ dashboard:options:set wird angegeben, dass Sie neue Werte in die Eigenschaften des Dashboard-Layouts und des Dashboard-Elements schreiben möchten.
layouts Objekt Die Dashboard-Layouteigenschaften, die vom options-Attribut im dashboard:run:complete-Ereignis zurückgegeben werden. Verwenden Sie dazu ein Format wie dieses:

id: "string",
dashboard_id: "string",
type: "newspaper",
active: boolean,
column_width: number,
width: number
layouts.dashboard_layout_components Objekt Mindestens ein Objekt der Dashboard-Layoutkomponente, das vom options-Attribut im dashboard:run:complete-Ereignis zurückgegeben wird. Verwenden Sie dazu ein Format wie dieses:

id: "string",
dashboard_layout_id: "string",
dashboard_element_id: "string",
row: number,
column: number,
width: number,
height: number,
deleted: boolean,
elements Objekt Mindestens ein Dashboard-Element, das im dashboard:run:complete-Ereignis vom Attribut options zurückgegeben wird. Verwenden Sie dazu ein Format wie dieses:

id: {
  title: "string"

dashboard:schedule_modal:open

Verwenden Sie diese Aktion, um den Scheduler zu öffnen, mit dem Nutzer Looker-Inhalte an verschiedene Ziele senden können.

{
  type: "dashboard:schedule_modal:open"
}
Attribut Format Beschreibung
type String Wenn Sie den Typ dashboard:schedule_modal:open verwenden, geben Sie an, dass Sie das Dialogfeld Planen öffnen möchten.

dashboard:stop

Mit dieser Aktion können Sie ein Dashboard beenden, auf dem Daten ausgeführt werden oder neu geladen werden. Dies funktioniert genauso wie das Klicken auf die Schaltfläche Abbrechen im Dashboard. Ein Dashboard, in dem dashboard:stop nicht mehr verwendet wird, sendet ein dashboard:run:complete-Ereignis, bei dem status: auf "stopped" festgelegt ist.

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

look:run

Führen Sie diese Aktion aus, um die Abfrage auszuführen, auf der der Look im iFrame basiert. Dies ähnelt dem Klicken auf die Schaltfläche Ausführen im Look, mit der Ausnahme, dass look:run immer die Datenbank direkt abfragt und keine Daten aus dem Looker-Cache abruft.

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

look:filters:update

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 Mit dem Typ look:filters:update wird angegeben, dass Sie die vom Look verwendeten Filter aktualisieren möchten.
filters Objekt Die neuen Filter, die Sie auf den Look anwenden möchten. Dieses Objekt hat das Format {"view_name.field_name_1": "value 1", "view_name.field_name_1": "value 2", ...}

explore:run

Führen Sie diese Aktion aus, um die Option „Erkunden“ im iFrame auszuführen. Dies ähnelt der Schaltfläche Ausführen auf dem Tab „Erkunden“ mit der Ausnahme, dass explore:run immer direkt die Datenbank abfragt und keine Daten aus dem Looker-Cache abruft.

{
  type: "explore:run"
}
Attribut Format Beschreibung
type String Wenn Sie den Typ explore:run verwenden, geben Sie an, dass Sie die Funktion „Erkunden“ ausführen möchten.

explore:filters:update

Mit dieser Aktion kannst du einen vorhandenen Explore-Filter im iFrame aktualisieren oder entfernen. Wenn Sie einen neuen Filter einschließen, der auf ein gültiges Feld verweist, wird er der Auswertung hinzugefügt.

{
  type: "explore:filters:update",
  filters: {
    "orders.created_at": "90 days",
    "orders.status": "complete"
  }
  deleteFilters:  ["products.department"]
}
Attribut Format Beschreibung
type String Wenn Sie den Typ explore:filters:update verwenden, möchten Sie die Filter auf dem Tab „Erkunden“ aktualisieren.
filters Objekt Die neuen Filter, die Sie auf das explorative Analysetool anwenden möchten. Wenn filters einen Filter enthält, der derzeit nicht in der explorativen Datenanalyse vorhanden ist, aber auf ein gültiges Feld verweist, wird er der Auswertung hinzugefügt. Dieses Objekt hat das Format {"view_name.field_name_1": "value 1", "view_name.field_name_1": "value 2", ...}
deleteFilters Array Die vorhandenen Filter, die Sie aus dem Tab „Erkunden“ 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 als Antwort auf eine session:tokens:request-Anfrage Tokens 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 werden Informationen zur aktuellen Scrollposition des Host-iFrames an die eingebettete Looker-Anwendung gesendet.

{
  type: "env:host:scroll",
  offsetTop: 10,
  offsetLeft: 10,
  scrollX: 5,
  scrollY: 5
}
Attribut Format Beschreibung
type String Mit dem Typ env:host:scroll wird angegeben, dass Informationen über die aktuelle Scrollposition des Host-iFrames an die eingebettete Looker-Anwendung gesendet werden sollen.
offsetTop Nummer Der Offset oben im iFrame.
offsetLeft Nummer Der Offset links des iFrames.
scrollX Nummer Die scrollX-Position des Anwendungshosts.
scrollY Nummer Die scrollY-Position des Anwendungshosts.