Inserir um painel

  • Artigo

Este artigo aborda as etapas para inserir um painel em seu aplicativo. Saiba mais sobre dashboards no Introdução aos dashboards para designers do Power BI.

Ponta

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

Como inserir um 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 painel, use um objeto de configuração do tipo IDashboardLoadConfiguration:

interface IDashboardLoadConfiguration {
    accessToken: string;
    embedUrl?: string;
    id: string;
    pageView?: models.PageView 
    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. Consulte Entenda as diferentes soluções de inserção para saber mais sobre tokens de acesso.

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

  • id – A ID do painel que você está inserindo. Use uma de API de Dashboards para obter essa ID. Por exemplo:

  • pageView - O formato que a API usa para o painel inserido. As possibilidades incluem:

    • fitToWidth - A largura do painel inserido corresponde à largura do elemento div que contém o painel.
    • oneColumn - O painel inserido aparece em uma coluna.
    • actualSize - A API exibe o painel inserido em tamanho real.

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

    • Use models.TokenType.Aad para inserir para sua organização (usuário possuide dados).
    • Use models.TokenType.Embed para inserir para seus clientes (aplicativo possuide 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 'dashboard' para um painel.

Exemplo

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

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

Considerações e limitações

  • Não há suporte para a inserção de painéis em SKUs em EM

  • Quando você inseri conteúdo, seu aplicativo exibe o conteúdo em um elemento div. Se você usar um valor pageView de actualSize ao inserir um painel:

    • Se o painel for maior que o elemento div, a API usará a largura do elemento div como a largura do painel inserido.
    • Se o painel for mais estreito que o elemento div, a API preencherá o espaço não utilizado com a tela de fundo inserida. Por padrão, essa tela de fundo é branca, mas você pode configurá-la para ser transparente. Nesse caso, o estilo do elemento div é visível no espaço não utilizado.

Conteúdo relacionado