Erste Schritte mit dem privaten Einbetten

Auf dieser Seite wird beschrieben, wie Sie die private Einbettung einrichten. Bei der privaten Einbettung müssen Sie das HTML-Element <iframe> direkt verwalten, um Ihre Looker-Inhalte einzubetten. Außerdem muss sich der Nutzer separat von der gehosteten Anwendung in Looker anmelden.

Wir gehen dieses Codebeispiel für die private Einbettung durch:

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

1. URL für eingebettete Inhalte erstellen

Betrachten wir ein Beispiel für Looker-Inhalte unter der URL https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day. Aus dieser Looker-Inhalts-URL erstellen wir die URL für eingebettete Inhalte und legen das Attribut src des iFrames darauf fest. Sie können die URL Ihrer eigenen Looker-Inhalte verwenden, während Sie diese Schritte ausführen.

Die URL für eingebettete Inhalte aus dem vorherigen Codebeispiel lautet:

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

Die URL für eingebettete Inhalte 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, die Filter und Designs angeben

Das Protokoll muss immer https:// sein. In diesem Beispiel wird jeder Teil im Detail erstellt.

Teil 1: Hostname

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

Teil 2: Pfad

Der URL-Pfad für eingebettete Inhalte hängt von den Looker-Inhalten ab, die Sie einbetten.

Einbetten aller Looker-Inhalte mit Ausnahme von Abfragevisualisierungen

  1. Rufen Sie Ihre Looker-Inhalte auf. Beispiel für eine Looker-Inhalts-URL: https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day
  2. Ermitteln Sie den Pfad der URL Ihres Looker-Inhalts: /dashboards/4.
  3. Stellen Sie dem Pfad der URL Ihrer Looker-Inhalte das Präfix /embed voran. Der Pfad der URL des eingebetteten Inhalts 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 Client-ID für die Abfrage. Der Parameter qid: 1234567890abcdefghij12 ist die Client-ID Ihrer Abfrage, die die Abfrage und die Visualisierungseinstellungen darstellt.
  3. Der URL-Pfad für eingebettete Inhalte lautet /embed/query-visualization/, angehängt an die Client-ID Ihrer Abfrage. Der Pfad der Beispiel-URL für eingebettete Inhalte lautet /embed/query-visualization/1234567890abcdefghij12.

Teil 3: Parameter

Mit den URL-Parametern für eingebettete Inhalte steuern Sie die Filter und das Design Ihrer eingebetteten Inhalte.

Filter

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

In diesem Beispiel legt der Parameter Timeframe=14+day den Wert des Filters Timeframe des Dashboards fest.

Thematische Anzeigengruppen

Im Leitfaden zu Designs erfahren Sie, wie Sie das Erscheinungsbild Ihrer eingebetteten Inhalte steuern können.

2. URL für eingebettete Inhalte testen

Öffnen Sie die URL des eingebetteten Inhalts in Ihrem Browser, um eine Vorschau des Verhaltens und des Erscheinungsbilds des eingebetteten Inhalts zu sehen.

3. IFrame erstellen

  1. Erstellen Sie das iFrame-Element in Ihrer Hostanwendung.
  2. Legen Sie für das Attribut src die URL des eingebetteten Inhalts fest.
  3. Legen Sie die Attribute width, height und andere Attribute so fest, dass Ihre eingebetteten Looker-Inhalte optimal angezeigt werden.

4. Probleme mit dem Nutzerzugriff berücksichtigen

Der Nutzer muss in Looker angemeldet sein, um Ihre eingebetteten Inhalte zu sehen. Wenn der Nutzer nicht angemeldet ist, wird im iFrame eine 401-Fehlerseite angezeigt.

Anmeldeoptionen für Nutzer

Der Nutzer kann sich auf zwei Arten in Looker anmelden:

1. Melden Sie sich vorher in Looker an.

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

2. Optionalen Looker-Anmeldebildschirm für Einbettungen aktivieren

Fügen Sie den URL-Parametern für eingebettete Inhalte allow_login_screen=true hinzu, damit im iFrame ein Looker-Anmeldebildschirm angezeigt wird, wenn der Nutzer nicht angemeldet ist. Die URL für die eingebetteten Inhalte aus unserem Beispiel 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-Schutzmaßnahmen für Looker-Anmeldeseiten deaktivieren, um den Looker-Anmeldebildschirm in der iFrame-Einbettung zu aktivieren.
  • Wenn Ihre Looker-Instanz Nutzer über die Einmalanmeldung (SSO) mit 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 für die Nutzerauthentifizierung und die Sitzungsspeicherung. Im Browser des Nutzers müssen Drittanbieter-Cookies aktiviert sein, wenn der Hostname der URL für eingebettete Inhalte Ihrer Looker-Instanz zu einer anderen Domain gehört als Ihre gehostete Anwendung.

In einigen Browsern wie Firefox und Safari werden Drittanbieter-Cookies standardmäßig blockiert. Wenn der Browser des Nutzers keine Drittanbieter-Cookies zulässt, können Sie Ihrer Looker-Instanz eine benutzerdefinierte Domain hinzufügen, damit sich die gehostete Anwendung und der Hostname der URL für eingebettete Inhalte der Looker-Instanz in derselben Domain befinden.

5. Mit dem iFrame interagieren

Erste Schritte mit Post-Messaging für eingebettete Looker-iFrames

Nächste Schritte

Hier finden Sie Informationen zur signierten Einbettung mit unserem Embed SDK und Beispiele für die Möglichkeiten, die Ihnen die Einbettung von Looker bietet.