PDF-Druck

Mit dem PDF-Druck-Auslöser können Sie einen Flow immer dann ausführen, wenn Business Central ein PDF für einen bestimmten Bericht erzeugt – z. B. um ein Wasserzeichen aufzubringen, einen Briefbogen einzublenden, das PDF in ein Netzwerklaufwerk zu archivieren oder eine Kopie per E-Mail zu versenden. Der Flow läuft synchron innerhalb der Druck-Pipeline und kann entweder das Original-PDF unverändert lassen oder durch eine bearbeitete Version ersetzen.

Typische Einsatzfälle:

• Hinzufügen eines „ENTWURF"-Wasserzeichens zu Rechnungen, die noch nicht freigegeben sind.
• Einblenden des Firmenbriefbogens auf jedem gedruckten Verkaufsauftrag.
• Spiegeln einer Kopie jedes gedruckten PDFs in einen SharePoint-Ordner.
• Protokollieren jedes gedruckten Belegs in einem externen Archiv.

Was passiert, wenn der Flow läuft

1. Eine Benutzerin oder ein Benutzer druckt, speichert, lädt herunter, zeigt in der Vorschau an oder plant einen PDF-Bericht in Business Central. Der Flow reagiert auf jede dieser Aktionen (gefiltert wird über die konfigurierten Berichtszeilen; die auslösende Aktion steht über die Ausgabe Intent zur Verfügung).
2. AutoFlow prüft, ob der Bericht auf den Berichtszeilen des Flows steht, und startet – sofern dessen Ausgabe ein PDF ist (Excel- und Word-Exporte werden ignoriert) – den Flow.
3. Der Flow läuft bis zu einem PDF zurückgeben-Schritt. Wird dieser erreicht, ersetzt das dort übergebene base64-codierte PDF das ursprüngliche Dokument. Endet der Flow ohne diesen Schritt – oder schlägt fehl, oder überschreitet das konfigurierte Zeitlimit – behält Business Central das Original-PDF.
4. Jeder Aufruf wird als reguläre AutoFlow-Ausführung protokolliert. Die vollständige Berichts-Payload (ObjectPayload) wird mitgeloggt, sodass nachvollzogen werden kann, was gedruckt wurde; die Dokument-Bytes selbst werden nicht gespeichert, um das Log schlank zu halten.

Konfiguration des Auslösers

• Berichte – eine Zeile je Bericht, dessen PDF-Ausgaben diesen Flow auslösen sollen. Geben Sie die Berichtsnummer ein (z. B. 1306), sie wird zu „Nummer - Name“ vervollständigt; oder wählen Sie den Bericht über die Assist-Schaltfläche (…). Berichte, die nicht in der Liste stehen, lösen den Flow nie aus.
• Zeitlimit (Sek.) – wie lange der Flow laufen darf, bevor Business Central auf das Original-PDF zurückfällt. Standard 30 Sek. Dies ist die wahrgenommene Wartezeit beim Drucken, halten Sie den Wert daher so kurz wie möglich.

Ein Flow für das ganze Unternehmen

Nur ein veröffentlichter Flow kann diesen Auslöser verwenden. Das Veröffentlichen eines zweiten wird abgelehnt – ergänzen Sie stattdessen weitere Berichtszeilen im bestehenden Flow.

Ausgaben des Auslösers

Im Flow-Body stehen sechs Ausgaben zur Verfügung:

Ausgabe	Beschreibung
ObjectPayload	Die vollständige Berichts-Payload als JSON-Text (Berichts-ID, Layout, Filteransichten, Intent, Run-ID, ...). Über einen Parser-Schritt erreichen Sie auch verschachtelte Felder.
DocumentStream	Das Original-PDF, base64-codiert. Binden Sie diesen Wert an die Eingabe des PDF zurückgeben-Schritts, wenn Sie das Dokument unverändert durchreichen wollen, oder leiten Sie ihn an einen HTTP-Request weiter, der das PDF transformiert.
ReportId	Die Objekt-ID des Berichts (z. B. 1306).
DocumentType	Der MIME-Typ des Dokuments. Aktuell immer application/pdf für ausgelöste Läufe.
LayoutName	Der Name des ausgewählten Berichts-Layouts.
Intent	Was die anwendende Person ausgelöst hat – einer von Print, Preview, Save, Download, Schedule. Nützlich, wenn nur echte Drucke verarbeitet werden sollen.

Beispiel-Flow

Ein Wasserzeichen-Flow für den Bericht „Standardverkauf - Rechnung":

1. Wenn ein PDF gedruckt wird – Berichte: 1306 (Standardverkauf - Rechnung).
2. HTTP-Request – POST auf den Wasserzeichen-Service mit {{TriggerOutputs.DocumentStream}}. Die Antwort ist das mit Wasserzeichen versehene PDF, base64-codiert.
3. PDF zurückgeben – Dokument = {{HttpResponse.body}}.

Beim Druck der Rechnung wird das gedruckte PDF mit Wasserzeichen versehen ausgegeben. Reagiert der Wasserzeichen-Service nicht rechtzeitig, schlägt fehl oder antwortet er gar nicht innerhalb des Zeitlimits, wird die Originalrechnung unverändert gedruckt – ein Fehler wird der anwendenden Person nicht angezeigt.

Wann der Flow nicht ausgelöst wird

• Die Ausgabe des Berichts ist kein PDF (Excel, Word oder andere Formate).
• Ein anderer Subscriber hat bereits ein bearbeitetes PDF erzeugt und Success = true gesetzt. AutoFlow respektiert das und beendet sich.
• Der gerade gedruckte Bericht steht nicht auf den Berichtszeilen des Flows.