Embedding privado

Além da incorporação pública, também é possível incorporar Looks, Análises detalhadas e painéis de maneira privada. Com a incorporação privada, é possível exigir que um usuário faça a autenticação usando um login do Looker, o Google OAuth ou o OpenID Connect. Se um usuário não estiver autenticado, você terá a opção de mostrar uma mensagem de erro ou uma tela de login.

Os usuários conectados e acessando conteúdo incorporado de forma particular estão sujeitos às configurações no painel do Administrador das Sessões, que determinam por quanto tempo podem permanecer conectados, se podem fazer login em vários navegadores e se serão desconectados após um período de inatividade.

Se você precisar de uma solução incorporada mais avançada ou personalizável, confira nossa página de documentação de Incorporação assinada.

Como gerar um URL de incorporação

Para gerar e copiar um URL de incorporação particular de um painel, um Look ou uma visualização da Análise detalhada, selecione Gerar URL de incorporação no menu de três pontos do painel ou no menu de ação da Análise detalhada em um Análise detalhada ou um Look.

A tela Inserção particular inclui os seguintes elementos:

  1. O campo URL de conteúdo mostra o URL completo de incorporação particular.
  2. O campo Aplicar tema ao URL do painel permite selecionar um tema a ser adicionado ao URL de incorporação se você estiver gerando um dashboard ou um URL incorporado "Explorar" e sua instância tiver temas personalizados ativados. O tema será aplicado quando o dashboard incorporado ou a Análise for exibido.
  3. A chave Incluir parâmetros atuais no URL permite aplicar os parâmetros atuais, como valores de filtro, ao URL incorporado. Se ativados, esses parâmetros serão aplicados quando o conteúdo incorporado for visualizado.
  4. Selecione o botão Copiar link para copiar o URL de incorporação completo para a área de transferência.

Depois de gerar e copiar o URL de incorporação, cole-o em uma nova janela ou guia do navegador para visualizar o conteúdo incorporado. Você também pode usar esse URL para incorporar o conteúdo em um iframe.

Visualizar o conteúdo incorporado

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

Visualização do conteúdo incorporado em um iframe

Coloque o URL para incorporação em um iframe. Exemplo:

  <iframe
      src="https://instance_name.cloud.looker.com/embed/dashboards/1"
      width="1000"
      height="2000"
      frameborder="0">
  </iframe>

Depois, incorpore o iframe como quiser.

Como mudar a aparência incorporada de um painel

Abrir um painel com /embed no URL mostra como ele vai aparecer quando estiver incorporado.

Por padrão, um dashboard incorporado é exibido usando o tema padrão para sua instância do Looker. É possível mudar a aparência do painel incorporado de várias maneiras, dependendo do tipo de painel que você está usando:

  • Em qualquer tipo de painel, você pode especificar um nome de tema diferente no URL incorporado para mudar o tema usado para exibir o painel.
  • Em qualquer tipo de painel, você pode usar o argumento de URL _theme para mudar elementos individuais de tema do painel.
  • Em um painel do LookML, também é possível modificar a aparência incorporada de um dashboard usando o parâmetro embed_style.

O uso do argumento de URL theme, da opção Editar configurações de incorporação ou do parâmetro embed_style faz alterações apenas no painel em que o argumento, a opção ou o parâmetro é aplicado. Se você quiser personalizar a aparência de vários painéis incorporados, use um tema.

Algumas configurações de tela substituem outras. Para mais informações, consulte a página de documentação Como criar e aplicar temas para painéis incorporados e explorações.

Ativar a tela de login para incorporações particulares

É possível adicionar o parâmetro allow_login_screen=true ao seu URL incorporado se você quiser exibir uma tela de login para usuários que ainda não fizeram login. Exemplo:

<iframe src="https://instance_name.cloud.looker.com/embed/looks/4?allow_login_screen=true"></iframe>
                                                            ^^^^^^^^^^^^^^^^^^^^^^^

Se você não adicionar esse parâmetro, um erro 401 será exibido aos usuários que ainda não fizeram login.