PDF in Graustufen umwandeln

Der Service Task „PDF in Graustufen umwandeln“ konvertiert ein farbiges PDF-Dokument in eine reine Graustufen-Version. So können PDFs vor dem physischen Versand (z. B. über die E-Post-Schnittstelle der Deutschen Post) oder dem Druck automatisch entfärbt werden, ohne dass manuell in externen Tools nachgearbeitet werden muss.

Typische Einsatzszenarien:

Vorbereitung von Rechnungen oder Anschreiben für den Briefdruck
Reduzierung der Dateigröße farbiger Scans für Archivierung und Versand
Standardisierung von Anhängen vor dem Versand per Hybridbrief oder Fax

Konfiguration im Prozess-Designer

Im Prozess-Designer wird über die Schaltfläche „Eingabe-Datei wählen“ ein kleiner Dialog geöffnet. Dort wird ein JSONata-Ausdruck hinterlegt, der bestimmt, welche Datei aus der Prozessnachricht in Graustufen umgewandelt werden soll.

Standardwert: $.document

Weitere Beispiele:

Ausdruck	Bedeutung
`$.document`	Die Datei liegt im Feld `document` der Prozessnachricht.
`$.attachment`	Die Datei liegt im Feld `attachment`.
`$.files[0]`	Erstes Element einer Dateiliste.
`$.invoice.pdf`	Verschachtelter Pfad innerhalb der Prozessnachricht.

Der Ausdruck muss ein Datei-Objekt zurückliefern, das mindestens das Feld referenceId enthält.

Input-Parameter

Aus dem konfigurierten JSONata-Ausdruck wird zur Laufzeit folgender Eingabe-Datensatz für den Service erzeugt:

{
  "referenceId": "abc-123-file-reference",
  "filename": "Rechnung-2026-0001.pdf",
  "contentType": "application/pdf"
}

Erläuterung:

referenceId: Eindeutige Referenz auf das Quell-PDF in der Pantarey-Dateiablage (Pflichtfeld).
filename: Ursprünglicher Dateiname (optional, wird für die Ausgabedatei wiederverwendet).
contentType: MIME-Typ der Quelldatei (optional).

Output

Der Task gibt eine Referenz auf die neu erzeugte Graustufen-PDF zurück.

{
  "referenceId": "xyz-789-grayscale-reference",
  "filename": "Rechnung-2026-0001_grayscale.pdf",
  "contentType": "application/pdf"
}

Erläuterung:

referenceId: Referenz auf das neu erstellte Graustufen-PDF.
filename: Dateiname der erzeugten Datei.
contentType: Immer application/pdf.

JSONata-Beispiele

Auswahl der Eingabedatei aus einem verschachtelten Feld der Prozessnachricht:

$.invoice.generatedPdf

Auswahl des ersten Elements einer Dateiliste:

$.attachments[0]

Hinweise

Es wird nur eine Datei pro Task-Ausführung verarbeitet. Für mehrere Dateien wird eine Schleife (Multi-Instance) verwendet.
Die Eingabedatei muss ein PDF sein.
Der Service erzeugt eine neue Datei – das Original bleibt unverändert in der Ablage erhalten.
Bei Schleifen (Loop / Multi-Instance) wird der JSONata-Ausdruck pro Iteration neu ausgewertet, sodass für jede Instanz die passende Datei ausgewählt werden kann.

Tipp

In Kombination mit dem Service E-Post versenden (Deutsche Post Hybridbrief) kann ein durchgängiger Versand-Workflow gebaut werden: PDF erzeugen → in Graustufen umwandeln → als Hybridbrief versenden. Damit werden Farbseiten- Aufpreise zuverlässig vermieden.

Zum Testen von JSONata-Ausdrücken hilft der JSONata Playground.