Iniziare a utilizzare l'incorporamento privato

In questa pagina viene spiegato come configurare l'incorporamento privato. L'opzione di incorporamento privato richiede che tu gestisca l'elemento HTML <iframe> direttamente per incorporare i tuoi contenuti Looker e richiede che l'utente acceda a Looker separatamente dall'applicazione host.

Esaminiamo questo esempio di codice di incorporamento privato:

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

1. Creare l'URL dei contenuti da incorporare

Vediamo un esempio dei contenuti Looker all'URL https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day. A partire da questo URL di contenuti Looker, creeremo l'URL per l'incorporamento dei contenuti e vi imposteremo l'attributo src dell'iframe. Puoi utilizzare il tuo URL di contenuti Looker durante questa procedura.

L'URL dei contenuti di incorporamento dall'esempio di codice riportato sopra è:

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

L'URL dei contenuti incorporati è composto da tre parti:

  • Nome host: il nome host dell'istanza di Looker.
  • Percorso: percorso dell'URL dei contenuti di Looker preceduto dal prefisso /embed (con passaggi aggiuntivi per le visualizzazioni della query)
  • Parametri: parametri URL che specificano filtri e temi

Il protocollo deve essere sempre https://. Costruiamo ogni parte nel dettaglio.

Parte 1: nome host

  1. Vai ai contenuti di Looker. Segue l'URL del contenuto Looker di esempio: https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day.
  2. Il nome host dell'URL dei contenuti incorporati è instance.looker.com.

Parte 2: percorso

Il percorso dell'URL dei contenuti incorporati dipende dai contenuti di Looker che incorpori.

Incorporamento di tutti i contenuti Looker, ad eccezione delle visualizzazioni di query

  1. Vai ai contenuti di Looker. Segue l'URL di contenuti di esempio di Looker: https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day
  2. Identifica il percorso dell'URL del tuo contenuto di Looker: /dashboards/4.
  3. Fai precedere il percorso /embed dell'URL dei contenuti di Looker. Il percorso dell'URL dei contenuti di incorporamento è /embed/dashboards/4.

Incorporare una visualizzazione della query

  1. Vai alla visualizzazione della query. URL di esempio: instance.looker.com/explore/my_model/my_explore?qid=1234567890abcdefghij12
  2. Identifica il tuo ID client di query. Il parametro qid: 1234567890abcdefghij12 è l'ID client della tua query che rappresenta la query e le impostazioni di visualizzazione.
  3. Il percorso dell'URL dei contenuti di incorporamento è /embed/query-visualization/ aggiunto al tuo ID client di query. Il percorso dell'URL del contenuto di esempio è /embed/query-visualization/1234567890abcdefghij12

Parte 3: parametri

I parametri URL dei contenuti incorporati controllano i filtri e i temi dei contenuti incorporati.

Filtri

  1. Vai all'URL dei contenuti di Looker.
  2. Regola manualmente i filtri dei contenuti in base alle tue preferenze. In questo esempio, l'URL dei contenuti Looker risultante è: https://instance.looker.com/dashboards/4?Timeframe=14+day
  3. I parametri dell'URL dei contenuti di incorporamento sono quelli dell'URL dei contenuti di Looker, ad esempio Timeframe=14+day

In questo esempio, il parametro Timeframe=14+day imposta il valore del filtro Timeframe della dashboard.

Applicazione tema

Consulta la guida ai temi per scoprire come controllare l'aspetto dei tuoi contenuti incorporati.

2. Testa l'URL dei contenuti incorporati

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

3. Creare l'iframe

  1. Crea l'elemento iframe nell'applicazione host.
  2. Imposta l'attributo src sull'URL del contenuto da incorporare.
  3. Definisci gli attributi width, height e altri attributi in base a ciò di cui hai bisogno per visualizzare al meglio i contenuti di Looker incorporati.

4. Valutare i problemi di accesso degli utenti

L'utente deve aver eseguito l'accesso a Looker per visualizzare i contenuti incorporati. L'iframe mostra una pagina di errore 401 se l'utente non ha eseguito l'accesso.

Opzioni di accesso utente

L'utente può accedere a Looker in due modi:

1. Accedi a Looker in anticipo

L'utente deve accedere a Looker sullo stesso browser prima di poter visualizzare i contenuti incorporati.

2. Attiva una schermata di accesso di Looker incorporabile facoltativa

Aggiungi allow_login_screen=true ai parametri URL di incorporamento dei contenuti per presentare una schermata di accesso a Looker nell'iframe se l'utente non ha eseguito l'accesso. Il nostro URL di contenuti di esempio diventa: https://instance_name.looker.com/embed/dashboards/4?Timeframe=14+day&allow_login_screen=true.

Ricorda due aspetti:

Looker utilizza i cookie per l'autenticazione degli utenti e l'archiviazione delle sessioni. Il browser dell'utente deve abilitare i cookie di terze parti se l'utente accede al nome host dell'URL del contenuto di incorporamento della tua istanza di Looker in un dominio diverso da quello dell'applicazione host.

Alcuni browser, come Firefox e Safari, utilizzano per impostazione predefinita norme relative ai cookie che bloccano i cookie di terze parti. Se il browser dell'utente non consente i cookie di terze parti, puoi aggiungere un dominio personalizzato all'istanza di Looker in modo che l'applicazione host e l'istanza del nome host dell'URL dei contenuti si trovino nello stesso dominio.

5. Interagire con l'iframe

Inizia a utilizzare l'incorporamento dei messaggi di post iframe di Looker.

Passaggi successivi

Inizia a utilizzare l'incorporamento SSO utilizzando il nostro SDK per l'incorporamento e guarda alcuni esempi di ciò che puoi fare con l'incorporamento con Looker.