Incorporação de elementos visuais e de painéis do QuickSight que usam um código de incorporação com um único clique para usuários registrados - Amazon QuickSight

Incorporação de elementos visuais e de painéis do QuickSight que usam um código de incorporação com um único clique para usuários registrados

 Aplica-se a: Enterprise Edition 

É possível incorporar um elemento visual ou um painel em sua aplicação interna para usuários registrados da sua conta do Amazon QuickSight. Você faz isso usando o código de incorporação obtido ao compartilhar o painel ou ao usar o menu Incorporar elemento visual no QuickSight. Não é necessário executar a API de incorporação do QuickSight para gerar o código de incorporação. Você pode copiar o código de incorporação do QuickSight e colá-lo no código HTML da aplicação interna.

Quando os usuários e os grupos (ou todos os usuários em sua conta do QuickSight) que têm acesso ao painel que você deseja incorporar ou que contém o elemento visual que você deseja incorporar acessam a aplicação interna, eles são solicitados a fazer login na conta do QuickSight usando as credenciais. Depois de autenticados, eles podem acessar o elemento visual ou o painel na página interna. Se o logon único estiver ativado, os usuários não serão solicitados a fazer login novamente.

A seguir, você encontrará descrições sobre como incorporar um elemento visual ou um painel para usuários registrados usando o código de incorporação para elementos visuais ou painéis.

Antes de começar

Antes de começar a usar, certifique-se do seguinte:

  • As configurações do navegador da Internet contêm um dos seguintes itens para permitir a comunicação entre o pop-up e o iframe:

    • Suporte nativo para a API Broadcast Channel do Mozilla. Para obter mais informações, consulte a API Broadcast Channel na documentação do Mozilla.

    • Suporte para IndexedDB.

    • Suporte para LocalStorage.

  • A configuração de “bloquear todos os cookies” do seu navegador da Internet está desativada.

Etapa 1: conceder acesso ao painel

Para que os usuários acessem o painel incorporado, conceda-lhes acesso para visualizá-lo. É possível conceder acesso a um painel para usuários e grupos individuais ou conceder acesso a todos os usuários em sua conta. As permissões de elementos visuais são determinadas no nível do painel. Para conceder acesso a elementos visuais incorporados, conceda acesso ao painel ao qual o elemento visual pertence. Para obter mais informações, consulte Como conceder acesso a um painel.

Etapa 2: estabelecer o domínio no local em que você deseja incorporar o elemento visual ou o painel em sua lista de permissões

Para incorporar elementos visuais e painéis na aplicação interna, certifique-se de que o domínio no qual você está realizando a incorporação esteja na lista de permissões em sua conta do QuickSight. Para obter mais informações, consulte Domínios estáticos de lista de permissões.

Etapa 3: obter o código de incorporação

Use o procedimento apresentado a seguir para obter o código de incorporação para o elemento visual ou para o painel.

Obter o código de incorporação para o painel
  1. Abra o painel publicado no QuickSight e escolha Compartilhar no canto superior direito. Em seguida, escolha Compartilhar painel.

    Esta é uma imagem do ícone de compartilhamento do painel.
  2. Na página Compartilhar painel que é aberta, escolha Copiar código de incorporação no canto superior esquerdo.

    Esta é uma imagem do ícone de cópia do código de incorporação.

    O código de incorporação é copiado para a área de transferência e se assemelha ao apresentado a seguir. Neste exemplo, quicksightdomain corresponde ao URL que você usa para acessar a conta do QuickSight.

    <iframe width="960" height="720" src="https://quicksightdomain/sn/embed/share/accounts/accountid/dashboards/dashboardid?directory_alias=account_directory_alias"> </iframe>
Obter o código de incorporação para o elemento visual
  1. Abra o painel publicado no QuickSight e escolha o elemento visual que deseja incorporar. Em seguida, abra o menu do elemento visual no canto superior direito do elemento visual e escolha Incorporar elemento visual.

    Esta é uma imagem do menu do elemento visual.
  2. No painel Incorporar elemento visual que é aberto, escolha Copiar código.

    Ícone de Copiar código

    O código de incorporação é copiado para a área de transferência e se assemelha ao apresentado a seguir. Neste exemplo, quicksightdomain corresponde ao URL que você usa para acessar a conta do QuickSight.

    <iframe width="600" height="400" src="https://quicksightdomain/sn/embed/share/accounts/111122223333/dashboards/DASHBOARDID/sheets/SHEETID>/visuals/VISUALID"> </iframe>

Etapa 4: colar o código na página HTML da aplicação interna

Use o procedimento apresentado a seguir para colar o código de incorporação na página HTML da aplicação interna.

Colar o código na página HTML da aplicação interna
  • Abra o código HTML para qualquer página na qual você deseja incorporar o painel e cole o código de incorporação.

    O exemplo a seguir mostra como um painel incorporado se assemelharia. Neste exemplo, quicksightdomain corresponde ao URL que você usa para acessar a conta do QuickSight.

    <!DOCTYPE html> <html> <body> <h2>Example.com - Employee Portal</h2> <h3>Current shipment stats</h3> <iframe width="960" height="720" src="https://quicksightdomain/sn/embed/share/accounts/accountid/dashboards/dashboardid?directory_alias=account_directory_alias"> </iframe> </body> </html>

    O exemplo a seguir mostra como um elemento visual incorporado se assemelharia. Neste exemplo, quicksightdomain corresponde ao URL que você usa para acessar a conta do QuickSight.

    <!DOCTYPE html> <html> <body> <h2>Example.com - Employee Portal</h2> <h3>Current shipment stats</h3> <iframe width="600" height="400" src="https://quicksightdomain/sn/embed/share/accounts/111122223333/dashboards/DASHBOARDID/sheets/SHEETID>/visuals/VISUALID?directory_alias=account_directory_alias"> </iframe> </body> </html>

Por exemplo, digamos que você deseje incorporar o elemento visual ou o painel em uma página interna do Google Sites. Você pode abrir a página no Google Sites e colar o código de incorporação em um widget de incorporação.

Se desejar incorporar o elemento visual ou o painel em um site interno do Microsoft SharePoint, poderá criar uma nova página e, em seguida, colar o código de incorporação em uma Web Part Incorporar.