Partilhar via


Inserir um visual de relatório

Ponta

Tente inserir um visual de relatório ou experimentar nossas APIs cliente na seção Explorar nossas APIs do do Power BI Embedded Analytics Playground.

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 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. Consulte Entenda 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 torna-se a origem do elemento HTML iframe que contém o visual inserido. Especificamente, a API atribui a URL ao atributo src do iframe. Você pode usar um de 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 getPages relatório 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).

    Consulte 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 getVisuals página 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 API updateFilters 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 de .