Noções básicas sobre as diferentes soluções de inserção

  • Artigo

A inserção de itens do Power BI (como relatórios, dashboards e Q&A) em seu aplicativo permite que você integre análises impressionantes e totalmente interativas sem precisar criar suas próprias visualizações de dados e controles do zero. A análise do Power BI que você inseri pode apresentar dados que seu aplicativo possui por meio de sua própria conta do Power BI ou dados que o usuário do possui por meio de suas contas do Power BI.

Cenários de aplicativo

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 possuide dados): o aplicativo permite que você integre dados, relatórios, dashboards e blocos acessíveis aos usuários em sua organização ao entrar 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 possuide 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ê inseri é especificado pelo valor do parâmetroembedUrl. 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 sua 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.

No embedConfiguration, defina tokenType como TokenType.Aad.

// 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 uma de Token de Inserção para os relatórios, dashboards ou blocos que deseja inserir chamando a API REST do Power BI de Token de Inserção. Depois de ter um token de inserção , use o seguinte código para inserir o relatório:

No embedConfiguration, defina tokenType como TokenType.Embed.

// 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);

Conteúdo relacionado