Inserção básica do painel

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 Exibir e organizar painéis para saber como exibir e acessar painéis em seu workspace.

2. Clique em Compartilhar no canto superior direito.

3. Clique no painel Inserir na caixa de diálogo 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 no botão copiar 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 marca HTML iframe, um link para o painel para usar uma origem no iframe e especificações adicionais para altura, largura e borda, conforme mostrado no snippet de código a seguir. Para o painel, os espaços reservados <databricks-instance-name> de exemplo e <dashboard-and-workspace-ID> contêm os valores reais associados ao seu workspace e painel. Eles são os seguintes:

   • Sua <databricks-instance-name> é a primeira parte da URL quando você faz logon em seu workspace. Consulte Obter identificadores para objetos do espaço de trabalho .
   • A <dashboard-and-workspace-ID> última parte da URL que aponta para o 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 de Marcação do Visualforce .

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

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 a aparência da 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 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 o 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 fullscreenWidget de pesquisa e tudo depois do 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 pretendidos devem ter acesso ao painel. Veja quem pode acessar seu painel?. Ao acessar um painel inserido, os visualizadores são solicitados a entrar no Azure Databricks, a menos que tenham uma sessão ativa de uma entrada recente no mesmo workspace.

Para exibir um painel inserido:

• 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 painéis integrados

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 inserido

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 está inserindo para usuários externos?.
• Gerenciar permissões de inserção: controle quais domínios podem hospedar painéis inseridos e definir configurações de inserção no nível do workspace. Consulte Gerenciar a inserçã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.