Incorporação particular

Além da incorporação pública, também é possível incorporar Looks, Explores e dashboards de forma particular. Com a incorporação particular, é 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 que fazem login e acessam conteúdo incorporado de modo privado estão sujeitos às configurações do painel do administrador Sessões, que determinam por quanto tempo eles podem permanecer conectados, se podem fazer login em vários navegadores e se serão desconectados após um período de inatividade.

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

Gerar um URL de incorporação

Para gerar e copiar um URL de incorporação particular em um painel, um Look ou uma visualização das Análises, selecione Ver URL de incorporação no menu de três pontos do painel ou no menu de engrenagem de ação "Explorar" em uma Análise ou em um Look.

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

  1. O campo Content URL mostra o URL de incorporação particular completo.
  2. O campo Aplicar tema ao URL do painel permite que você selecione um tema a ser adicionado ao URL de incorporação se estiver gerando um painel ou um URL de incorporação "Explorar" e sua instância tiver temas personalizados ativados. O tema será aplicado quando o dashboard incorporado ou a Análise for exibida.
  3. A opção Incluir parâmetros atuais no URL permite escolher se os parâmetros atuais serão aplicados, 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. Também é possível usar esse URL para incorporar o conteúdo em um iframe.

Visualizar o conteúdo incorporado

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

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.

Como alterar a aparência incorporada de um painel

A visualização de um painel com /embed no URL mostra como o painel vai aparecer quando estiver incorporado.

Por padrão, um painel incorporado é exibido usando o tema padrão da sua instância do Looker. Você pode alterar a aparência do seu painel incorporado de várias maneiras, dependendo do tipo de painel que estiver usando:

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

Com o argumento de URL theme, a opção Editar configurações de incorporação ou o parâmetro embed_style faz mudanças apenas no painel em que o argumento, a opção ou o parâmetro é aplicado. Para 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 incorporados e Análises.

Ativar a tela de login para incorporações particulares

Adicione o parâmetro allow_login_screen=true ao URL incorporado se quiser mostrar 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 para os usuários que ainda não estiverem conectados.