Exportar relatórios do Power BI para ficheiros PDF, PPTX ou PNG com a API REST

O Power BI tem agora um conjunto adicional de capacidades que permitem exportar um relatório do Power BI através de uma chamada REST para os seguintes formatos de ficheiro: PDF, PPTX (PowerPoint) e PNG.

Utilize esta API de Exportação para Ficheiro de várias formas:

• Crie um botão de envio para impressão — Na sua aplicação, crie um botão que, quando clicado, aciona uma tarefa de exportação. A tarefa pode exportar o relatório visualizado como PDF ou PPTX e, quando estiver concluída, o utilizador pode receber o ficheiro como transferência. Como a API é assíncrona, pode demorar algum tempo até o ficheiro estar disponível.
• Enviar anexo por e-mail — Envie um e-mail automatizado em intervalos definidos com um relatório PDF anexado. Isto pode ser útil se quiser automatizar o envio de um relatório semanal aos executivos.

Quando a API de Exportação para Ficheiro é chamada, aciona uma tarefa de exportação. Depois de acionar a tarefa de exportação, utilize a API de Consulta para acompanhar a tarefa até estar concluída. Quando a tarefa de exportação estiver concluída, a chamada à API de Consulta devolve um URL do Power BI para obter o ficheiro (o URL está disponível durante 24 horas). A API suporta os pedidos de tarefa de exportação simultâneos (o número de tarefas que pode executar simultaneamente depende do SKU em que reside o relatório).

É fornecido o conjunto de capacidades seguinte com a nova API:

• Exporte páginas de relatório selecionadas — Especifique quais as páginas que quer exportar e em que ordem.
• Marcadores — Através das capacidades dos marcadores, pode exportar um relatório num estado específico após a aplicação de filtros.
• Segurança ao nível da linha (RLS) — Utilize a segurança ao nível da linha (RLS) para exportar um relatório que mostre dados visíveis apenas para certos utilizadores. Por exemplo, se estiver a exportar um relatório de vendas definido com funções regionais, pode filtrar programaticamente o relatório para que seja apresentada apenas uma determinada região.
• Proteção de dados — Os formatos PDF e PPTX suportam etiquetas de confidencialidade. Se exportar um relatório com uma etiqueta de confidencialidade para um ficheiro PDF ou PPTX, o ficheiro exportado apresentará o relatório com a respetiva etiqueta de confidencialidade.
• Localização — Através da API, pode transmitir o local desejado. As definições de localização afetam a forma como o relatório é apresentado, por exemplo, ao alterar a formatação de acordo com a região selecionada.

Tenha em atenção que tanto o relatório como o conjunto de dados do relatório que está a exportar têm de residir numa capacidade premium ou incorporada. Estão detalhadas outras limitações de pré-visualização no artigo Export report to file (Exportar relatório para ficheiro).

Esteja também ciente de que, tal como todas as novas APIs do Power BI, a API de Exportação para Ficheiro está incluída apenas no SDK .NET v3 das APIs do Power BI.

Saiba mais.

<p"> </p">