Inizia a utilizzare l'incorporamento privato

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

Analizzeremo 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. Mentre esegui questi passaggi, ti invitiamo a utilizzare il tuo URL di contenuti Looker.

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

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

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

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

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

Parte 1: nome host

  1. Vai ai contenuti di Looker. Seguendo l'URL di contenuti di 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 di Looker, ad eccezione delle visualizzazioni delle query

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

Incorporamento di una visualizzazione delle query

  1. Vai alla visualizzazione della 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 delle visualizzazioni.
  3. Il percorso dell'URL dei contenuti incorporati è /embed/query-visualization/ aggiunto con il tuo ID client di query. Il percorso dell'URL dei contenuti incorporati 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 esigenze. Per questo esempio, l'URL dei contenuti Looker risultante è: https://instance.looker.com/dashboards/4?Timeframe=14+day
  3. I parametri URL dei contenuti incorporati sono parametri 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 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. Crea un 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 a ciò di cui hai bisogno 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 uno dei due seguenti 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 incorporata facoltativa

Aggiungi allow_login_screen=true ai parametri URL dei contenuti incorporati per presentare 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 a mente due aspetti:

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

Per alcuni browser, come Firefox e Safari, vengono impostate norme predefinite sui 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 il nome host dell'URL dei contenuti incorporati all'istanza di Looker risiedano nello stesso dominio.

5. Interagire con l'iframe

Inizia a utilizzare i messaggi post-iframe di incorporamento di Looker.

Passaggi successivi

Inizia a utilizzare l'incorporamento firmato usando il nostro SDK Embed e dai un'occhiata agli esempi di ciò che puoi fare con l'incorporamento di Looker.