Nesta página, mostramos como configurar a incorporação particular. A opção de incorporação particular exige que você gerencie o elemento HTML <iframe> diretamente para incorporar o conteúdo do Looker e que o usuário faça login no Looker separadamente do aplicativo hospedado.
Vamos analisar este 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 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. Com esse URL de conteúdo do Looker, vamos criar o URL de conteúdo incorporado e definir o atributo src do iframe para ele. Fique à vontade para usar o URL do seu próprio conteúdo do Looker ao seguir estas etapas.
O URL de conteúdo incorporado do exemplo de código anterior é o seguinte:
O URL de conteúdo incorporado consiste em três partes:
- Nome do host: o nome do host da instância do Looker
- Caminho: caminho do URL do 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://. Este exemplo vai criar cada parte em detalhes.
Parte 1: nome do host
- Acesse o 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. - O nome do host 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 você incorporar.
Incorporação de todo o conteúdo do Looker, exceto as visualizações de consulta
- Acesse o 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 - Identifique o caminho do URL do conteúdo do Looker:
/dashboards/4. - Adicione o prefixo
/embedao caminho do URL do conteúdo do Looker. O caminho do URL do conteúdo incorporado é/embed/dashboards/4.
Como incorporar uma visualização de consulta
- Acesse a visualização da consulta. URL de exemplo:
instance.looker.com/explore/my_model/my_explore?qid=1234567890abcdefghij12 - Identifique o ID do cliente da consulta. O parâmetro
qid:1234567890abcdefghij12é o ID do cliente da sua consulta que representa as configurações de consulta e visualizações. - O caminho do URL do conteúdo incorporado é
/embed/query-visualization/anexado ao ID do cliente da consulta. O caminho do URL de 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
- Acesse o URL do conteúdo do Looker.
- Ajuste manualmente os filtros do conteúdo para o que você quer. Neste exemplo, o URL do conteúdo do Looker resultante é:
https://instance.looker.com/dashboards/4?Timeframe=14+day - 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.
Temas
Confira o guia de temas para saber como controlar a aparência do conteúdo incorporado.
2. Testar o URL do conteúdo incorporado
Abra o URL do conteúdo incorporado no navegador para conferir o comportamento e a aparência dele.

3. Criar o iframe
- Crie o elemento iframe no aplicativo hospedado.
- Defina o atributo
srccomo o URL do conteúdo incorporado. - Defina
width,heighte outros atributos para o que você precisa para exibir melhor o conteúdo incorporado do Looker.
4. Considere os problemas de acesso do usuário
O usuário precisa estar conectado ao Looker para ver o conteúdo incorporado. O iframe vai mostrar uma página de erro 401 se o usuário não estiver conectado.
Opções de login do usuário
O usuário pode fazer login no Looker de duas maneiras:
1. Faça login no Looker com antecedência
O usuário precisa fazer login no Looker no mesmo navegador para ver o conteúdo incorporado.
2. Ativar uma tela de login opcional do Looker incorporado
Adicione allow_login_screen=true aos parâmetros de URL do conteúdo incorporado para apresentar uma tela de login do Looker no iframe se o usuário não estiver conectado. O URL de exemplo do 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:
- É preciso desativar a configuração de proteções de mesma origem para páginas de login do Looker para ativar a tela de login do Looker na incorporação de iframe.
- Se a instância do Looker autenticar usuários usando o Logon único (SSO) com um provedor de identidade, esse provedor poderá bloquear a tela de login no iframe. Nesse caso, use a opção 1.
Política de cookies do navegador do usuário
O Looker usa cookies para autenticação de usuários e armazenamento de sessões. O navegador do usuário precisa ativar cookies de terceiros se o nome do host do URL de conteúdo incorporado da instância do Looker estiver em um domínio diferente do aplicativo hospedado.
Alguns navegadores, como o Firefox e o Safari, têm uma política de cookies padrão 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 hospedado e o nome do host do URL do conteúdo incorporado da instância do Looker fiquem no mesmo domínio.
5. Interagir com o iframe
Comece a usar as mensagens de postagem de iframe de incorporação do Looker.
Próximas etapas
Comece a usar a incorporação assinada com nosso SDK de incorporação e confira exemplos do que você pode fazer com a incorporação do Looker.