Base64-Kodierung mehrerer Binärdateien über benutzerdefinierten Code - n8n-Workflow

Entwickler, die mehrere Dateien an eine API hochladen müssen, die strikt eine Base64-Kodierung verlangt.
n8n-Benutzer, die erweiterte Operationen mit Binärdateien benötigen, die über die Standard-n8n-Nodes hinausgehen.
Automatisierungsspezialisten, die nach robusten n8n-Vorlagen für DateiKonvertierungsaufgaben suchen.
Alle, die daran interessiert sind, die Leistungsfähigkeit des n8n Code-Nodes für die Datenverarbeitung zu nutzen.

Diese spezialisierte n8n-Workflow-Vorlage adressiert eine häufige Integrationsherausforderung: die Verarbeitung von ZIP-Archiven, die mehrere Binärdateien enthalten, und deren Umwandlung in Base64-Strings für die API-Nutzung. Während Standard-n8n-Nodes die Base64-Kodierung einzelner Dateien gut handhaben, erfordert die Stapelverarbeitung benutzerdefinierte Logik. Dieser n8n-Workflow bietet eine robuste Lösung, indem er das Herunterladen von Dateien, die Dekomprimierung und einen sorgfältig erstellten n8n-Node, der JavaScript ausführt, kombiniert, um über die extrahierten Binärdaten zu iterieren und die notwendige Kodierung durchzuführen. Wenn Sie häufig mit komprimierten Daten arbeiten und deren Inhalt effizient umwandeln müssen, ist diese n8n-Vorlage ein unverzichtbarer Bestandteil Ihres Werkzeugkastens.

Der gesamte Prozess wird durch einen einfachen manuellen n8n-Trigger gestartet, was das Testen und Bereitstellen erleichtert.

1. Start: Der n8n-Trigger „When clicking ‘Execute workflow’“ (Bei Klick auf „Workflow ausführen“) startet den Automatisierungslauf.


2. Download: Ein HTTP Request n8n-Node lädt eine Beispiel-ZIP-Datei herunter, die die zu verarbeitenden Dateien enthält.


3. Dekomprimieren: Der nachfolgende Compression (Unzip) n8n-Node verarbeitet die heruntergeladene Binärdatei automatisch, entpackt den Inhalt und gibt für jede in der ZIP-Datei gefundene Datei ein separates Item aus, jeweils mit eigener Binärdaten-Eigenschaft.


4. Kodieren (Benutzerdefinierter Code): Die Kernfunktionalität befindet sich im Code-n8n-Node „Encode to base64“. Dieser Node verwendet benutzerdefiniertes JavaScript, um über die mehreren Binär-Items zu iterieren, die vom Unzip-n8n-Node erzeugt wurden. Für jedes Item wird die eingebaute Funktion this.helpers.getBinaryDataBuffer verwendet, um die Dateidaten sicher als Puffer abzurufen. Dieser Puffer wird dann in einen Base64-String umgewandelt, und die Ausgabe wird ordentlich für nachfolgende n8n-Nodes strukturiert, wobei der Dateipfad und die kodierten Daten bereitgestellt werden.

Um diese leistungsstarke n8n-Workflow-Vorlage zu verwenden, folgen Sie diesen Schritten:

1. Importieren: Kopieren Sie die bereitgestellten JSON-Daten und navigieren Sie zu Ihrer n8n-Instanz.


2. Klicken Sie auf „New“ (Neu) und dann auf „Import from JSON“ (Aus JSON importieren) und fügen Sie den Code ein.


3. Keine Anmeldeinformationen: Dieser spezielle n8n-Workflow erfordert keine externen Anmeldeinformationen, da er öffentliche URLs und interne n8n-Nodes (HTTP Request, Code, Manual Trigger) verwendet.


4. Ausführung: Klicken Sie auf die Schaltfläche des „Execute Workflow“ (Workflow ausführen) n8n-Triggers, um den Prozess sofort zu testen.


5. Anpassung: Passen Sie den n8n-Node „Download n8n demo website zip“ an, um auf Ihre spezifische ZIP-Quelldatei-URL zu verweisen und so den n8n-Workflow an Ihre Bedürfnisse anzupassen. Wenn Ihre Ziel-API eine andere Ausgabe-Struktur erfordert, passen Sie die JavaScript-Logik im Code-n8n-Node entsprechend an.

Dieser n8n-Workflow stützt sich auf drei Haupt-n8n-Nodes, um die Datei-Verarbeitung und Konvertierung zu realisieren:

When clicking ‘Execute workflow’ (Manual Trigger n8n Trigger)
Funktion: Dient als Startpunkt für diesen On-Demand-n8n-Workflow.
Wichtige Konfiguration: Keine Konfiguration erforderlich; es fungiert als einfacher manueller n8n-Trigger.

Download n8n demo website zip (HTTP Request n8n Node)
Funktion: Lädt die Quell-ZIP-Datei aus einem entfernten GitHub-Repository herunter. Dies liefert die für die Verarbeitung benötigten Binärdaten.
Wichtige Konfiguration: Die URL ist auf https://github.com/n8n-io/n8n-demo-website/archive/refs/heads/main.zip gesetzt. Das Antwortformat ist entscheidend; es muss auf file gesetzt werden, um die Daten als Binärdaten zu behandeln.

Unzip (Compression n8n Node)
Funktion: Dekomprimiert die heruntergeladene ZIP-Datei. Dies ist entscheidend, da es ein Eingabe-Item (die ZIP) in mehrere Ausgabe-Items (die Dateien innerhalb der ZIP) umwandelt und diese für die Stapelverarbeitung durch den nächsten n8n-Node vorbereitet.
Wichtige Konfiguration: Verwendet die Standardeinstellungen für die Dekomprimierung.

Encode to base64 (Code n8n Node)
Funktion: Iteriert über alle Binärdateien, die vom Unzip-n8n-Node erzeugt wurden. Es verwendet benutzerdefiniertes JavaScript und n8n-Helfer (this.helpers.getBinaryDataBuffer), um den rohen Puffer jeder Datei abzurufen und diesen Puffer dann in einen Base64-String umzuwandeln, wobei die Ergebnisse in einem strukturierten JSON-Array zusammengestellt werden.
Wichtige Konfiguration: Enthält die benutzerdefinierte Logik für die Base64-Kodierung, was eine effiziente Verarbeitung mehrerer Binärdateien in einem einzigen Schritt innerhalb des n8n-Workflows gewährleistet.