Zum Inhalt

PDF-Dateien zusammenführen

Der Service-Task „PDF-Dateien zusammenführen“ fügt mehrere PDF-Dateien in der angegebenen Reihenfolge zu einer einzigen PDF-Datei zusammen. Seitengrößen und Inhalte bleiben wie in den Ausgangsdateien; ein Dokument mit gemischten Formaten (etwa A4, Letter quer und A5) ist erlaubt. Das Ergebnis ist ein neues Datei-Objekt, das im weiteren Prozess versendet, abgelegt oder an einen Datensatz gehängt wird.

Technischer Name prio_combinePDFs · Kategorie im Dialog „Service-Task auswählen“: Dokumente & PDF


Wann wird dieser Service verwendet?

  • Angebotsmappe: Die Musterfirma GmbH hängt an jedes Angebot die AGB und das Datenblatt der angebotenen Hardware an und verschickt eine einzige Datei.
  • Rechnung mit Anlagen: Rechnung, Leistungsnachweis und Stundenzettel einer Schulung werden zu einem Dokument für den Kunden zusammengefasst.
  • Akte bilden: Mehrere im Prozess erzeugte oder hochgeladene PDFs werden vor der Ablage in SharePoint zu einem Dokument gebündelt.

Eingabe

Feld Typ Pflicht Bedeutung
pdfsToCombine Liste von Datei-Objekten ja Die PDF-Dateien in der Reihenfolge, in der sie im Ergebnis erscheinen sollen. Jedes Element ist ein Datei-Objekt {referenceId, filename, contentType}, wie es Uploads und andere Services liefern.
filename_output Text ja Dateiname des Ergebnisses, mit Endung .pdf. Fehlt der Name, bricht der Schritt mit einem Fehler ab.
{
  "pdfsToCombine": [ angebot_pdf, agb_pdf, datenblatt_pdf ],
  "filename_output": "Angebot-" & angebotsnummer & "-komplett.pdf"
}

Die Liste muss aus Datei-Objekten bestehen, nicht aus Dateinamen oder Pfaden. Eine Liste von Texten führt zu dem Fehler expected a reference object like { referenceId, filename, contentType }, got string.


Ausgabe

Das Ergebnis ist ein Datei-Objekt:

{
  "referenceId": "01JC…",
  "filename": "Angebot-AN-2026-0142-komplett.pdf",
  "contentType": "application/pdf"
}

Mit einem Ergebnispfad wie angebot_komplett_pdf steht die Datei den folgenden Schritten unter diesem Namen zur Verfügung. Ohne Ergebnispfad ersetzt das Datei-Objekt die gesamte Nachricht.


Fehler und Verhalten

  • Der Service wirft bei jedem Fehler: eine Referenz zeigt ins Leere (Es wurde keine Datei unter der Referenz "01J…" gefunden.), ein Element ist kein Datei-Objekt, eine Datei ist kein lesbares PDF, oder filename_output fehlt. Hängt am Schritt ein Fehler-Randereignis, läuft der Vorgang dort weiter; sonst ist er fehlgeschlagen, ein Wiederaufsetzpunkt wird gespeichert und der Prozessverantwortliche erhält die Fehler-Mail, siehe Fehler.
  • Es gibt keine Rückgabe mit status und message; der Prozess läuft nur weiter, wenn die Datei erzeugt wurde.
  • Der Service läuft in einer eigenen Ausführungsumgebung ohne zentrale Wiederholung; da keine externen Dienste beteiligt sind, gibt es keine vorübergehenden Fehler, die eine Wiederholung sinnvoll machen. Die Zeitgrenze liegt bei 900 Sekunden.
  • Mit einem Besitzer-Passwort geschützte PDFs werden übernommen. Temporäre Dateien werden nach jedem Lauf gelöscht.
  • Im Dry Run wird der Service nicht aufgerufen; es wird eine Mock-Ausgabe aus dem Katalog verwendet.

Beispiel

Die Musterfirma GmbH erzeugt im Angebotsprozess zuerst mit PDF erstellen aus Template das Angebot (Ergebnispfad angebot_pdf). Die AGB und das Datenblatt liegen als Datei-Objekte agb_pdf und datenblatt_pdf in der Nachricht, weil sie aus einem Datensatz gelesen wurden.

Input-Ausdruck des Schritts „Mappe zusammenstellen“:

{
  "pdfsToCombine": [ angebot_pdf, agb_pdf, datenblatt_pdf ],
  "filename_output": "Angebot-" & angebotsnummer & "-komplett.pdf"
}

Ergebnispfad: angebot_komplett_pdf

Ausgabe in der Nachricht:

{
  "angebot_komplett_pdf": {
    "referenceId": "01JC…",
    "filename": "Angebot-AN-2026-0142-komplett.pdf",
    "contentType": "application/pdf"
  }
}

Der nächste Schritt E-Mail senden (Microsoft Graph) hängt angebot_komplett_pdf als Anhang an und schickt die Mappe an den Kunden.


Häufige Fragen

Der Schritt bricht ab, obwohl alle Dateien vorhanden sind.

Meist fehlt filename_output. Der Katalog führt das Feld als optional, der Service braucht es aber in jedem Fall. Zweite Ursache: Die Liste enthält Dateinamen oder Pfade statt Datei-Objekten.

Wie wird die Reihenfolge bestimmt?

Die Seiten erscheinen in der Reihenfolge der Liste pdfsToCombine. Eine Sortierung erfolgt im Input-Ausdruck, etwa mit $sort() nach einem Feld des Datensatzes.

Gibt es eine Größengrenze?

Die Dateien werden im Arbeitsspeicher und im temporären Speicher der Ausführungsumgebung verarbeitet. Eine feste Grenze ist nicht konfiguriert; sehr große Dokumente sollten vorab getestet werden.


Nächster Schritt

E-Mail senden (Microsoft Graph): die zusammengeführte Datei als Anhang versenden.