Incorporação básica de painéis de controle

Esta página mostra como incorporar um painel de controle como um iframe em um aplicativo externo. Os usuários acessam o painel de controle usando suas credenciais do Databricks.

Gerar código de incorporação

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

1. Abra um painel de controle publicado que você deseja incorporar. Consulte Painéis do autor para saber como view e acessar painéis em seu workspace.

2. Clique em Compartilhar no canto superior direito.

3. Clique em Incorporar painel na caixa de diálogo de compartilhamento .

4. Uma caixa de diálogo "Copiar código de incorporação" será aberta. Caso exista uma lista de domínios de incorporação permitidos, esses domínios serão listados. Clique O botão de copiar serve para copiar o trecho de código.

   

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

nota

• Se a sua caixa de diálogo "Copiar código de incorporação" incluir uma lista de domínios permitidos que não inclua o domínio de destino, um administrador workspace poderá adicioná-lo. Veja o painel de controle do gerenciador e o acesso Genie.

• Os painéis incorporados são sempre exibidos no modo claro. Veja: O modo escuro não está sendo exibido.

Exemplos

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

Incorporar no Confluence

O código de incorporação gerado requer um pequeno ajuste para atender aos requisitos do Confluence. Para incorporar seu painel em uma página do Confluence, siga estes passos:

1. Edite o código de incorporação para incluir apenas o URL gerado, e não as tags iframe ou valores de marcação adicionais.

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

   • Seu <databricks-instance-name> é a primeira parte do URL quando você log em seu workspace. Consulte Obter identificadores para objetos workspace.
   • O <dashboard-and-workspace-ID> é a última parte do URL que aponta para o seu painel de controle. Tem a seguinte aparência: a4bf23c498752e79f1a2d6b4c9087e31?o=3498561237865447.

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

   Edite as strings para que incluam 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 na sua página. Para aprender como inserir um iframe em sua página, consulte a documentação do Confluence.

3. Cole o URL de incorporação editado no campo de texto URL e defina a largura para 100%.

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

Incorporar no Salesforce Knowledge

Para incorporar seu painel em uma página da Base de Conhecimento do Salesforce, siga estas etapas:

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

2. Na tela de edição da página , mova o cursor para o editor de marcação Visualforce .

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

4. Adicione duas tags de parágrafo (<p></p>) em torno do código incorporado.

   O exemplo a seguir usa o marcador <dashboard-embed-code> para demonstrar como deve ser a sua marcação Visualforce. Sua instância deve incluir o código de incorporaçã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 é exibido corretamente.

7. Copie o URL da pré-visualização do componente e crie um novo componente iframe. Deverá ficar semelhante ao seguinte trecho de código. O marcador <your-salesforce-domain> deve ser substituído pelo seu domínio Salesforce.

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

8. Acesse a página da Base de Conhecimento onde você deseja incorporar seu painel.

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

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

Incorporar no SharePoint

Para incorporar seu painel no SharePoint, talvez seja necessário adicionar o URL do Databricks à lista de sites permitidos para conteúdo incorporado no SharePoint. Para obter instruções, consulte a documentação da Microsoft. Em seguida, complete os seguintes passos:

1. Acesse a página do SharePoint onde você deseja hospedar seu painel incorporado.
2. Adicione um elemento Incorporar à página.
3. Cole o código de incorporação completo no campo "Endereço do site" ou "Código de incorporação" no lado direito da tela.
4. Clique fora deste campo para confirmar.

Incorpore um único widget

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

Copie o identificador único.

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

nota

A key name aparece no arquivo serializado que define o painel e não é acessível pela interface do usuário Databricks . É diferente do valor displayName , que define o nome da página exibido na interface do usuário. Consulte Editar um arquivo de painel de controle.

Para copiar o identificador único:

1. Abra o painel publicado no workspace Databricks .

2. Clique no Menu de kebabs para o widget que você deseja incorporar.

3. Clique em " Ver em tela cheia" ou "Copiar link para o widget" . A URL contém os valores relevantes da página e do widget name .

4. Copie o parâmetro de pesquisa fullscreenWidget e tudo o que estiver depois do sinal de igual (=).

   O exemplo a seguir mostra a última parte do URL para um widget em tela cheia:

   fullscreenWidget=53eadf26~3490f286

Ajuste o código de incorporação gerado.

1. Consulte a seção Gerar código de incorporação para encontrar os passos para gerar o código de incorporação do painel.
2. Adicione &fullscreenWidget=<ID> ao URL de incorporação, substituindo <ID> pelo valor combinado <page-name>~<widget-name> .

Por exemplo, se o seu URL de incorporação base for o seguinte:

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

O URL de incorporação atualizado com o identificador exclusivo deve ter a seguinte aparência:

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

visualizar um painel incorporado

Os painéis incorporados oferecem uma maneira segura para os usuários acessarem os dados do painel fora do Databricks. Todas as configurações de compartilhamento existentes serão aplicadas. Os usuários pretendidos devem ter acesso ao painel de controle. Consulte a seção "Quem pode acessar seu painel?". Ao acessar um painel incorporado, os usuários são solicitados a fazer login no Databricks, a menos que já possuam uma sessão ativa de um login recente no mesmo workspace.

Para view um painel incorporado:

• Acesse a página onde o painel de controle foi incorporado.
• Se necessário, log in com suas credenciais Databricks .

Pergunte ao Genie em painéis incorporados

Ao visualizar um painel incorporado que foi publicado com um espaço Genie associado, os visualizadores podem acessar o botão "Pergunte Genie para explorar perguntas em linguagem natural sobre uso de dados.

Para usar o Genie em um painel incorporado:

1. Acesse a página do painel de controle incorporado.
2. Se necessário, log in com suas credenciais Databricks .
3. Clique em "Pergunte ao Genie" na interface do painel de controle.
4. Digite perguntas em linguagem natural sobre os dados do painel de controle.

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

nota

O Ask Genie está disponível apenas em modo de incorporação básico. O Ask Genie não é compatível Genie incorporações externas. Para cenários de incorporação externa, utilize a API Genie Conversation para integrar recursos de consulta em linguagem natural.

nota

Se um usuário registrado que não possui permissão de acesso ao painel tentar view -lo, receberá uma mensagem de erro informando que o painel está indisponível. Consulte a seção Compartilhar um painel publicado para saber como ajustar as configurações de compartilhamento.

Atualizar um painel incorporado

Todos os visualizadores de um painel incorporado podem refresh manualmente os painéis sob demanda. Você também pode configurar um programa para refresh os painéis periodicamente.

Consulte gerenciamento de atualizações agendadas do painel e inscrição.

Solução de problemas em painéis de controle incorporados

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

Próximos passos

• Configure a incorporação para usuários externos : Consulte O que é incorporação para usuários externos?
• Gerenciar permissões de incorporação : Controle quais domínios podem hospedar painéis incorporados e configure as definições de incorporação no nível workspace . Veja gerenciamento de incorporação de painel.
• Compartilhar painéis publicados : configure as definições de compartilhamento e as permissões dos seus painéis publicados com diferentes grupos de usuários. Consulte Compartilhar um painel.