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
-
Abra o painel publicado no QuickSight e escolha Compartilhar no canto superior direito. Em seguida, escolha Compartilhar painel.
-
Na página Compartilhar painel que é aberta, escolha Copiar código de incorporação no canto superior esquerdo.
O código de incorporação é copiado para a área de transferência e se assemelha ao apresentado a seguir. Neste exemplo,
corresponde ao URL que você usa para acessar a conta do QuickSight.quicksightdomain<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
-
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.
-
No painel Incorporar elemento visual que é aberto, escolha 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,
corresponde ao URL que você usa para acessar a conta do QuickSight.quicksightdomain<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,
corresponde ao URL que você usa para acessar a conta do QuickSight.quicksightdomain<!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,
corresponde ao URL que você usa para acessar a conta do QuickSight.quicksightdomain<!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.