Private Einbettung

Zusätzlich zum öffentlichen Einbetten können Sie Looks, Explores und Dashboards auch privat einbetten. Mit der privaten Einbettung können Sie festlegen, dass sich ein Nutzer über eine Looker-Anmeldung, Google OAuth oder OpenID Connect authentifizieren muss. Wenn ein Nutzer nicht authentifiziert ist, haben Sie die Möglichkeit, eine Fehlermeldung oder einen Anmeldebildschirm anzuzeigen.

Nutzer, die angemeldet sind und auf privat eingebettete Inhalte zugreifen, unterliegen den Einstellungen im Admin-Bereich . Darin wird festgelegt, wie lange sie angemeldet bleiben können, ob sie sich über mehrere Browser anmelden können und ob sie nach einer bestimmten Zeit der Inaktivität abgemeldet werden.

Wenn du eine erweiterte oder anpassbare eingebettete Lösung benötigst, lies unsere Dokumentationsseite zum Thema Signierte Einbettung.

Einbettungs-URL generieren

Um eine private Einbettungs-URL für ein Dashboard, einen Look oder eine Explore-Visualisierung zu generieren und zu kopieren, wählen Sie Einbettungs-URL abrufen aus dem Dreipunkt-Menü des Dashboards oder in einem Explore oder einem Look über das Zahnradmenü „Explore“ aus.

Der Bildschirm Private Einbettung enthält die folgenden Elemente:

  1. Im Feld Content-URL wird die vollständige private Einbettungs-URL angezeigt.
  2. Im Feld Design auf Dashboard-URL anwenden können Sie ein Design auswählen, das der Einbettungs-URL hinzugefügt werden soll, wenn Sie ein Dashboard oder eine Einbettungs-URL für Explores generieren und für Ihre Instanz benutzerdefinierte Designs aktiviert sind. Das Design wird angewendet, wenn das eingebettete Dashboard oder Explore aufgerufen wird.
  3. Mit dem Schalter Aktuelle Parameter in URL aufnehmen können Sie festlegen, ob aktuelle Parameter, z. B. Filterwerte, auf die Einbettungs-URL angewendet werden sollen. Wenn diese Option aktiviert ist, werden diese Parameter angewendet, wenn der eingebettete Inhalt angesehen wird.
  4. Klicken Sie auf die Schaltfläche Copy Link (Link kopieren), um die vollständige Einbettungs-URL in die Zwischenablage zu kopieren.

Nachdem Sie die Einbettungs-URL erstellt und kopiert haben, können Sie sie in ein neues Browserfenster oder einen neuen Tab einfügen, um den eingebetteten Inhalt in der Vorschau anzuzeigen. Sie können diese URL auch verwenden, um den Inhalt in einen iFrame einzubetten.

Vorschau des eingebetteten Inhalts

Fügen Sie die Einbettungs-URL in Ihren Browser ein, um eine Vorschau des Verhaltens und der Darstellung des eingebetteten Inhalts zu sehen.

Eingebetteten Inhalt in einem iFrame ansehen

Platzieren Sie die Einbettungs-URL in einem iFrame. Beispiel:

  <iframe
      src="https://instance_name.cloud.looker.com/embed/dashboards/1"
      width="1000"
      height="2000"
      frameborder="0">
  </iframe>

Betten Sie dann den iFrame nach Bedarf ein.

Darstellung der Einbettung eines Dashboards ändern

Wenn Sie sich ein Dashboard mit /embed in der URL ansehen, sehen Sie, wie das Dashboard nach der Einbettung angezeigt wird.

Standardmäßig wird ein eingebettetes Dashboard mit dem Standarddesign der Looker-Instanz angezeigt. Sie können die Darstellung des eingebetteten Dashboards je nach Typ des verwendeten Dashboards auf mehrere Arten ändern:

  • Sie können für jede Art von Dashboard in der Einbettungs-URL einen anderen Designnamen angeben, um das Design des Dashboards zu ändern.
  • Bei jeder Art von Dashboard können Sie das URL-Argument _theme verwenden, um einzelne Dashboard-Designelemente zu ändern.
  • Bei einem LookML-Dashboard können Sie die eingebettete Darstellung eines Dashboards auch über den Parameter embed_style ändern.

Mit dem URL-Argument theme, der Option Edit Embed Settings (Einbettungseinstellungen bearbeiten) oder dem Parameter embed_style werden nur Änderungen am Dashboard vorgenommen, auf das das Argument, die Option oder der Parameter angewendet wird. Wenn Sie die Darstellung mehrerer eingebetteter Dashboards anpassen möchten, verwenden Sie stattdessen ein Design.

Einige Anzeigeeinstellungen setzen andere außer Kraft. Weitere Informationen finden Sie auf der Seite Themen für eingebettete Dashboards und Explores erstellen und anwenden.

Anmeldebildschirm für private Einbettungen aktivieren

Sie können Ihrer Einbettungs-URL den Parameter allow_login_screen=true hinzufügen, wenn Nutzer, die sich noch nicht angemeldet haben, einen Anmeldebildschirm anzeigen möchten. Beispiel:

<iframe src="https://instance_name.cloud.looker.com/embed/looks/4?allow_login_screen=true"></iframe>
                                                            ^^^^^^^^^^^^^^^^^^^^^^^

Wenn Sie diesen Parameter nicht hinzufügen, wird Benutzern, die noch nicht angemeldet sind, die Fehlermeldung 401 angezeigt.