Iniziare a utilizzare l'embedding privato

Questa pagina ti guiderà nella configurazione dell'incorporamento privato. L'opzione di incorporamento privato richiede di gestire direttamente l'elemento HTML <iframe> per incorporare i contenuti di Looker e che l'utente acceda a Looker separatamente dall'applicazione host.

Esamineremo 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. Crea l'URL dei contenuti incorporati

Considera un esempio di contenuti di Looker all'URL https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day. Da questo URL dei contenuti di Looker, creeremo l'URL dei contenuti incorporati e imposteremo l'attributo src dell'iframe. Puoi utilizzare il tuo URL dei contenuti di Looker mentre segui questi passaggi.

L'URL dei contenuti incorporati dell'esempio di codice precedente è il seguente:

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 Looker
  • Percorso: percorso dell'URL dei contenuti di Looker con il prefisso /embed (con passaggi aggiuntivi per le visualizzazioni di query)
  • Parametri: parametri URL che specificano filtri e temi

Il protocollo deve essere sempre https://. Creiamo ogni parte in dettaglio.

Parte 1: nome host

  1. Vai ai contenuti di Looker. Seguendo l'esempio di URL dei contenuti di Looker: 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.

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

  1. Vai ai contenuti di Looker. Seguendo l'esempio di URL dei contenuti di Looker: https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day
  2. Identifica il percorso dell'URL dei contenuti di Looker: /dashboards/4.
  3. Aggiungi il prefisso /embed al percorso dell'URL dei contenuti di Looker. Il percorso dell'URL dei contenuti incorporati è /embed/dashboards/4.

Incorporare una visualizzazione di query

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

Parte 3: parametri

I parametri dell'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 esigenze. In questo esempio, l'URL dei contenuti di Looker risultante è: https://instance.looker.com/dashboards/4?Timeframe=14+day
  3. I parametri dell'URL dei contenuti incorporati sono i parametri 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.

Temi

Consulta la guida ai temi per scoprire come controllare l'aspetto dei 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. Crea l'iframe

  1. Crea l'elemento iframe nell'applicazione host.
  2. Imposta l'attributo src sull'URL dei contenuti incorporati.
  3. Definisci width, height e altri attributi in base alle tue esigenze per visualizzare al meglio i contenuti di Looker incorporati.

4. Considera i problemi di accesso degli utenti

L'utente deve aver eseguito l'accesso a Looker per visualizzare i contenuti incorporati. L'iframe mostrerà 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 nello stesso browser prima di poter visualizzare i contenuti incorporati.

2. Attiva una schermata di accesso a Looker incorporata facoltativa

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

Tieni presente due avvertenze:

Looker utilizza i cookie per l'autenticazione degli utenti e l'archiviazione delle sessioni. Il browser dell'utente deve attivare i cookie di terze parti se l'utente accede al nome host dell'URL dei contenuti incorporati dell'istanza Looker in un dominio diverso da quello dell'applicazione host.

Alcuni browser, come Firefox e Safari, utilizzano per impostazione predefinita un criterio sui cookie che blocca i cookie di terze parti. Se il browser dell'utente non può consentire i cookie di terze parti, puoi aggiungere un dominio personalizzato all'istanza Looker in modo che l'applicazione host e il nome host dell'URL dei contenuti incorporati dell'istanza Looker risiedano nello stesso dominio.

5. Interagisci con l'iframe

Inizia a utilizzare la messaggistica post iframe di incorporamento di Looker.

Passaggi successivi

Inizia a utilizzare l'incorporamento firmato con l'SDK Embed e consulta gli esempi di cosa puoi fare con l'incorporamento di Looker.