Exportieren von Power BI-Berichten in PDF-, PPTX- oder PNG-Dateien mithilfe der REST-API

In Power BI stehen nun zusätzliche Funktionen zur Verfügung, mit denen Sie einen Power BI-Bericht mithilfe eines REST-Aufrufs in die folgenden Dateiformate exportieren können: PDF, PPTX (PowerPoint) und PNG.

Diese API zum direkten Exportieren in eine Datei können Sie vielfältig einsetzen:

• Erstellen einer Schaltfläche zum Drucken: In Ihrer Anwendung können Sie eine Schaltfläche erstellen, die einen Exportauftrag auslöst, wenn auf sie geklickt wird. Der Auftrag kann den angezeigten Bericht im PDF- oder PPTX-Format exportieren. Wenn das Exportieren abgeschlossen ist, erhält der Benutzer eine Datei, die er herunterladen kann. Da die API asynchron ist, kann es eine Weile dauern, bis die Datei verfügbar ist.
• E-Mail-Anhang: Sie können festlegen, dass in bestimmten Abständen automatisch eine E-Mail mit einem Bericht im PDF-Format als Anhang gesendet wird. Dies ist besonders dann hilfreich, wenn Sie der Geschäftsleitung wöchentlich automatisch einen Bericht zukommen lassen möchten.

Wenn die API für den Export in Datei aufgerufen wird, löst sie einen Exportauftrag aus. Nachdem der Exportauftrag ausgelöst wurde, können Sie die API zum Abrufen des Status des Exports in Datei verwenden, um nachzuverfolgen, wann der Auftrag abgeschlossen ist. Sobald der Exportauftrag abgeschlossen ist, gibt der Aufruf der API zum Abrufen des Status eine Power BI-URL zurück, über die die Datei abgerufen werden kann. Diese URL steht 24 Stunden lang zur Verfügung. Die API unterstützt Anforderungen gleichzeitiger Exportaufträge. Wie viele Aufträge gleichzeitig ausgeführt werden können, hängt vom Tarif ab, der für den Bericht gilt.

Mit der neuen API stehen die folgenden Funktionen für Sie zur Verfügung:

• Exportieren ausgewählter Berichtsseiten: Sie können angeben, welche Seiten Sie in welcher Reihenfolge exportieren möchten.
• Lesezeichen: Mithilfe von Lesezeichenfunktionen können Sie einen Bericht in einem bestimmten Zustand exportieren, nachdem Sie Filter darauf angewendet haben.
• Sicherheit auf Zeilenebene: Mithilfe der Sicherheit auf Zeilenebene können Sie einen Bericht mit Daten exportieren, die nur für bestimmte Benutzer angezeigt werden. Wenn Sie beispielsweise einen Umsatzbericht exportieren, für den regionale Rollen definiert sind, können Sie den Bericht programmgesteuert filtern, sodass nur Daten für eine bestimmte Region angezeigt werden.
• Datenschutz: Das PDF- und das PPTX-Format unterstützen Vertraulichkeitsbezeichnungen in Power BI. Wenn Sie einen Bericht mit einer Vertraulichkeitsbezeichnung in eine PDF- oder PPTX-Datei exportieren, wird der Bericht in der exportierten Datei mit entsprechender Vertraulichkeitsbezeichnung angezeigt.
• Lokalisierung: Die API bietet Ihnen die Möglichkeit, eine gewünschte Sprache anzugeben. Die Lokalisierungseinstellungen wirken sich auf die Darstellung des Berichts aus, z. B. auf die Formatierung, die entsprechend der ausgewählten Sprache vorgenommen wird.

Beachten Sie, dass sich sowohl der Bericht als auch das dem von Ihnen exportierten Bericht zugehörige Dataset in einer Premium- oder einer eingebetteten Kapazität befinden müssen. Weitere Einschränkungen für die Vorschauversion finden Sie im Artikel Exportieren eines Berichts in eine Datei (Vorschauversion).

Beachten Sie außerdem, dass alle neuen Power BI-APIs und die API zum Exportieren in eine Datei nur in der Version 3 des .NET SDK für Power BI-APIs enthalten sind.

Weitere Informationen.

<p"> </p">