Compartilhar via

Inserir um visual de relatório

  • Artigo

Dica

Tente inserir um visual de relatório 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 visual em seu aplicativo. Saiba mais sobre visuais em Visuais no Power BI.

Como inserir um visual

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 para especificar as configurações do conteúdo. Em seguida, você passa esse objeto para a API.

Ao inserir um visual, use um objeto de configuração do tipo IVisualLoadConfiguration:

interface IVisualLoadConfiguration {
    accessToken?: string;
    embedUrl?: string;
    id?: string;
    pageName: string;
    tokenType?: models.TokenType;
    type: string;
    visualName: string;
}

Essa interface inclui estas propriedades:

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

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

  • id - A ID do relatório do Power BI que contém o visual que você está inserindo.

  • pageName - O nome da página que contém o visual que você está inserindo. Você pode usar o método Report getPages para obter as páginas em um relatório.

  • 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 Entender as diferentes soluções de inserção para obter mais informações.

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

  • visualName - O nome do visual que você está inserindo. Você pode usar o método Page getVisuals para obter os visuais em uma página.

Exemplo

O exemplo a seguir mostra como inserir um único visual:

// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
    accessToken: anAccessToken,
    embedUrl: anEmbedUrl,
    id: aReportId,
    pageName: aPageName,
    tokenType: aTokenType,
    type: 'visual',
    visualName: aVisualName
};
 
// Get a reference to the HTML element that contains the embedded report.
let embedContainer = $('#embedContainer')[0];
 
// Embed the visual.
let visual = powerbi.embed(embedContainer, embedConfiguration);

Filtros

Por padrão, a updateFilters API aplicará filtros de nível visual ao inserir um único visual de relatório. Isso pode causar um conflito com filtros aplicados no objeto de configuração de inserção, pois eles são aplicados no nível do relatório. Para corrigir esse problema, você pode definir o nível de filtros com a API:

await visual.updateFilters(FiltersOperations.Add, filters, FiltersLevel.Report);

Saiba mais sobre filtros em Filtros de relatório de controle.

Próximas etapas

Inserir um relatório

Inserir um relatório paginado

Inserir um visual Q&A autônomo

Usar bootstrap para melhorar o desempenho