Mit der PDF-Funktion arbeiten (experimentell)

2023-04-25

Die PDF-Funktion in Power Apps erzeugt ein PDF-Dokument aus dem Inhalt eines Bildschirms oder bestimmter Arten von Steuerelementen. Sie können die generierte Datei an einen Aktionskonnektor—weitergeben, um sie z. B. mit dem Outlook-Konnektor Office 365 in einer E-Mail zu versenden—oder als Teil eines Automatisierungsszenarios an einen Flow Power Automate.

Wichtig

Dies ist eine Funktion, die in Prüfung ist. Die experimentellen Funktionen sind nicht für die Produktion vorgesehen und weisen möglicherweise eine eingeschränkte Funktionalität auf. Diese Funktionen stehen vor der offiziellen Veröffentlichung zur Verfügung, damit Kunden frühzeitig Zugriff erhalten und Feedback geben können. Verstehen Sie experimentelle, Vorschau- und eingestellte Funktionen in Canvas-Apps.
Sie müssen die PDF-Funktion in Einstellungen > Kommende Funktionen > Experimental aktivieren. Da es sich um eine experimentelle Funktion handelt, ist sie standardmäßig deaktiviert.
Senden Sie Ihr Feedback im Power Apps Communityforum für experimentelle Funktionen.

Die PDF-Funktion aktivieren

Da es sich bei der PDF-Funktion um eine experimentelle Funktion handelt, ist sie standardmäßig deaktiviert. Um sie in Ihren Anwendungen zu verwenden, müssen Sie sie manuell einschalten.

Melden Sie sich bei Power Apps an und erstellen Sie eine Canvas-App oder öffnen Sie eine bestehende App.
Wählen Sie in Power Apps Studio auf der Befehlsleiste Einstellungen aus.
Wählen Sie Neue Funktionen aus.
Auf der Experimentell Registerkarte aktivieren Sie PDF-Funktion.

Verwenden Sie die PDF-Funktion, um eine PDF-Datei zu generieren

Im folgenden Beispiel verwenden wir die PDF-Funktion in der OnSelect-Eigenschaft einer Schaltfläche zum Generieren einer PDF-Datei. Sie können die PDF-Funktion auch in OnVisible, OnHidden oder jeder anderen Verhaltenseigenschaft verwenden.

Wählen Sie eine vorhandene Schaltfläche aus oder fügen Sie Ihrer Canvas-App eine neue Schaltfläche hinzu.
Fügen Sie in der OnSelect-Eigenschaft der Schaltfläche die PDF-Funktion hinzu und geben Sie das Ziel der PDF-Funktion als Parameter ein. Geben Sie die Formel ein: PDF(SubmitInspectionScreen);

In diesem Beispiel zielen wir auf den Bildschirm SubmitInspectionScreen, um eine PDF-Datei aus dem Inhalt des Inspektionsbildschirms unserer Beispielanwendung zu erstellen. Ersetzen Sie ihn durch den Namen eines Bildschirms in Ihrer App.
Wählen Sie Speichern und veröffentlichen aus.

Spielen Sie die App ab und wählen Sie die Schaltfläche, die Sie hinzugefügt haben. Die PDF-Datei wird generiert und zur späteren Verwendung im Speicher gespeichert. Der folgende Abschnitt schlägt einige Möglichkeiten vor, wie Sie mit der PDF-Datei in Ihrer App arbeiten können.

Die PDF-Funktion kann nur auf den aktuell sichtbaren Bildschirm abzielen. Sie können den gesamten Bildschirm passieren, wie in unserem Beispiel, oder weitere Parameter eingeben, um einen Container oder eine Galerie anzugeben, um den zu übergebenden Inhalt zu begrenzen.

Mit der generierten PDF-Datei arbeiten

Sie können die generierte PDF-Datei auf vielfältige Weise verwenden. Hier sind einige, anhand des Beispiels im vorherigen Abschnitt.

Zeigen Sie die Datei mit dem PDF-Viewer-Steuerelement an

Wählen Sie in Ihrer Canvas-App die Schaltfläche, die Sie im vorherigen Beispiel erstellt haben, oder fügen Sie eine neue Schaltfläche hinzu.
Geben Sie in die Eigenschaft OnSelect der Schaltfläche die folgende Formel ein, wobei Sie SubmitInspectionScreen durch den Namen eines Bildschirms in Ihrer Anwendung ersetzen: Set(myPDF, PDF(SubmitInspectionScreen));
Wählen Sie Einfügen > PDF-Viewer (experimentell).
Wählen Sie aus der Eigenschaftenliste die Eigenschaft Document aus und geben Sie dann myPDF aus der Bearbeitungsleiste aus.
Wählen Sie Speichern und veröffentlichen aus.

Spielen Sie die App ab und wählen Sie die Schaltfläche, die Sie hinzugefügt haben. Die PDF-Datei wird generiert, in der Variable myPDF gespeichert und im PDF-Viewer-Steuerelement angezeigt.

Das PDF-Viewer-Steuerelement wird in der generierten PDF-Datei als schwarze Form angezeigt. Um das Steuerelement aus der generierten Datei auszuschließen, platzieren Sie den Inhalt, den Sie in eine PDF-Datei umwandeln möchten, in einem Container oder einer Galerie und zielen Sie darauf anstelle des Bildschirms ab. zum Beispiel PDF(Container1) oder PDF(Gallery1).

Einen Aktions-Konnektor verwenden

In diesem Beispiel generieren wir eine PDF-Datei, die wir mit dem Office 365 Outlook-Konnektor als E-Mail-Anhang versenden.

Wählen Sie in Ihrer Canvas-App die Schaltfläche, die Sie im vorherigen Beispiel erstellt haben, oder fügen Sie eine neue Schaltfläche hinzu.

Geben Sie die folgende Formel in der OnSelect-Eigenschaft der Schaltfläche ein:

Office365Outlook.SendEmailV2( 
   "sample@email.com", 
    "New Safety Inspection" 
    "A new safety inspection has been submitted for your review. Please see attached.", 
    { 
        Attachments: Table( 
             { 
                 Name: "submittedInspection.pdf", 
                 ContentBytes: PDF(SubmitInspectionScreen) 
             } 
         ) 
    } 
 );

Wählen Sie Speichern und veröffentlichen aus.

Spielen Sie die App ab und wählen Sie die Schaltfläche, die Sie hinzugefügt haben. Die PDF-Datei wird generiert und eine E-Mail mit der generierten PDF-Datei im Anhang an die angegebene E-Mail-Adresse gesendet.

In einem Power Automate-Flow verwenden

In diesem Beispiel generieren wir eine PDF-Datei und übergeben sie an einen Power Automate-Flow, der die Datei mithilfe des SharePoint Konnektors in einer Dokumentbibliothek speichert. In diesem Beispiel wird der Standardtrigger PowerApps in Power Automate durch den Trigger PowerApps (V2) ersetzt.

Erstellen Sie einen Flow zur Verwendung in Ihrer App

Wählen Sie in Ihrer Canvas-App die Schaltfläche, die Sie im vorherigen Beispiel erstellt haben, oder fügen Sie eine neue Schaltfläche hinzu.
Wählen Sie im App-Erstellungsmenü Power Automate > Neuen Flow erstellen aus.
Wählen Sie Ohne Vorlage erstellen aus.
Um den standardmäßigen PowerApps Trigger zu löschen, wählen Sie das Triggermenü (…) und dann Löschen aus.
Suchen Sie nach PowerApps (V2), und wählen Sie es aus.
Wählen Sie den PowerApps V2-Trigger aus, um den Flowknoten zu erweitern, und wählen Sie dann Eine Eingabe hinzufügen.
Wählen Sie Datei als Art der Benutzereingabe aus.
Wählen Sie erneut Eingabe hinzufügen und wählen Sie Text für die Art der Benutzereingabe.
Benennen Sie die Eingabe in Dateiname um und ändern Sie die Beschreibung in Bitte geben Sie den Namen der Datei ein.

Fügen Sie den benutzerdefinierten Konnektor SharePoint zum Flow hinzu

Wählen Sie Neuer Schritt aus, um eine neue Aktion hinzuzufügen. Suchen Sie nach SharePoint und wählen Sie Datei erstellen.
Wählen Sie unter Site-Adresse eine SharePoint Site aus, zu der Sie die Berechtigung zum Hinzufügen von Dateien haben.
Wählen Sie unter Ordnerpfad eine Dokumentenbibliothek, zu der Sie Dateien hinzufügen dürfen.
Wählen Sie die Eingabe Dateiname aus. Wählen Sie auf der Registerkarte Dynamische Inhalte einen Dateinamen unter PowerApps (V2).
Wählen Sie die Eingabe Dateiinhalt und dann Dateiinhalt aus der Liste aus.
Wählen Sie Speichern und x in der oberen rechten Ecke aus, um das Fenster Power Automate zu schließen.
Der Power Automate Bereich wird aktualisiert und der neue PowerApps (V2)-Flow Datei erstellen erscheint in der Liste.

Fügen Sie den Flow zu einer Schaltfläche in Ihrer App hinzu

Wählen Sie die Schaltfläche in Ihrer App Canvas aus. Geben Sie in der Eigenschaft OnSelect der Schaltfläche die folgende Formel ein und ersetzen Sie dabei den Flow-Namen und den Namen der generierten PDF-Datei durch Ihren eigenen:
```
'PowerAppV2->Createfile'.Run( 
   "NewInspectionReport.pdf", 
    {         
       file: { 
            name: "NewInspectionReport.pdf", 
            contentBytes: PDF(InspectionDetails) 
        }               
    } 
);  
```
Wählen Sie Speichern und veröffentlichen aus.

Spielen Sie die App ab und wählen Sie die Schaltfläche, die Sie hinzugefügt haben. Der Flow Power Automate wird ausgeführt und fügt die erzeugte PDF-Datei in die Dokumentenbibliothek ein.

Siehe auch

PDF-Funktion in Power Apps (experimentell)

Freigeben über