Erste Schritte mit dem privaten Einbetten

Auf dieser Seite wird Schritt für Schritt erklärt, wie Sie private Einbettungen einrichten. Bei der Option zum privaten Einbetten müssen Sie das HTML-Element <iframe> direkt verwalten, um Ihren Looker-Content einzubetten. Außerdem muss der Nutzer sich getrennt von der Hostanwendung in Looker anmelden.

Hier ein Beispiel für einen privaten Einbettungscode:

<iframe
    src="https://instance.looker.com/embed/dashboards/4?Timeframe=14+day"
    width="600"
    height="300"
    frameborder="0">
</iframe>

1. URL für das Einbetten von Inhalten erstellen

Nehmen wir ein Beispiel für Looker-Inhalte unter der URL https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day. Anhand dieser Looker-Content-URL wird die Einbettungs-Content-URL erstellt und das Attribut src des iFrames festgelegt. Sie können gerne Ihre eigene Looker-Inhalts-URL verwenden, wenn Sie diese Schritte ausführen.

Die URL zum Einbetten von Inhalten aus dem obigen Codebeispiel sieht so aus:

https://instance.looker.com/Embed/dashboards/4?theme=red&Timeframe=14+day

Die Einbettungs-URL besteht aus drei Teilen:

  • Hostname: Hostname Ihrer Looker-Instanz
  • Pfad: URL-Pfad des Looker-Inhalts mit dem Präfix /embed (mit zusätzlichen Schritten für Abfragevisualisierungen)
  • Parameter: URL-Parameter, mit denen Filter und Thema angegeben werden

Das Protokoll muss immer https:// sein. Sehen wir uns die einzelnen Teile im Detail an.

Teil 1: Hostname

  1. Rufen Sie die Looker-Inhalte auf. Beispiel für die Looker-Inhalts-URL: https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day.
  2. Der Hostname der eingebetteten Inhalts-URL lautet instance.looker.com.

Teil 2: Pfad

Der URL-Pfad für die eingebetteten Inhalte hängt vom Looker-Content ab, den Sie einbetten.

Alle Looker-Inhalte mit Ausnahme von Abfragevisualisierungen einbetten

  1. Rufen Sie die Looker-Inhalte auf. Beispiel für die Looker-Inhalts-URL: https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day
  2. Ermitteln Sie den Pfad der Looker-Content-URL: /dashboards/4.
  3. Stellen Sie dem Pfad Ihrer Looker-Content-URL /embed voran. Der Pfad deiner eingebetteten Inhalts-URL lautet /embed/dashboards/4.

Abfragevisualisierung einbetten

  1. Rufen Sie die Abfragevisualisierung auf. Beispiel-URL: instance.looker.com/explore/my_model/my_explore?qid=1234567890abcdefghij12
  2. Ermitteln Sie die Abfrage-Client-ID. Der Parameter qid: 1234567890abcdefghij12 ist die Client-ID Ihrer Abfrage, die die Abfrage und die Visualisierungseinstellungen darstellt.
  3. An den Pfad der eingebetteten Content-URL wird /embed/query-visualization/ durch Ihre Abfrage-Client-ID angehängt. Der Pfad der Beispiel-Einbettungs-Content-URL ist /embed/query-visualization/1234567890abcdefghij12

Teil 3: Parameter

Die Parameter und URLs der eingebetteten Inhalte werden über die URL-Parameter für eingebettete Inhalte gesteuert.

Filter

  1. Rufen Sie die Looker-Inhalts-URL auf.
  2. Passen Sie die Filter der Inhalte manuell an. In diesem Beispiel lautet die resultierende URL zu Looker: https://instance.looker.com/dashboards/4?Timeframe=14+day
  3. Die URL-Parameter für die eingebetteten Inhalte sind die URL-Parameter für Looker-Inhalte, z. B. Timeframe=14+day.

In diesem Beispiel wird durch den Parameter Timeframe=14+day der Wert des Dashboards Timeframe festgelegt.

Designs

In diesem englischsprachigen Leitfaden erfahren Sie, wie Sie die Darstellung Ihrer eingebetteten Inhalte steuern können.

2. URL des eingebetteten Inhalts testen

Öffnen Sie die URL Ihrer eingebetteten Inhalte in Ihrem Browser, um eine Vorschau des Verhaltens und der Darstellung der Inhalte zu sehen.

3. iFrame erstellen

  1. Erstellen Sie das iFrame-Element in Ihrer Hostanwendung.
  2. Legen Sie für das Attribut src die URL Ihrer eingebetteten Inhalte fest.
  3. Definieren Sie width, height und andere Attribute, die erforderlich sind, um Ihren eingebetteten Looker-Content bestmöglich darzustellen.

4. Probleme mit dem Nutzerzugriff berücksichtigen

Der Nutzer muss in Looker angemeldet sein, um sich Ihre eingebetteten Inhalte ansehen zu können. Wenn der Nutzer nicht angemeldet ist, zeigt der iFrame eine 401-Fehlerseite an.

Anmeldeoptionen für Nutzer

Nutzer können sich auf zwei Arten in Looker anmelden:

1. Vorher in Looker anmelden

Der Nutzer muss sich im selben Browser in Looker anmelden, bevor er den eingebetteten Inhalt sehen kann.

2. Optionalen Looker-Anmeldebildschirm für Einbettung aktivieren

Fügen Sie den URL-Parametern für eingebettete Inhalte allow_login_screen=true hinzu, um einen Looker-Anmeldebildschirm im iFrame anzuzeigen, wenn der Nutzer nicht angemeldet ist. Unsere Beispiel-URL für eingebettete Inhalte lautet: https://instance_name.looker.com/embed/dashboards/4?Timeframe=14+day&allow_login_screen=true.

Dabei ist Folgendes zu beachten:

  • Sie müssen die Same-Origin Protection für Looker-Anmeldeseiten deaktivieren, damit der Looker-Anmeldebildschirm in den iFrame eingebettet wird.
  • Wenn Ihre Looker-Instanz Nutzer über die Einmalanmeldung (SSO) bei einem Identitätsanbieter authentifiziert, blockiert Ihr Identitätsanbieter möglicherweise den Anmeldebildschirm in Ihrem iFrame. In diesem Fall müssen Sie Option 1 verwenden.

Looker verwendet Cookies zur Nutzerauthentifizierung und zum Sitzungsspeicher. Der Browser Ihres Nutzers muss Drittanbieter-Cookies aktivieren, wenn Ihr Nutzer auf den Hostnamen Ihrer Looker-Instanz, der eine eingebettete URL enthält, unter einer anderen Domain als Ihre Hostanwendung zugreift.

Einige Browser wie Firefox und Safari verwenden standardmäßig eine Cookierichtlinie, die Drittanbieter-Cookies blockiert. Wenn im Browser des Nutzers keine Drittanbieter-Cookies zugelassen sind, können Sie Ihrer Looker-Instanz eine benutzerdefinierte Domain hinzufügen, damit Ihre Hostanwendung und die Hostname-URL des Inhalts-URLs in derselben Domain gespeichert sind.

5. Mit dem iFrame interagieren

Weitere Informationen

Nächste Schritte

Erste Schritte mit der SSO-Einbettung mit unserem Embed SDK und Beispiele für die Looker-Einbettung