Funktion „PDF“ (experimentell)

Gilt für: Canvas-Apps Modellgesteuerte Apps

[Dieser Artikel ist Teil der Dokumentation zur Vorabversion und kann geändert werden.]

Exportiert Inhalte aus dem aktuellen Bildschirm in ein Objekt zur Verwendung in mehreren Szenarien.

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. Weitere Informationen: Verstehen Sie experimentelle, Vorschau- und eingestellte Funktionen in Canvas-Apps
• Das in diesem Artikel beschriebene Verhalten ist nur verfügbar, wenn die experimentelle Funktion PDF-Funktion in Einstellungen > Kommende Funktionen > Experimentell aktiviert ist (ist standardmäßig deaktiviert).
• Ihr Feedback ist wertvoll für uns. Bitte teilen Sie uns Ihre Meinung in den Power Apps Communityforen zu experimentellen Funktionen mit.

Beschreibung des Dataflows

Mit der PDF-Funktion können Sie einen Bildschirm oder Teile eines Bildschirms für den Export in ein PDF-Objekt (Blob) auswählen.

Unterschiedliche Konfigurationsoptionen ermöglichen unterschiedliche Ergebnisse für das resultierende generierte PDF.

Wichtig

• Die PDF-Generierung erfolgt auf dem Gerät, auf dem die App ausgeführt wird. Verschiedene Geräte wie Desktop-Computer und mobile Geräte haben unterschiedliche Kapazitäten, wenn Sie ein PDF generieren.
• Das Generieren einer PDF-Datei mit einer außergewöhnlich großen Dateigröße kann zum Absturz der App führen. Dies hängt von der Kapazität des Geräts ab, auf dem Sie die App ausführen. Beachten Sie die Größe und Anzahl der Bilder und wie viele Daten Sie in das generierte PDF aufnehmen möchten, insbesondere bei Apps, die für die Verwendung auf einem mobilen Gerät vorgesehen sind.

Notiz

• Sie können ein PDF nur aus Inhalten generieren, die auf dem Bildschirm vorhanden sind, auf dem Sie die PDF-Funktion aufgerufen haben. Wenn Sie beispielsweise die PDF-Funktion auf Bildschirm zwei hinzugefügt haben, kann nur der Inhalt auf Bildschirm zwei in das generierte PDF aufgenommen werden.

Syntax

Pdf(Bildschirm- oder Steuerungsname [,{Größe, DPI, Rand, Ausrichtung, ExpandContainers}])

• Bildschirm- oder Steuerungsname – Erforderlich. Der Bildschirm oder das Steuerelement mit dem Inhalt, der zum Generieren der PDF-Datei verwendet werden soll. Unterstützte Steuerelemente: Vertikale Galerie, Vertikaler Layout-Container, Horizontaler Layout-Container, Container, Bildschirm.

• Größe – Optional. Steuert die Abmessungen der generierten PDF-Datei. Der Standardwert hängt vom Gebietsschema des App-Benutzers ab; Letter für die USA und Kanada und A4 für andere Länder.

• DPI – Optional. Steuert die Skalierung/Auflösung der generierten PDF-Datei. Muss einen Wert größer als 0 aufweisen. Inhalte, die den durch die angegebenen Ränder zulässigen Platz überschreiten, können zu einer höheren effektiven DPI führen. Der Standardwert ist 96.

• Rand – Optional. Eine Zeichenfolge, die die Größe des zwischen dem Inhalt und dem äußeren Rand der generierten PDF-Datei reservierten Platzes angibt. Jeder Rand des generierten PDF (oben, rechts, unten, links) kann einen anderen Wert unterstützen. Unterstützte Maßeinheiten für diesen Wert sind Zoll, cm, mm, pt und px. Der Standardwert ist 0,5 Zoll (12,7 mm) für alle Ränder.

• Orientierung – Optional. Steuert, ob die generierte PDF-Datei im Hochformat (vertikal) oder im Querformat (horizontal) ausgerichtet ist. Der Standardwert ist Porträt (vertikal).

• ExpandContainers – Optional. Boolesch. Steuert, ob bestimmte Container mit Inhalten, die ihre zugewiesene Größe überschreiten, erweitert werden, um den gesamten Inhalt im generierten PDF anzuzeigen. Zu den betroffenen Steuerelementen gehören Bildschirme, Container, vertikale und horizontale Container, vertikale Galerien mit fester Höhe (nicht verschachtelt), Formulare und scrollbare Canvas-Steuerelemente. Der Standardwert ist „falsch“.

Beispiele

Formel	Beschreibung	Ergebnis
PDF(Screen1)	Erzeugt ein PDF-Objekt mit den Standardeinstellungen.	Aus den sichtbaren Inhalten von Screen1 wird ein PDF-Objekt erstellt.
PDF(Container1, {Größe: A3})	Erzeugt ein PDF-Objekt mit dem auf A3 eingestellten Papierformat.	Aus dem sichtbaren Inhalt von Container1 wird ein A3-großes PDF-Objekt erstellt.
PDF (Screen1, {DPI: 72, Rand: „25 mm“, Ausrichtung: „Querformat“})	Erzeugt ein PDF-Objekt mit einer auf 72 eingestellten Auflösung (DPI), einem auf 25 Millimeter eingestellten Rand und einer auf Querformat (horizontal) eingestellten Ausrichtung.	Aus dem sichtbaren Inhalt auf Screen1 wird eine PDF-Datei mit den angegebenen DPI-Werten, Rändern und Ausrichtungen in der Standardgröße (abhängig vom Gebietsschema) erstellt.
PDF(Screen1, {ExpandContainers: true})	Erzeugt ein PDF-Objekt mit erweiterten zutreffenden Steuerelementen.	Es wird ein PDF erstellt, in dem alle Container/Galerien mit mehr Inhalt als sichtbar erweitert werden, um den gesamten Inhalt im generierten PDF anzuzeigen.

Bekannte Einschränkungen

• Bestimmte Steuerelemente sind derzeit nicht unterstützt. Dazu gehören Diagramme, Power BI Kachel, Karte und einige Konfigurationen von Drittanbieter PCF Steuerelementen.

• Geschachtelte Gallerien werden nicht unterstützt.

• Nicht-lateinische Schrifttypen und Schriftstärken und -stile wie Fett und Kursiv erscheinen möglicherweise nicht in der generierten PDF-Datei für einige Schriftarten.

• Das Erstellen von ausfüllbaren PDFs wird nicht unterstützt.