Dieses Opensource-Projekt löst ein Problem von n8n: Erzeugt man per FileConverter Node Excel-Files (XSLX), werden diese unformatiert ausgegeben. Die XLSX-Styler API korrigiert das automatisch. Das Ganze kommt im Docker-Container, ideal für dein selbst gehostetes n8n.
Wozu die n8n Excel XLSX-Styler API?
Um XLSX-Dateien zu stylen gibt es bereits entsprechende JavaScript-Lösungen. Diese müssen jedoch im n8n Webspace installiert werden.
Das bedeutet: Wenn Du n8n als Docker Container betreibst, muss dieser dazu modifiziert werden, was Updates erschwert.
Eine externe API, in einem separaten Container, ist daher die bessere Lösung.
Die XLSX-Styler API macht aus der unformatierten n8n FileConverter Node Output:
Diese XLSX-Datei:
Die erzeugte Excel XLSX-Datei hat folgende Features:
- Automatische Anpassung aller Spalten auf die Breite des jeweiligen Inhalts.
- Freeze und Styling der Header-Zeile.
- Erzwingen Großschreibung der Spaltenüberschriften, da n8n hier die JSON Feldnamen in CamelCase übermittelt.
- Aktivieren der Filterfunktion aller Spalten.
- Zeilen werden alternierend eingefärbt.
- Anpassen von Font und Schriftgröße des gesamten Dokuments.
Die Excel XLSX-Styler API konsumiert Excel-Binärdaten und liefert das selbe Format zurück.
Die Excel XLSX-Styler API in n8n nutzen
Den Sourcecode samt Anleitung zum Bau des Docker-Containers der XLSX-Styler API findest Du hier.
Die XLSX-Styler API baust Du in n8n wie folgt ein:
Erstelle eine neue HttpRequest Node und füge diese zwischen der FileConverter Node und deiner Output Node ein:
Die XLSX-Styler API Node konfigurierst Du wie folgt:
Solltest Du n8n nicht als Docker-Container betreiben, muss die URL auf die jeweilige IP des Servers umgestellt werden.
n8n XLSX-Styler API in Plesk integrieren
Die Integration in eine bestehende Docker-Umgebung unter Plesk gestaltet sich einfach:
- Importiere das XLSX-Styler API Docker Image.
- Erzeuge einen Container.
- Setze die Environment-Variablen AUTH_USER und AUTH_PASSWORD
- Setze Auto-Start auf AN
- Setze automatisches Port-Mapping auf AUS, d.h. Port 9966 wird auf Port 9966 gemapped.
Danach musst Du noch eine neue Plesk Firewall-Regel hinzufügen, damit der n8n-Container auf den XLSX-Styler API Container zugreifen kann:
- Incoming TCP Traffic
- Port: 9966
- Allowed IPs: 172.17.0.1/16 und 127.0.0.1
Damit steht hübschen Excel-Sheets unter n8n nichts mehr im Weg :-)
