PDF-Druck
Verfügbar ab dem ersten kostenpflichtigen AutoFlow-Plan.
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
- 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 den konfigurierten Bericht; die auslösende Aktion steht über die Ausgabe
Intentzur Verfügung). - AutoFlow lädt den konfigurierten Bericht und startet – sofern dessen Ausgabe ein PDF ist (Excel- und Word-Exporte werden ignoriert) – den Flow.
- 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.
- 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
- Berichts-ID – wählen Sie den Bericht, dessen PDF-Ausgaben diesen Flow auslösen sollen. Ein veröffentlichter Flow pro Bericht; ein zweiter Flow für denselben Bericht wird beim Veröffentlichen abgelehnt.
- 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.
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":
- Wenn ein PDF gedruckt wird – Berichts-ID
1306. - HTTP-Request –
POSTauf den Wasserzeichen-Service mit{{TriggerOutputs.DocumentStream}}. Die Antwort ist das mit Wasserzeichen versehene PDF, base64-codiert. - 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 = truegesetzt. AutoFlow respektiert das und beendet sich. - Die konfigurierte Berichts-ID stimmt nicht mit dem gerade gedruckten Bericht überein.
- Die Lizenz des Mandanten enthält den PDF-Druck-Auslöser nicht mehr (die Prüfung erfolgt sowohl beim Veröffentlichen des Flows als auch zur Laufzeit, falls sich die Lizenz später ändert).