Zum Hauptinhalt springen

ZIP-Archiv erstellen

Der Schritt ZIP-Archiv erstellen packt beliebig viele Dateien in ein ZIP-Archiv. Das Archiv landet als Dokument in der AutoFlow-Dokumentenbibliothek. Spätere Schritte verwenden es wie das Dokument eines Schritts PDF-Dokument erstellen: als Anhang in E-Mail senden, zum Hochladen mit Azure Blob Storage, als Antwort eines Webhooks oder – mit Datensatz einfügen – als Anhang eines eingehenden Belegs.

Typische Einsatzszenarien:

  • Alle Anhänge eines eingehenden Belegs als eine ZIP-Datei an den Steuerberater schicken.
  • Die PDFs mehrerer gebuchter Rechnungen einsammeln und als ein Archiv hochladen.
  • Eine XML-Datei aus einer HTTP-Anfrage zusammen mit ihrem PDF bündeln.

Archivname​

Der Dateiname des Archivs, z. B. Rechnungen {{workdate}}.zip. Endet der Name nicht auf .zip, wird es angehängt. Lässt du das Feld leer, heißt das Archiv archive.zip.

Dateien​

Jede Zeile legt eine oder mehrere Dateien ins Archiv. Wähle zuerst die Art – sie bestimmt, welche Spalten du ausfüllst:

ArtReferenzInhalt (Base64)Dateiname
AutoFlow-DokumentEin Dokument aus einem früheren Schritt, z. B. {{pdf_Document}}–Optional
Anhang eines eingehenden BelegsEin Anhang eines eingehenden Belegs, z. B. {{find_results}}–Optional
Base64–Der Inhalt als Base64 oder eine binäre Ausgabe wie {{http_responseBody}}Pflicht

Eine Referenz kann auf einen oder auf viele Datensätze zeigen: auf die Ergebnisse eines Schritts Datensätze finden, auf eine Sammlung aus Sammlung erstellen oder auf eine Schleifenvariable. Jeder Datensatz wird zu einer eigenen Datei im Archiv. Zeigt eine Referenz auf einen Datensatz einer anderen Tabelle – etwa auf einen Anhang eines eingehenden Belegs in einer Zeile der Art AutoFlow-Dokument –, bricht der Schritt mit einem Fehler ab.

Dateien aus Referenzen behalten ihren eigenen Namen: den Namen des Dokuments bzw. den Namen des Anhangs mit seiner Dateiendung (Scan 0815.pdf). Trägst du einen Dateinamen ein, gilt dieser. Zeigt die Referenz auf mehrere Datensätze, werden SmartFields im Dateinamen, die mit der Referenz selbst beginnen, für jeden Datensatz einzeln gefüllt: Mit der Referenz {{find_results}} bekommt bei {{find_results.Document No.}}.pdf jede Datei die Nummer ihres eigenen Datensatzes.

Base64-Inhalt wird dekodiert, bevor er ins Archiv kommt. Ein einzelnes SmartField, das bereits binäre Daten enthält – etwa der Antworttext einer HTTP-Anfrage –, wird unverändert übernommen. Ist der Inhalt kein gültiges Base64, bricht der Schritt mit einem Fehler ab, der die Datei nennt.

Ordner im Archiv​

Der Dateiname darf Ordner enthalten: invoices/2026/INV-1001.pdf legt die Datei in den Ordner 2026 innerhalb von invoices. SmartFields funktionieren auch hier, z. B. {{vendor_name}}/{{doc_name}}.pdf.

Endet der Dateiname mit einem Schrägstrich, ist er nur ein Ordner. scans/ in einer Zeile, die auf die Ergebnisse von Datensätze finden zeigt, legt jeden Anhang unter seinem eigenen Namen in den Ordner scans.

Ordnerteile, die aus dem Archiv hinausführen würden – .., ein führender / oder ein Laufwerksbuchstabe wie C: –, werden weggelassen: Aus ../../report.pdf wird report.pdf. Ein Schrägstrich im eigenen Namen eines Dokuments erzeugt nie einen Ordner, er wird durch _ ersetzt.

Dateien mit gleichem Namen​

Würden zwei Dateien im selben Ordner gleich heißen, werden die späteren durchnummeriert: invoice.pdf, invoice (2).pdf, invoice (3).pdf. Groß- und Kleinschreibung zählen dabei nicht. Gleichnamige Dateien in verschiedenen Ordnern behalten ihren Namen.

Fehler, wenn leer​

Standardmäßig an: Liefert keine Zeile eine Datei – etwa weil Datensätze finden nichts gefunden hat –, bricht der Flow mit einem Fehler ab. Schaltest du es aus, läuft der Flow weiter. Der Schritt erstellt dann kein Archiv, und seine Ausgabe created ist false, sodass ein Entscheidung-Schritt einen anderen Weg nehmen kann.

Ausgaben​

AusgabeInhalt
createdtrue, wenn ein Archiv erstellt wurde; false, wenn es nichts zu packen gab und Fehler, wenn leer aus ist.
DocumentDas ZIP-Archiv in der AutoFlow-Dokumentenbibliothek (Content-Type application/zip).
nameDer Dateiname des Archivs.
sizeDie Größe des Archivs in Bytes.
fileCountDie Anzahl der Dateien im Archiv.

Beispiel: alle Anhänge eines eingehenden Belegs versenden​

  1. Datensätze finden auf Incoming Document Attachment, gefiltert auf die lfd. Nr. des eingehenden Belegs. Slug find.
  2. ZIP-Archiv erstellen mit einer Zeile: Art Anhang eines eingehenden Belegs, Referenz {{find_results}}. Archivname {{trigger_record.Document No.}}.zip.
  3. E-Mail senden mit dem Document des Archivs als Anhang.

Gut zu wissen​

  • Das Archiv wird im Arbeitsspeicher gebaut. Archive mit einigen Megabyte sind kein Problem; sehr große (Hunderte Megabyte) können an die Grenzen des Business-Central-Servers stoßen.
  • Jedes Archiv ist ein neues Dokument in der AutoFlow-Dokumentenbibliothek. Brauchst du es nach dem Versenden oder Hochladen nicht mehr, entferne das Document mit Datensatz löschen.