Oltre all'incorporamento pubblico, puoi anche incorporare privatamente Look, esplorazioni e dashboard in modo privato, in modo da richiedere l'autenticazione utilizzando i dati di accesso di Looker, Google OAuth o OpenID Connect. Se un utente non è autenticato, puoi mostrare un messaggio di errore o visualizzare una schermata di accesso.
Gli utenti che hanno eseguito l'accesso e che hanno accesso a contenuti incorporati privati sono soggetti alle impostazioni impostate nel riquadro Sessioni Amministrazione, che determinano per quanto tempo possono rimanere collegati, se sono in grado di accedere da più browser e se vengono disconnessi dopo un periodo di inattività.
Se hai bisogno di una soluzione incorporata più avanzata o personalizzabile, consulta la pagina della documentazione relativa all'incorporamento con Single Sign-On (SSO).
Generare un URL di incorporamento
Per generare e copiare un URL per l'incorporamento privato per una dashboard, per una visualizzazione o una visualizzazione Esplora, seleziona Ottieni URL di incorporamento da un menu con tre puntini della dashboard o dal menu a forma di ingranaggio dell'azione Esplora su un esplorazione o un look. Looker mostrerà la finestra URL di incorporamento.
La finestra Ottieni URL di incorporamento include i seguenti elementi:
- Il campo URL per l'incorporamento mostra l'URL completo dell'incorporamento privato.
- Il campo Applica tema all'URL della dashboard consente di selezionare un tema da aggiungere all'URL di incorporamento se stai generando una dashboard o un URL di incorporamento Esplora e se la tua istanza ha i temi personalizzati abilitati. Il tema verrà applicato quando viene visualizzata la dashboard incorporata o la funzionalità Esplora.
- L'opzione Includi parametri attuali nell'URL ti consente di scegliere se applicare i parametri correnti, ad esempio i valori del filtro, all'URL per l'incorporamento. Se attivi questa opzione, questi parametri verranno applicati quando i contenuti incorporati vengono visualizzati.
- Fai clic sul pulsante Copia link per copiare l'URL di incorporamento completo negli appunti.
Dopo aver generato e copiato l'URL per l'incorporamento, puoi incollare l'URL 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 per l'incorporamento nel browser per visualizzare l'anteprima del comportamento e dell'aspetto dei contenuti incorporati.
Visualizzare i contenuti incorporati in un iframe
Inserisci l'URL per l'incorporamento in un iframe. Ecco alcuni esempi:
<iframe
src="https://instance_name.cloud.looker.com/embed/dashboards/1"
width="1000"
height="2000"
frameborder="0">
</iframe>
Poi incorpora l'iframe come preferisci.
Modificare l'aspetto incorporato di una dashboard
Se visualizzi una dashboard con /embed
nell'URL, visualizzerai l'aspetto della dashboard quando è incorporata.
Per impostazione predefinita, una dashboard incorporata viene visualizzata utilizzando il tema predefinito per l'istanza di Looker. Puoi modificare l'aspetto della tua dashboard incorporata in diversi modi, a seconda del tipo di dashboard che stai utilizzando:
- Per qualsiasi tipo di dashboard, puoi specificare un nome diverso per il tema nell'URL di incorporamento per modificare il tema utilizzato per visualizzarla.
- 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
.
Utilizzando l'argomento URL theme
, l'opzione Modifica impostazioni di incorporamento o il parametro embed_style
apporta 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 saperne di più, consulta la pagina della documentazione Creare e applicare temi per dashboard incorporate ed esplorazioni.
Attiva la schermata di accesso per gli incorporamenti privati
Puoi aggiungere il parametro allow_login_screen=true
al tuo URL di incorporamento se vuoi mostrare una schermata di accesso agli utenti che non hanno ancora eseguito l'accesso. Ecco alcuni esempi:
<iframe src="https://instance_name.cloud.looker.com/embed/looks/4?allow_login_screen=true"></iframe>
^^^^^^^^^^^^^^^^^^^^^^^
Se non aggiungi questo parametro, verrà visualizzato un errore 401 agli utenti che non hanno ancora eseguito l'accesso.