Partilhar via

Incorporação básica do painel

Esta página mostra como incorporar um painel como um iframe em um aplicativo externo. Os visualizadores acedem ao painel de controlo usando as suas credenciais Azure Databricks.

Gerar código de incorporação

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

  1. Abra um painel publicado que você deseja incorporar. Consulte Exibir e organizar painéis para saber como exibir e acessar painéis em seu espaço de trabalho.

  2. Clique em Compartilhar no canto superior direito.

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

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

    A caixa de diálogo Copiar código de incorporação mostra o código iframe gerado e os domínios nos quais os painéis publicados podem ser incorporados.

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

Observação

Examples

Os exemplos a seguir incluem orientação 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, conclua as seguintes etapas:

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

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

    • A sua <databricks-instance-name> é a primeira parte do URL quando inicia sessão na sua área de trabalho. Consulte Obter identificadores para objetos de espaço de trabalho.
    • A <dashboard-and-workspace-ID> é a última parte do 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 na sua página. Para saber como inserir um iframe na 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 como 100%.

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

Um painel incorporado em uma página de rascunho do Confluence.

Incorporar no conhecimento do Salesforce

Para incorporar 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 incorporação copiado entre as duas <apex:page></apex:page> tags.

  4. Adicione duas tags de parágrafo (<p></p>) ao redor do código de incorporaçã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 incorporação completo que você copiou.

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

  5. Clique em Guardar para guardar as alterações.

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

  7. Copie o URL da visualização do componente e crie um novo componente iframe. Ele deve se parecer com o trecho de código a seguir. O espaço reservado <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. Vá para a página Conhecimento onde você deseja incorporar seu painel.

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

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

Incorporar no SharePoint

Para incorporar seu painel no SharePoint, talvez seja necessário adicionar sua URL do Azure Databricks à lista de sites permitidos para conteúdo incorporado 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 onde você deseja hospedar seu painel incorporado.
  2. Adicione um elemento Incorporar à página.
  3. Cole o código de incorporação completo no endereço do site ou no campo de código de incorporação no lado direito da tela.
  4. Clique para confirmar.

Um painel incorporado em uma página de rascunho do SharePoint

Incorporar um único widget

Para incorporar um único widget a partir de um painel, você precisa do código de incorporação do painel e do identificador exclusivo do widget que 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 , separados por um tilda (~).

Observação

A name chave aparece no arquivo serializado que define o painel e não é acessível a partir da interface do usuário do Azure Databricks. Ele é separado do displayName valor, que define o nome da página mostrado na interface do usuário. Consulte Editar um arquivo de painel.

Para copiar o identificador exclusivo:

  1. Abra seu painel publicado no espaço de trabalho do Azure Databricks.

  2. Clique no ícone do menu Kebab. Kebab menu para o widget que você deseja incorporar.

  3. Clique em Exibir tela cheia ou Copiar link para widget. O URL contém os valores relevantes da página e do 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 do URL de um widget de tela cheia:

    fullscreenWidget=53eadf26~3490f286

Ajustar o código de incorporação gerado

  1. Consulte Gerar código de incorporação para encontrar as etapas 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 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"

Ver um painel incorporado

Os painéis incorporados oferecem uma maneira segura para os espectadores acessarem os dados do painel fora do Azure Databricks. Todas as configurações de compartilhamento existentes se aplicam. Os visualizadores pretendidos devem ter acesso ao painel. Consulte Quem pode acessar seu painel?. Ao acessar um painel incorporado, os espectadores são solicitados a entrar no Azure Databricks, a menos que tenham uma sessão ativa de uma entrada recente no mesmo espaço de trabalho.

Para visualizar um painel incorporado:

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

Pergunte ao Genie em painéis incorporados

Ao visualizar um painel incorporado que foi publicado com um espaço Genie associado, os espectadores podem acessar o botão Perguntar ao Genie para explorar dados usando perguntas em linguagem natural.

Para usar o Genie em um painel incorporado:

  1. Navegue até a página do painel incorporado.
  2. Se necessário, faça login com as credenciais do Databricks.
  3. Clique em Ask Genie na interface do painel.
  4. Digite perguntas em 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 Genie com painéis para obter mais informações sobre como configurar e usar o Genie com painéis.

Exemplo de ecrã de início de sessão a partir de um dashboard incorporado

Observação

Se um usuário registrado que não recebeu acesso ao painel tentar visualizá-lo, ele receberá um erro informando que o painel não está disponível. Consulte Partilhar um painel publicado para saber como ajustar as definições de partilha.

Atualizar um painel incorporado

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

Consulte Gerir atualizações e assinaturas agendadas do dashboard.

Solução de problemas de painéis incorporados

Para questões e resoluções comuns ao trabalhar com dashboards embutidos, incluindo problemas de exibição de temas e iframes em branco, veja Resolução de problemas de dashboards embutidos.

Próximos passos

  • Configurar 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 defina as configurações de incorporação no nível do espaço de trabalho. Consulte Gerenciar a incorporação do painel.
  • Compartilhar painéis publicados: defina configurações e permissões de compartilhamento para seus painéis publicados com diferentes grupos de usuários. Consulte Compartilhar um painel.
  • Last updated on