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, oderfilename_outputfehlt. 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
statusundmessage; 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.