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.

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 de Incorporaçã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 que você selecione um tema para ser adicionado ao URL de incorporação se você estiver gerando um URL de incorporação de painel ou da seção "Explorar" e sua instância tiver temas personalizados ativados. O tema será aplicado quando o dashboard incorporado ou a Análise for exibido.
  3. O botão Incluir parâmetros atuais no URL permite aplicar parâmetros atuais, como valores de filtro, ao URL de incorporação. 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 conferir 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.

Como visualizar o conteúdo incorporado em um iframe

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

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

Em seguida, incorpore o iframe como quiser.

Alterar a aparência incorporada de um dashboard

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 alterar 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 exibição substituem outras. Para mais informações, consulte a página de documentação Como criar e aplicar temas para painéis e análises incorporados.

Ativar a tela de login para incorporações particulares

É possível adicionar o parâmetro allow_login_screen=true ao URL de incorporação se você quiser mostrar uma tela de login para os 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á mostrado para os usuários que ainda não fizeram login.