Inserir um bloco de painel

Dica

Tente inserir um bloco de painel ou experimentar nossas APIs cliente na seção Explorar nossas APIs do playground do Power BI Embedded Analytics.

Este artigo aborda as etapas para inserir um bloco de painel em seu aplicativo. Saiba mais sobre blocos de painel na introdução aos blocos de painel para designers do Power BI.

Como inserir um bloco do painel

Ao inserir conteúdo do Power BI em um aplicativo, você usa um objeto de configuração para definir o conteúdo que está inserindo e especificar as configurações do conteúdo. Em seguida, você passa esse objeto para a API.

Ao inserir um bloco de painel, use um objeto de configuração do tipo ITileLoadConfiguration:

interface ITileLoadConfiguration {
    accessToken: string;
    dashboardId: string;
    embedUrl: string;
    id: string;
    tokenType?: models.TokenType;
    type: string;
}

Essa interface contém as seguintes propriedades:

• accessToken - O token que fornece acesso aos dados do Power BI que você está inserindo. Confira Noções básicas sobre as diferentes soluções de inserção para saber mais sobre tokens de acesso.

• dashboardId - A ID do painel que contém o bloco que você está inserindo. Você pode usar uma API dashboards para obter essa ID. Dois exemplos são:

  • Dashboards – Obter Painel em Grupo
  • Dashboards – Obter painéis em grupo

• embedUrl - A URL do bloco do painel que você está inserindo. Essa URL se torna a origem do elemento HTML iframe que contém o bloco do painel inserido. Especificamente, a API atribui a URL ao src atributo do iframe. Você pode usar uma API de Dashboards para obter essa URL. Dois exemplos são:

  • Dashboards – Obter bloco em grupo
  • Dashboards – Obter blocos em grupo

• id - A ID do bloco do painel que você está inserindo. Você pode usar uma API dashboards para obter essa ID. Dois exemplos são:

  • Dashboards – Obter bloco em grupo
  • Dashboards – Obter blocos em grupo

• tokenType - O tipo de token que lhe dá acesso aos dados do Power BI que você está inserindo.

  • Use models.TokenType.Aad se você estiver inserindo para sua organização (o usuário possui os dados).
  • Use models.TokenType.Embed se você estiver inserindo para seus clientes (o aplicativo possui os dados).

  Confira Noções básicas sobre as diferentes soluções de inserção para obter mais informações.

• type - O tipo de conteúdo que você está inserindo. Use 'tile' para um bloco de painel.

Exemplo

O exemplo a seguir mostra como inserir um único bloco de painel:

// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
    accessToken: anAccessToken,
    dashboardId: aDashboardId,
    embedUrl: anEmbedUrl,
    id: aTileId,
    tokenType: aTokenType,
    type: 'tile'
};
 
// Get a reference to the HTML element that contains the embedded dashboard tile.
let tileContainer = $('#tileContainer')[0];
 
// Embed the dashboard.
let tile = powerbi.embed(tileContainer, embedConfiguration);

Próximas etapas

Inserir um relatório

Inserir um visual de relatório

Remover um dashboard

Usar bootstrap para melhorar o desempenho