Compreendendo as diferentes soluções de incorporação
A inserção de itens do Power BI (como relatórios, dashboards e Q&A) em seu aplicativo permite que você integre uma análise impressionante e totalmente interativa sem precisar criar suas próprias visualizações e controles de dados do zero. A análise do Power BI que você insere pode apresentar dados que seu aplicativo possui por meio de sua própria conta do Power BI ou dados que o usuário possui por meio de suas contas do Power BI.
Cenários de aplicativos
Há dois cenários diferentes para inserir um relatório do Power BI em um aplicativo.
- Inserir para sua organização (também conhecido como usuário possui dados): o aplicativo permite que você integre dados, relatórios, dashboards e blocos acessíveis aos usuários em sua organização quando eles entram usando suas próprias contas do Power BI. Nesse tipo de aplicativo, os usuários possuem os dados que você inseri.
- Inserir para seus clientes (também conhecido como aplicativo possui dados): o aplicativo apresenta os dados, relatórios, dashboards ou blocos que você carregou em sua própria conta do Power BI. Nesse tipo de aplicativo, você está usando sua própria conta, portanto, seu aplicativo possui os dados para seus clientes. Seus clientes não precisam de sua própria conta do Power BI.
O cenário de aplicativo que você usa determina como recuperar um token de acesso que permite acessar dados e inserir conteúdo em seu aplicativo.
O tipo de conteúdo que você insere é especificado pelo valor doembedUrl parâmetro . Para recuperar uma URL de inserção para um tipo específico de conteúdo, chame a API REST do Power BI correspondente. Por exemplo, chame Obter Relatórios para recuperar a URL de inserção para inserir um relatório.
As seções a seguir mostram como recuperar um token de acesso e inserir um relatório para cada um desses cenários de aplicativo.
Inserir para a organização
Nesse cenário, os usuários do aplicativo entrarão usando suas contas do Power BI. Isso fornece o token de acesso para acessar seus dados e inserir seus relatórios, dashboards e blocos.
embedConfigurationNo , defina como TokenType.AadtokenType .
// Get models so you can use the TokenType enum.
let models = window['powerbi-client'].models;
let embedConfiguration = {
type: 'report',
id: '5dac7a4a-4452-46b3-99f6-a25915e0fe55',
embedUrl: 'https://app.powerbi.com/reportEmbed',
tokenType: models.TokenType.Aad,
accessToken: 'e4...rf'
};
let reportContainer = $('#reportContainer')[0];
let report = powerbi.embed(reportContainer, embedConfiguration);
Inserir para seus clientes
Nesse cenário, você cria uma identidade dedicada que tem acesso a todos os itens do Power BI. Em seguida, você gera um Token de Inserção para os relatórios, dashboards ou blocos que deseja inserir chamando o Token de Inserção da API REST do Power BI. Depois de ter um token de inserção, use o seguinte código para inserir o relatório:
embedConfigurationNo , defina como TokenType.EmbedtokenType .
// Get models so you can use the TokenType enum.
let models = window['powerbi-client'].models;
let embedConfiguration = {
type: 'report',
id: '5dac7a4a-4452-46b3-99f6-a25915e0fe55',
embedUrl: 'https://app.powerbi.com/reportEmbed',
tokenType: models.TokenType.Embed,
accessToken: 'h4...rf'
};
let reportContainer = $('#reportContainer')[0];
let report = powerbi.embed(reportContainer, embedConfiguration);