Remover um dashboard

  • Artigo

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

Dica

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

Como inserir um painel

Ao inserir o 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. Confira Noções básicas sobre 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 se torna a origem do elemento HTML iframe que contém o 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:

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

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

    • fitToWidth – A largura do dashboard inserido corresponde à largura do elemento div que contém o dashboard.
    • oneColumn – O dashboard 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 (o usuário possui dados).
    • Use models.TokenType.Embed para inserir para seus clientes (o aplicativo possui 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

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

    • Se o painel for maior que o div elemento, a API usará a largura do div elemento como a largura do painel inserido.
    • Se o painel for mais estreito que o div elemento, 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 div estilo do elemento fica visível no espaço não utilizado.

Próximas etapas

Inserir um relatório

Inserir um bloco do painel

Usar bootstrap para melhorar o desempenho