Primeiros passos com a incorporação particular

Nesta página, você verá como configurar a incorporação particular. A opção de incorporação privada exige que você gerencie o elemento HTML <iframe> diretamente para incorporar seu conteúdo do Looker e exige que o usuário faça login no Looker separadamente do aplicativo host.

Explicaremos esse exemplo de código de incorporação particular:

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

1. Criar o URL de conteúdo incorporado

Vamos considerar um exemplo de conteúdo do Looker no URL https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day. A partir desse URL de conteúdo do Looker, construiremos o URL de conteúdo incorporado e definiremos o atributo src do iframe para ele. Fique à vontade para usar seu próprio URL de conteúdo do Looker ao seguir estas etapas.

O URL de conteúdo incorporado do exemplo de código acima é:

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

O URL de conteúdo incorporado consiste em três partes:

  • Hostname: o nome do host da instância do Looker.
  • Caminho: caminho do URL de conteúdo do Looker com o prefixo /embed (com etapas extras para visualizações de consulta).
  • Parâmetros: parâmetros de URL que especificam filtros e temas

O protocolo precisa ser sempre https://. Vamos criar cada parte em detalhes.

Parte 1: nome do host

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

Parte 2: caminho

O caminho do URL de conteúdo incorporado depende do conteúdo do Looker que você incorporar.

Como incorporar todo o conteúdo do Looker, exceto visualizações de consulta

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

Como incorporar uma visualização de consulta

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

Parte 3: parâmetros

Seus parâmetros de URL de conteúdo incorporado controlam os filtros e temas do seu conteúdo incorporado.

Filtros

  1. Navegue até o URL de conteúdo do Looker.
  2. Ajuste manualmente os filtros do conteúdo conforme desejar. Neste exemplo, o URL de conteúdo resultante do Looker é: https://instance.looker.com/dashboards/4?Timeframe=14+day
  3. Seus parâmetros de URL de conteúdo incorporado são os parâmetros de URL de 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.

Temas

Confira o guia de temas para saber como controlar a aparência do seu conteúdo incorporado.

2. Testar o URL do conteúdo incorporado

Abra o URL de conteúdo incorporado no navegador para visualizar o comportamento e a aparência dele.

3. Criar seu iframe

  1. Crie seu elemento iframe no aplicativo host.
  2. Defina o atributo src como o URL do conteúdo incorporado.
  3. Defina os atributos width, height e outros para o que você precisa para exibir melhor o conteúdo incorporado do Looker.

4. Considerar os problemas de acesso do usuário

O usuário precisa fazer login no Looker para ver o conteúdo incorporado. O iframe mostrará uma página de erro 401 se o usuário não tiver feito login.

Opções de login do usuário

O usuário pode fazer login no Looker de duas maneiras:

1. Fazer login no Looker com antecedência

Seu usuário precisa fazer login no Looker no mesmo navegador antes de ver o conteúdo incorporado.

2. Ativar uma tela opcional de login de incorporação do Looker

Adicione allow_login_screen=true aos seus parâmetros de URL de conteúdo incorporado para exibir uma tela de login do Looker no iframe se o usuário não tiver feito login. Nosso URL de exemplo de conteúdo incorporado se torna: https://instance_name.looker.com/embed/dashboards/4?Timeframe=14+day&allow_login_screen=true.

Lembre-se de duas ressalvas:

O Looker usa cookies para autenticação do usuário e armazenamento de sessões. O navegador do usuário precisa ativar os cookies de terceiros caso o nome de host do URL para incorporação de conteúdo da instância do Looker esteja em um domínio diferente do seu aplicativo host.

Alguns navegadores, como o Firefox e o Safari, adotam como padrão uma política que bloqueia cookies de terceiros. Se o navegador do usuário não permitir cookies de terceiros, adicione um domínio personalizado à instância do Looker para que o aplicativo host e a instância do nome do host do URL de conteúdo incorporado residam no mesmo domínio.

5. Interagir com o iframe

Dê os primeiros passos com a mensagem de iframe da incorporação do Looker.

Próximas etapas

Comece com a incorporação de SSO usando nosso SDK incorporado e confira exemplos do que você pode fazer com a incorporação do Looker.