Compartilhar via

Adicionar, excluir ou renomear uma página de relatório

  • Artigo

Você pode usar APIs de operação de página para adicionar ou excluir uma página de um relatório durante uma sessão de análise integrada do Power BI.

Adicionar uma página

Para adicionar uma nova página ao relatório atual, use o método addPage da classe relatório do Cliente do Power BI:

addPage(displayName?: string): Promise<Page>
  • displayName define o nome de exibição da nova página. Se não for especificado, o nome de exibição será definido como Page#<NUM>.
  • A função retorna uma instância Page da nova página.

Por exemplo, adicione uma página com o nome de exibição Sales ao relatório atual:

let newPage = await report.addPage("Sales");

Excluir uma página

Para excluir uma página de um relatório, você pode usar o método deletePage da classe Report ou o método delete da classe Page, dependendo do contexto. O valor retornado é resolvido depois que a página é excluída.

Excluir uma página usando uma instância de relatório

Para excluir uma página de um relatório usando uma instância de Report:

deletePage(pageName: string): Promise<void>

pageName é um identificador exclusivo diferente do displayName. Você pode usar a API report.getPages para obter o pageName.

Por exemplo, exclua uma página com o nome ReportSection123:

await report.deletePage("ReportSection123");

é o a API de retornada para a página vendas do

Excluir uma página usando uma instância de página

Para excluir uma página de um relatório usando uma instância de Page:

delete(): Promise<void>

Por exemplo:

newPage.delete();

Renomear uma página

Para renomear uma página em um relatório, você pode usar o método renamePage da classe Report ou o método setDisplayName da classe Page, dependendo do contexto. O valor retornado é resolvido depois que a página é renomeada.

Renomear uma página usando uma instância de relatório

Para renomear uma página de um relatório usando a instância de Report:

renamePage(pageName: string, displayName: string): Promise<void>

pageName é um identificador exclusivo diferente do displayName. Você pode usar a API report.getPages para obter o pageName.

Por exemplo, renomeie a página com o nome ReportSection123 para New Sales:

report.renamePage("ReportSection123", "New Sales");

é o a API de retornada para a página de Vendas do .

Renomear uma página usando uma instância de página

Para renomear uma página de um relatório usando a instância de Page:

setDisplayName(displayName: string): Promise<void>

Por exemplo, renomeie a página para Novode Vendas:

newPage.setDisplayName("New Sales");

Considerações e limitações

As operações de página funcionam somente depois que o relatório é carregado.

Conteúdo relacionado