Power BI-rapporten exporteren naar PDF-, PPTX- of PNG-bestanden met behulp van REST API's

Power BI beschikt nu over een extra reeks mogelijkheden waarmee u een Power BI-rapport met behulp van een REST-aanroep naar de volgende bestandsindelingen kunt exporteren: PDF, PPTX (PowerPoint) en PNG.

U kunt deze Export-To-File-API op diverse manieren gebruiken:

• De knop Verzenden naar printer maken: Maak in uw toepassing een knop waarmee het exporteren van een taak wordt geactiveerd zodra op die knop wordt geklikt. Met deze taak kan het weergegeven rapport als een PDF of PPTX worden geëxporteerd, en zodra deze taak is voltooid, kunnen gebruikers het bestand als een download ontvangen. Omdat de API niet synchroon werkt, kan het enige tijd duren voordat het bestand beschikbaar is.
• E-mailbijlage: Verzend een automatisch e-mailbericht op ingestelde intervallen met een PDF-rapport in de bijlage. Dit is bijvoorbeeld handig als u het verzenden van wekelijkse rapporten naar de directie wilt automatiseren.

Wanneer de API Export-To-File wordt aangeroepen, wordt hierdoor een exporttaak geactiveerd. Nadat de exporttaak is geactiveerd, gebruikt u de Polling-API om de taak te volgen totdat deze is voltooid. Zodra de exporttaak is voltooid, retourneert de Polling-API een Power BI-URL waarmee het bestand kan worden gedownload (de URL is 24 uur lang beschikbaar). De API biedt ondersteuning voor aanvragen voor gelijktijdige exporttaken; het aantal taken dat u gelijktijdig kunt uitvoeren, hangt af van de SKU waarop uw rapport zich bevindt.

Bij de nieuwe API wordt de volgende reeks mogelijkheden meegeleverd:

• Geselecteerde rapportpagina's exporteren: geef op welke pagina's u wilt exporteren en in welke volgorde.
• Bladwijzers: met behulp van mogelijkheden voor bladwijzers kunt u een rapport met een specifieke status exporteren nadat u hier filters op hebt toegepast.
• RLS (beveiliging op rijniveau): gebruik RLS (beveiliging op rijniveau) om een rapport te exporteren waarin gegevens worden weergegeven die alleen voor bepaalde gebruikers zichtbaar zijn. Als u bijvoorbeeld een verkooprapport exporteert waarin regionale functies zijn gedefinieerd, kunt u het rapport programmatisch filteren zodat alleen een bepaalde regio wordt weergegeven.
• Gegevensbeveiliging: voor de indelingen PDF en PPTX worden vertrouwelijkheidslabels ondersteund. Als u een rapport met een vertrouwelijkheidslabel exporteert naar PDF of PPTX, wordt het rapport in het geëxporteerde bestand weergegeven met het bijbehorende vertrouwelijkheidslabel.
• Lokalisatie: Wanneer u de API gebruikt, hebt u de mogelijkheid om de gewenste landinstellingen door te voeren. De lokalisatie-instellingen hebben invloed op de manier waarop het rapport wordt weergegeven, door bijvoorbeeld de indeling te wijzigen op basis van de geselecteerde landinstelling.

Let op: Zowel het rapport als de gegevensset van het rapport dat u exporteert, moeten zich in een Premium- of Embedded-capaciteit bevinden. Raadpleeg het artikel Rapporten naar een bestand exporteren voor meer informatie over beperkingen.

Houd er ook rekening mee dat de Export-To-File-API, net als alle andere nieuwe Power BI-API's, alleen een functie is van de Power BI APIs .NET SDK v3.

Meer informatie.

<p"> </p">