Integração básica de dashboard

Esta página mostra como inserir um painel como um iframe em um aplicativo externo. Os visualizadores acessam o painel usando suas credenciais do Azure Databricks.

Gerar código de inserção

Para gerar um código de inserção que você pode colar em aplicativos externos:

1. Abra um painel publicado que você deseja inserir. Consulte os painéis do Author para saber como exibir e acessar painéis em seu workspace.

2. Clique em Compartilhar no canto superior direito.

3. Clique em Inserir painel na caixa de diálogo de Compartilhamento.

4. Uma caixa de diálogo Copiar código de inserção é aberta. Se existir uma lista de domínios de inserção permitidos, os domínios serão listados. Clique no para copiar o snippet de código.

   

5. Insira o código de inserção em qualquer plataforma ou aplicativo que dê suporte à inserção HTML e possa renderizar o conteúdo do iframe. Veja exemplos.

Exemplos

Os exemplos a seguir incluem diretrizes passo a passo para inserir seus painéis em um aplicativo. Cada conjunto de instruções pressupõe que você já copiou o código de inserção descrito na seção anterior.

Inserir em Confluence

O código de inserção gerado requer um pequeno ajuste para atender aos requisitos de Confluence. Para inserir seu painel em uma página do Confluence, conclua as seguintes etapas:

1. Edite o código de inserção para incluir apenas a URL gerada, não as marcas iframe ou valores de marcação adicionais.

   Antes de editar, o código de inserção inclui uma tag HTML iframe, um link para o seu painel para usar como origem no iframe, e especificações adicionais para altura, largura e borda, conforme mostrado no trecho de código a seguir. Para o dashboard, os exemplos de espaços reservados <databricks-instance-name> e <dashboard-and-workspace-ID> contêm os valores reais associados ao seu workspace e dashboard. Elas são as seguintes:

   • Sua <databricks-instance-name> é a primeira parte da URL quando você faz login em seu ambiente de trabalho. Consulte Obter identificadores para objetos do espaço de trabalho .
   • A <dashboard-and-workspace-ID> é a última parte da URL que aponta para o seu painel. Parece algo como: a4bf23c498752e79f1a2d6b4c9087e31?o=3498561237865447.

   <iframe src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>" width="100%" height="600" frameborder="0"></iframe>
   

   Edite a cadeia de caracteres para que ela inclua apenas o texto do link, conforme mostrado no exemplo a seguir.

   https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>
   

2. Insira um elemento iframe em sua página. Para saber como inserir um iframe em sua página, consulte a documentação do Confluence.

3. Cole a URL de inserção editada no campo de texto da URL e defina a largura como 100%.

4. Ajuste outras configurações de acordo com sua preferência.

Inserir no Conhecimento do Salesforce

Para inserir seu painel em uma página de Conhecimento do Salesforce, conclua as seguintes etapas:

1. Crie uma página do Visualforce. Para obter instruções, consulte a documentação do Salesforce.

2. Na tela Editar Página, mova o cursor para o editor Visualforce Markup.

3. Cole o código de incorporação copiado entre as duas <apex:page></apex:page> tags.

4. Adicione duas marcas de parágrafo (<p></p>) ao redor do código de inserção.

   O exemplo a seguir usa o espaço reservado <dashboard-embed-code> para demonstrar como deve ser a marcação do Visualforce. Sua instância deve incluir o código de inserção completo que você copiou.

   <apex:page >
   <p><dashboard-embed-code></p>
   </apex:page>
   

5. Clique em Salvar para salvar suas alterações.

6. Clique em Visualizar e confirme se o painel é renderizado.

7. Copie a URL da visualização do componente e crie um novo componente iframe. Ele deve se parecer com o snippet de código a seguir. O espaço reservado <your-salesforce-domain> deve ser substituído por seu domínio Salesforce.

   <iframe src="https://<your-salesforce-domain>/apex/<component name>" width="100%" height="600" frameborder="0"></iframe>
   

8. Vá para a página Conhecimento em que você deseja inserir seu painel.

9. Clique em Editar > Adicionar um componente de mídia.

10. Cole o código iframe da etapa anterior no campo Inserir texto.

Inserir no SharePoint

Para inserir seu painel no SharePoint, talvez seja necessário adicionar a URL do Azure Databricks à lista de sites permitidos para conteúdo inserido no SharePoint. Para obter instruções, consulte a documentação da Microsoft. Em seguida, conclua as seguintes etapas:

1. Vá para a página do SharePoint na qual você deseja hospedar seu painel inserido.
2. Adicione um elemento Inserção à página.
3. Cole o código de inserção completo no endereço do site ou insira o campo de código no lado direito da tela.
4. Clique agora para confirmar.

Inserir um único widget

Para inserir um único widget de um painel, você precisa do código de inserção do painel e do identificador exclusivo do widget que você deseja mostrar.

Copiar o identificador exclusivo

O identificador de um único widget é uma combinação de um valor de página name e um valor de widget name , semperado por um tilda (~).

Para copiar o identificador exclusivo:

1. Abra seu painel publicado no workspace do Azure Databricks.

2. Clique no Menu de kebab para o widget que você deseja inserir.

3. Clique em Exibir tela inteira ou copiar link para o widget. A URL contém os valores relevantes de página e widget name .

4. Copie o parâmetro de pesquisa fullscreenWidget e todo o conteúdo após o sinal de igual (=).

   O exemplo a seguir mostra a última parte da URL para um widget de tela inteira:

   fullscreenWidget=53eadf26~3490f286
   

Ajustar o código de inserção gerado

1. Consulte Gerar código de inserção para localizar as etapas para gerar o código de inserção do painel.
2. Adicione &fullscreenWidget=<ID> à URL de inserção, substituindo <ID> pelo valor combinado <page-name>~<widget-name> .

Por exemplo, se a URL de inserção base for a seguinte:

src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>&fullscreenWidget=<ID>"

A URL de inserção atualizada com o identificador exclusivo deve ser semelhante à seguinte:

src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>&fullscreenWidget=53eadf26~82f66691"

Exibir um painel inserido

Os painéis inseridos oferecem uma maneira segura para os visualizadores acessarem dados do painel fora do Azure Databricks. Todas as configurações de compartilhamento existentes se aplicam. Os visualizadores designados devem receber acesso ao painel. Veja quem pode acessar seu painel?. Ao acessar um painel incorporado, os visualizadores precisam fazer login no Azure Databricks, a menos que tenham uma sessão ativa de um login recente no mesmo workspace.

Para exibir um painel embutido:

• Navegue até a página em que o painel foi inserido.
• Se necessário, faça logon com as credenciais do Azure Databricks.

Pergunte ao Genie em dashboards inseridos

Ao exibir um painel inserido que foi publicado com um espaço do Genie associado, os visualizadores podem acessar o botão Perguntar Genie para explorar dados usando perguntas de linguagem natural.

Para usar o Genie em um painel inserido:

1. Navegue até a página do painel incorporado.
2. Se necessário, faça logon com as credenciais do Databricks.
3. Clique em Perguntar Genie na interface do painel.
4. Digite perguntas de linguagem natural sobre os dados do painel.

O Genie usa as mesmas permissões e acesso a dados que o painel publicado. Consulte espaços do Genie com painéis de controle para obter mais informações sobre como configurar e usar o Genie com painéis de controle.

Atualizar um painel incorporado

Todos os visualizadores de um painel inserido podem atualizar manualmente os painéis sob demanda. Você também pode configurar uma agenda para atualizar os painéis periodicamente.

Veja Gerenciar atualizações e assinaturas agendadas do painel.

Solução de problemas de painéis inseridos

Para problemas e resoluções comuns ao trabalhar com painéis inseridos, incluindo problemas de exibição de tema e iframes em branco, consulte solução de problemas de painéis inseridos.

Próximas Etapas 

• Configurar a inserção para usuários externos: Veja O que é inserção para usuários externos?.
• Gerenciar permissões de inserção: controle quais domínios podem hospedar painéis inseridos e configurar configurações de inserção no nível do espaço de trabalho. Consulte Gerenciar a incorporação do painel.
• Compartilhar painéis publicados: defina as configurações e permissões de compartilhamento para seus painéis publicados com diferentes grupos de usuários. Veja Compartilhar um painel.