Comece a usar a incorporação privada

Esta página explica como configurar a incorporação privada. A opção de incorporação privada requer que faça a gestão direta do elemento HTML <iframe> para incorporar o seu conteúdo do Looker e requer que o utilizador inicie sessão no Looker separadamente da aplicação anfitriã.

Vamos analisar este exemplo de código de incorporação privado:

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

1. Crie o URL do conteúdo incorporado

Considere um exemplo de conteúdo do Looker no URL https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day. A partir deste URL de conteúdo do Looker, vamos construir o URL de conteúdo incorporado e definir o atributo src do iFrame para o mesmo. Não hesite em usar o seu próprio URL de conteúdo do Looker à medida que segue estes passos.

O URL do conteúdo incorporado do exemplo de código anterior é o seguinte:

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

O URL do conteúdo incorporado é composto por três partes:

  • Nome do anfitrião: o nome do anfitrião da sua instância do Looker
  • Caminho: caminho do URL do conteúdo do Looker com o prefixo /embed (com passos adicionais para visualizações de consultas)
  • Parâmetros: parâmetros de URL que especificam filtros e temas

O protocolo tem de ser sempre https://. Vamos criar cada parte em detalhe.

Parte 1: nome do anfitrião

  1. Navegue para o seu conteúdo do Looker. Seguindo o exemplo do URL de conteúdo do Looker: https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day.
  2. O nome do anfitrião do URL do conteúdo incorporado é instance.looker.com.

Parte 2: caminho

O caminho do URL do conteúdo incorporado depende do conteúdo do Looker que incorpora.

Incorporar todo o conteúdo do Looker, exceto visualizações de consultas

  1. Navegue para o seu conteúdo do Looker. Seguindo o exemplo do URL de conteúdo do Looker: https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day
  2. Identifique o caminho dos URLs de conteúdo do Looker: /dashboards/4.
  3. Adicione o prefixo /embed ao caminho dos URLs de conteúdo do Looker. O caminho dos URLs do seu conteúdo incorporado é /embed/dashboards/4.

Incorporar uma visualização de consulta

  1. Navegue para a visualização da consulta. Exemplo de URL: instance.looker.com/explore/my_model/my_explore?qid=1234567890abcdefghij12
  2. Identifique o ID de cliente da consulta. O parâmetro qid: 1234567890abcdefghij12 é o ID de cliente da sua consulta que representa a consulta e as definições de visualizações.
  3. O caminho do URL do conteúdo incorporado é /embed/query-visualization/ anexado ao ID de cliente da consulta. O caminho do URL do conteúdo incorporado de exemplo é /embed/query-visualization/1234567890abcdefghij12

Parte 3: parâmetros

Os parâmetros de URL do conteúdo incorporado controlam os filtros e o tema do conteúdo incorporado.

Filtros

  1. Navegue para o URL do conteúdo do Looker.
  2. Ajustar manualmente os filtros do conteúdo para o que quer. Para este exemplo, o URL do conteúdo do Looker resultante é: https://instance.looker.com/dashboards/4?Timeframe=14+day
  3. Os parâmetros de URL do conteúdo incorporado são os parâmetros de URL do conteúdo do Looker, por exemplo, Timeframe=14+day

Neste exemplo, o parâmetro Timeframe=14+day define o valor do filtro Timeframe do painel de controlo.

Temas

Consulte o guia de temas para saber como controlar o aspeto do conteúdo incorporado.

2. Teste o URL do conteúdo incorporado

Abra o URL do conteúdo incorporado no navegador para pré-visualizar o comportamento e o aspeto do conteúdo incorporado.

3. Crie o seu iFrame

  1. Crie o elemento iframe na aplicação anfitriã.
  2. Defina o atributo src para o URL do conteúdo incorporado.
  3. Defina o width, o height e outros atributos de acordo com o que precisa para apresentar melhor o seu conteúdo do Looker incorporado.

4. Tenha em consideração os problemas de acesso dos utilizadores

O utilizador tem de ter sessão iniciada no Looker para ver o seu conteúdo incorporado. O iFrame apresenta uma página de erro 401 se o utilizador não tiver sessão iniciada.

Opções de início de sessão do utilizador

O utilizador pode iniciar sessão no Looker de uma de duas formas:

1. Inicie sessão no Looker antecipadamente

O utilizador tem de iniciar sessão no Looker no mesmo navegador antes de poder ver o conteúdo incorporado.

2. Ative um ecrã de início de sessão do Looker incorporado opcional

Adicione allow_login_screen=true aos parâmetros do URL do conteúdo incorporado para apresentar um ecrã de início de sessão do Looker no iFrame se o utilizador não tiver sessão iniciada. O URL do conteúdo incorporado de exemplo torna-se: https://instance_name.looker.com/embed/dashboards/4?Timeframe=14+day&allow_login_screen=true

Tenha em atenção duas ressalvas:

O Looker usa cookies para a autenticação do utilizador e o armazenamento de sessões. O navegador do utilizador tem de ativar os cookies de terceiros se o nome do anfitrião do URL de conteúdo incorporado da instância do Looker do utilizador estiver num domínio diferente da sua aplicação anfitriã.

Alguns navegadores, como o Firefox e o Safari, usam por predefinição uma política de cookies que bloqueia cookies de terceiros. Se o navegador do utilizador não permitir cookies de terceiros, pode adicionar um domínio personalizado à sua instância do Looker para que a aplicação anfitriã e o nome do anfitrião da instância do Looker dos URLs de conteúdo incorporado residam no mesmo domínio.

5. Interaja com o seu iFrame

Comece a usar a mensagens postais de iFrame de incorporação do Looker.

Passos seguintes

Comece com a incorporação assinada através do nosso SDK de incorporação e consulte exemplos do que pode fazer com a incorporação do Looker.