Incorporamento privato

Oltre all'incorporamento pubblico, puoi incorporare i Look, le esplorazioni e le dashboard in privato. Con l'incorporamento privato, puoi richiedere a un utente di eseguire l'autenticazione utilizzando credenziali di accesso a Looker, Google OAuth o OpenID Connect. Se un utente non è autenticato, puoi scegliere di mostrare un messaggio di errore o una schermata di accesso.

Gli utenti che hanno eseguito l'accesso e accedono a contenuti incorporati in privato sono soggetti alle impostazioni del pannello Amministrazione delle sessioni, che determinano per quanto tempo possono rimanere connessi, se possono accedere da più browser e se verranno disconnessi dopo un periodo di inattività.

Se hai bisogno di una soluzione di incorporamento più avanzata o personalizzabile, consulta la pagina della documentazione relativa all'incorporamento firmato.

Generazione di un URL incorporato

Per generare e copiare un URL di incorporamento privato per una dashboard, un look o una visualizzazione di esplorazione, seleziona Genera URL di incorporamento dal menu con tre puntini di una dashboard o dal menu a forma di ingranaggio dell'azione Esplora in un'esplorazione o un look.

La schermata Incorporamento privato include i seguenti elementi:

  1. Il campo URL contenuti mostra l'URL da incorporare privato completo.
  2. Il campo Applica tema all'URL della dashboard ti consente di selezionare un tema da aggiungere all'URL di incorporamento se stai generando una dashboard o un URL di incorporamento Esplora e nell'istanza sono abilitati i temi personalizzati. Il tema verrà applicato quando la dashboard incorporata o l'esplorazione vengono visualizzate.
  3. L'opzione Includi i parametri attuali nell'URL ti consente di scegliere se applicare i parametri attuali, ad esempio i valori del filtro, all'URL di incorporamento. Se attivati, questi parametri verranno applicati al momento della visualizzazione dei contenuti incorporati.
  4. Seleziona il pulsante Copia link per copiare l'URL di incorporamento completo negli appunti.

Dopo aver generato e copiato l'URL di incorporamento, puoi incollarlo in una nuova finestra o scheda del browser per visualizzare l'anteprima dei contenuti incorporati. Puoi utilizzare questo URL anche per incorporare i contenuti in un iframe.

Anteprima dei contenuti incorporati

Incolla l'URL incorporato nel browser per visualizzare l'anteprima del comportamento e dell'aspetto dei contenuti incorporati.

Visualizzazione dei contenuti incorporati in un iframe

Inserisci l'URL di incorporamento in un iframe. Ad esempio:

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

Quindi incorpora l'iframe come preferisci.

Modificare l'aspetto incorporato di una dashboard

La visualizzazione di una dashboard con /embed nell'URL mostra come verrà visualizzata la dashboard quando è incorporata.

Per impostazione predefinita, viene visualizzata una dashboard incorporata utilizzando il tema predefinito per la tua istanza Looker. Puoi modificare l'aspetto della dashboard incorporata in diversi modi, a seconda del tipo di dashboard che utilizzi:

  • Per qualsiasi tipo di dashboard, puoi specificare un nome del tema diverso nell'URL di incorporamento per modificare il tema utilizzato per visualizzare la dashboard.
  • Per qualsiasi tipo di dashboard, puoi utilizzare l'argomento URL _theme per modificare singoli elementi del tema della dashboard.
  • Per una dashboard LookML, puoi anche modificare l'aspetto incorporato di una dashboard tramite il parametro embed_style.

L'utilizzo dell'argomento URL theme, dell'opzione Modifica impostazioni di incorporamento o del parametro embed_style consente di apportare modifiche solo alla dashboard a cui viene applicato l'argomento, l'opzione o il parametro. Se vuoi personalizzare l'aspetto di più dashboard incorporate, utilizza un tema.

Alcune impostazioni di visualizzazione hanno la precedenza su altre. Per ulteriori informazioni, consulta la pagina della documentazione Creare e applicare temi per le dashboard e le esplorazioni incorporate.

Attivare la schermata di accesso per gli incorporamenti privati

Puoi aggiungere il parametro allow_login_screen=true all'URL di incorporamento se vuoi mostrare una schermata di accesso agli utenti che non hanno ancora eseguito l'accesso. Ad esempio:

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

Se non aggiungi questo parametro, agli utenti che non hanno ancora eseguito l'accesso verrà mostrato un errore 401.