Remover um dashboard
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 HTMLiframe
que contém o painel inserido. Especificamente, a API atribui a URL aosrc
atributo doiframe
. 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 elementodiv
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.
- Use
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 umpageView
valor deactualSize
quando inseri um painel:- Se o painel for maior que o
div
elemento, a API usará a largura dodiv
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, odiv
estilo do elemento fica visível no espaço não utilizado.
- Se o painel for maior que o