N8N-Import-Workflow JSON: Vollständige Anleitung + Dateiformatbeispiele 2025
Erfahren Sie, wie Sie Workflow-JSON-Dateien effektiv in N8N importieren, häufige Herausforderungen meistern, Anmeldeinformationen verwalten und Best Practices für die Sicherheit anwenden.
N8N ist ein leistungsfähiges Tool zur Workflow-Automatisierung die es Benutzern ermöglicht, Prozesse plattformübergreifend zu optimieren. Seine Workflow-JSON importieren Die Funktion ermöglicht strukturierte JSON-Exporte und -Importe und macht die manuelle Neuerstellung von Workflows überflüssig. Dadurch bleiben Konfigurationen, Verbindungen und Knoteneinstellungen erhalten, was Fehler reduziert und Zeit spart. Ob Sie Workflows teamübergreifend standardisieren oder Konfigurationen sichern – das Verständnis der Struktur und des Prozesses des JSON-Imports ist der Schlüssel zur Maximierung der Effizienz.
Mit JSON-Dateien lassen sich Workflows problemlos übertragen. Allerdings treten häufig Herausforderungen wie fehlende Übereinstimmung der Anmeldeinformationen und Versionskompatibilität auf. Die Lösung dieser Probleme erfordert sorgfältige Vorbereitung, z. B. die Validierung von JSON-Strukturen, die Sicherstellung vorkonfigurierter Anmeldeinformationen und die Überprüfung der Versionskompatibilität. Tools wie Latenknoten bieten eine reibungslosere Alternative, indem sie Abhängigkeiten und Kompatibilitätsprüfungen automatisch handhaben und so den Aufwand beim Teilen von Workflows über Umgebungen hinweg sparen.
So bewältigen Sie häufige Importprobleme und nutzen die JSON-Funktionalität des N8N-Workflows optimal.
So importieren Sie einen JSON-Workflow in n8n (Schritt-für-Schritt-Anleitung)
N8N-Workflow-JSON-Struktur
Die n8n-Workflow im JSON-Format spielt eine zentrale Rolle für reibungslose Workflow-Importe. Selbst kleine Strukturfehler in der JSON-Datei können den gesamten Prozess stören. Jedes Element in der Datei ist sorgfältig gestaltet, um die Konfiguration und Logik Ihrer Automatisierung präzise zu reproduzieren.
Schlüsselkomponenten des JSON-Schemas
Der Erfolg des Importvorgangs hängt von vier Hauptelementen ab, die jeweils zur genauen Wiederherstellung des Workflows in seiner ursprünglichen Form beitragen.
Knoten-Array bildet das Rückgrat jeder Workflow-JSON-Datei. Dieser Abschnitt definiert die Konfiguration jedes Knotens, einschließlich Typ, Parameter und Position. Er stellt sicher, dass sowohl die Funktionalität als auch die visuelle Anordnung des Workflows im n8n-Editor erhalten bleiben.
Die Connections-Objekt hält die Workflow-Logik zusammen. Es bildet den Datenfluss zwischen Knoten mithilfe strukturierter Verbindungen ab. Jede Verbindung gibt die Ausgabe des Quellknotens, die Eingabe des Zielknotens und den Typ der zu übertragenden Daten an. Verbindungen werden mithilfe von Knotennamen als Schlüssel und Arrays von Verbindungsobjekten als Werte definiert. Wenn diese Verbindungen nicht richtig konfiguriert sind, wird der Workflow als Sammlung getrennter Knoten importiert, was manuelle Korrekturen erfordert.
Referenzen Verknüpfen Sie Knoten mit den für externe Integrationen erforderlichen Authentifizierungseinstellungen. Diese Referenzen basieren auf Anmeldeinformations-IDs, anstatt vertrauliche Authentifizierungsdaten direkt zu speichern. Die JSON-Datei enthält Anmeldeinformationsnamen und -typen. Es ist jedoch wichtig sicherzustellen, dass die erforderlichen Anmeldeinformationen in der Zielumgebung vorkonfiguriert sind.
Workflow-Metadaten Enthält wichtige Details wie Workflow-Name, Beschreibung, Aktivierungsstatus und Versionsinformationen. Diese Metadaten stellen sicher, dass der Workflow in der n8n-Oberfläche korrekt angezeigt wird und seine Betriebseinstellungen beibehält. Sie enthalten außerdem Zeitstempel für Erstellung und Änderung, was die Versionsverfolgung erleichtert.
Erforderliche und optionale Felder
Der Importvorgang überprüft bestimmte Felder. Fehlende Pflichtfelder verhindern den Import des Workflows. Wenn Sie wissen, welche Felder obligatorisch und welche optional sind, sparen Sie Zeit und reduzieren die Fehlerbehebung.
| Feldkategorie | Erforderliche Eigenschaften | Optionale Eigenschaften |
|---|---|---|
| Stammebene | Knoten, Verbindungen, Name | aktiv, Einstellungen, statische Daten |
| Knotenobjekte | ID, Name, Typ, Position | Parameter, Anmeldeinformationen, deaktiviert |
| Verbindungsarrays | Knoten, Typ, Index | Ausgabeindex, Eingabeindex |
| Metadaten | erstellt am, aktualisiert am | Tags, Pin-Daten, Versions-ID |
Erforderliche Eigenschaften sind für einen erfolgreichen Import nicht verhandelbar. Beispielsweise die nodes Array darf nicht leer sein, und jeder Knoten innerhalb des Workflows muss eine eindeutige id.
Optionale Eigenschaftenist zwar nicht unbedingt für den Import erforderlich, kann aber die Funktionalität des Workflows verbessern. Beispielsweise kann die active Das Feld bestimmt, ob der Workflow standardmäßig aktiviert ist. Wenn es weggelassen wird, wird standardmäßig false. Ebenso können Knoten leere parameters Objekte, wenn die Standardeinstellungen ausreichen. Dies kann jedoch zu Workflows führen, die nach dem Import zusätzliche Konfigurationen erfordern.
Handhabung Referenzen ist oft einer der schwierigsten Teile von Freigabe-Workflows. Während Knoten, die eine Authentifizierung erfordern, auf diese Referenzen angewiesen sind, müssen die tatsächlichen Anmeldeinformationen in der Zielumgebung manuell neu erstellt werden. Diese Abhängigkeit kann zu erheblichen Herausforderungen während der n8n-Import-Workflow aus JSON-Datei Prozess, da fehlende Anmeldeinformationen die ordnungsgemäße Ausführung des Workflows verhindern, selbst wenn der Import selbst ohne Fehler abgeschlossen wird.
Um häufige Importfehler zu vermeiden, ist es wichtig, die Unterschiede zwischen erforderlichen und optionalen Feldern zu verstehen. Darauf wird später noch näher eingegangen.
Schritt-für-Schritt-Importvorgang
Der Prozess des Importierens einer n8n-Workflow-JSON-Datei erfordert sorgfältige Vorbereitung und Liebe zum Detail. Fehler, insbesondere bei Referenzen, können zu Komplikationen führen. Daher ist es wichtig, die Schritte genau zu befolgen.
Voraussetzungen für den Import von Workflows
Vor dem Importieren einer JSON-Datei in n8n müssen bestimmte Bedingungen erfüllt sein, um ein reibungsloses und fehlerfreies Erlebnis zu gewährleisten.
- Administrativer Zugriff und Berechtigungen: Stellen Sie sicher, dass Ihre n8n-Instanz über Administratorrechte verfügt. Diese Berechtigungen sind für die Erstellung neuer und die Änderung bestehender Workflows unerlässlich. Ohne diese Berechtigungen kann der Import möglicherweise nur teilweise abgeschlossen werden, sodass Workflows unvollständig oder nicht funktionsfähig bleiben.
- JSON-Dateivalidierung: Stellen Sie sicher, dass die JSON-Datei des Workflows dem n8n-Schema entspricht. Entfernen Sie vertrauliche Details wie Anmeldenamen, IDs und Authentifizierungsheader aus HTTP-Anforderungsknoten. Dieser Schritt schützt nicht nur Ihre Daten, sondern bewahrt auch die strukturelle Integrität der Datei. [1].[2]..
- Versionskompatibilitätsprüfung: Stellen Sie sicher, dass Ihre n8n-Version die in der JSON-Datei referenzierten Knoten und Konfigurationen unterstützt. Das Importieren von Workflows mit inkompatiblen Knoten kann zu Fehlern führen. [4]..
- Sicherungsverfahren: Sichern Sie immer Ihre aktuellen Workflows, bevor Sie neue importieren. Diese Vorsichtsmaßnahme schützt vor unbeabsichtigtem Datenverlust oder dem Überschreiben bestehender Workflows. [3]..
Sobald diese Voraussetzungen erfüllt sind, können Sie den Importvorgang über die n8n-Schnittstelle starten.
Importieren einer Workflow-JSON-Datei
Das Importieren eines Workflows umfasst mehrere Schritte, die nacheinander ausgeführt werden müssen, um sicherzustellen, dass der Vorgang erfolgreich ist.
- Zugriff auf die Importschnittstelle: Starten Sie von Ihrem n8n-Dashboard aus. Navigieren Sie zum Bereich „Workflows“ und wählen Sie die Importoption. Laden Sie die JSON-Datei hoch. Das System leitet dann automatisch einen Validierungsprozess ein.
- Datei-Upload und Validierung: Sobald die JSON-Datei hochgeladen ist, prüft n8n sie auf Pflichtfelder und strukturelle Integrität. Dieser Prozess identifiziert fehlende Knoten, ungültige Verbindungen oder Schemaverletzungen. Achten Sie genau auf Warnungen oder Fehler, da diese die Funktionalität des Workflows beeinträchtigen können.
- Importbestätigung und -prüfung: Vor Abschluss des Imports stellt n8n eine Zusammenfassung des Workflows bereit. Diese enthält Details wie die Anzahl der Knoten und festgestellte Kompatibilitätsprobleme. Nutzen Sie diese Gelegenheit, um die Datei zu überprüfen und den Import gegebenenfalls abzubrechen.
Für Benutzer, die n8n in einem Container-Setup ausführen, können zusätzliche Schritte erforderlich sein. Wenn Sie Docker, stellen Sie die richtigen Eigentümer und Berechtigungen sicher, indem Sie den folgenden Befehl ausführen:
docker <span class="hljs-built_in">exec</span> -it -u node n8n n8n import:workflow --input=workflows.json
Dieser Befehl stellt sicher, dass Workflows korrekt in die Docker-Umgebung importiert werden [5]..
Schritte nach dem Import
Sobald der Workflow erfolgreich importiert wurde, gibt es mehrere Folgeaufgaben, um ihn an Ihre spezifische Umgebung anzupassen.
- Anmeldeinformationskonfiguration: Importierte Workflows enthalten Verweise auf Anmeldeinformationen, jedoch nicht die eigentlichen Authentifizierungsdaten. Sie müssen alle erforderlichen Anmeldeinformationen im Abschnitt „Anmeldeinformationen“ von n8n manuell neu erstellen und konfigurieren.
- Überprüfung der Knotenparameter: Überprüfen Sie die Konfiguration aller importierten Knoten. Passen Sie deren Parameter nach Bedarf an Ihre Umgebung und Anforderungen an.
- Verbindungstests und -validierung: Führen Sie Tests des Workflows durch, um sicherzustellen, dass er wie vorgesehen funktioniert. Achten Sie besonders auf bedingte Pfade und Fehlerbehandlungsmechanismen, um Probleme zu identifizieren und zu beheben.
- Überprüfung der Vorlagendokumentation: Wenn der Workflow mit Dokumentation geliefert wird, überprüfen Sie diese, um seinen Zweck, seine Abhängigkeiten und seine Einrichtungsanforderungen zu verstehen [3]..
- Versionsaktualisierungen und Wartung: Suchen Sie nach neueren Versionen der Workflow-Vorlage, da Updates Korrekturen oder Verbesserungen enthalten können. Durch die Aktualisierung der Workflows können Kompatibilitätsprobleme bei der Weiterentwicklung von n8n vermieden werden. [3]..
Handhabung und Sicherheit von Anmeldeinformationen
Beim Importieren von Workflow-JSON-Dateien treten häufig Probleme mit Anmeldeinformationen auf, die die Automatisierung und Bereitstellung beeinträchtigen können. Diese Herausforderungen ergeben sich aus dem instanzspezifischen Anmeldeinformationsverwaltungssystem von n8n. Jede Installation verwendet eine eigene Anmeldeinformationsdatenbank mit eindeutigen internen IDs, was die nahtlose gemeinsame Nutzung von Workflows in verschiedenen Umgebungen erschwert.
Häufige Probleme mit Anmeldeinformationen
Während des Workflow-Imports können verschiedene Probleme im Zusammenhang mit Anmeldeinformationen auftreten, die jeweils einen manuellen Eingriff zur Lösung erfordern:
- Fehlende Anmeldeinformationen: Der Workflow kann auf Anmeldeinformationen verweisen, die in der Zielinstanz nicht vorhanden sind. Die JSON-Datei enthält zwar Anmeldeinformationen und IDs aus der ursprünglichen Umgebung, diese Kennungen sind in einer neuen Umgebung jedoch bedeutungslos. Daher zeigen Knoten unmittelbar nach dem Import Fehler an, und die Anmeldeinformationen müssen manuell neu zugewiesen werden, damit der Workflow funktioniert.
- Ungültige Anmelde-IDs: Auch wenn die Anmeldeinformationen in den Umgebungen übereinstimmen, unterscheiden sich ihre internen IDs. Diese Nichtübereinstimmung führt zu fehlerhaften Referenzen in der neuen Instanz, die oft erst während der Workflow-Ausführung sichtbar werden, wenn Authentifizierungsfehler auftreten.
- Nicht übereinstimmende AnmeldeinformationstypenKompatibilitätsprobleme treten auf, wenn der importierte Workflow einen bestimmten Anmeldeinformationstyp erwartet, der nicht mit der Konfiguration der Zielinstanz übereinstimmt. Beispielsweise erfordert ein Workflow möglicherweise OAuth2-Anmeldeinformationen, die Zielumgebung verwendet jedoch die Standardauthentifizierung. In solchen Fällen müssen die Anmeldeinformationen mit der genauen Methode neu erstellt werden, die von den Workflow-Knoten erwartet wird.
Da n8n keine automatische Zuordnung von Anmeldeinformationen bietet, müssen Benutzer nach dem Importieren von Workflows alle Anmeldeinformationen manuell neu zuweisen. Dieser Prozess ist besonders bei komplexen Workflows mit mehreren Integrationen aufwendig, da selbst ein kleines Versehen die gesamte Automatisierung stören kann.
Teams, die Workflows häufig über verschiedene n8n-Instanzen hinweg gemeinsam nutzen, stehen aufgrund dieser Anmeldeinformationsabhängigkeiten oft vor erheblichen Wartungsproblemen. Diese Probleme führen nicht nur zu wiederholten Importfehlern, sondern erfordern auch eine detaillierte Dokumentation der Anmeldeinformationseinrichtung. Darüber hinaus kann die gemeinsame Nutzung von Workflow-JSON-Dateien Sicherheitsrisiken mit sich bringen, die besondere Aufmerksamkeit erfordern.
Sicherheitsrisiken beim Teilen von Workflow-JSONs
Obwohl n8n keine geheimen Anmeldeinformationen in exportierte Workflow-JSON-Dateien einfügt, kann die Freigabe dieser Dateien dennoch vertrauliche Informationen preisgeben und potenzielle Sicherheitslücken schaffen. [6]..
- Offenlegung des Anmeldenamens: Workflow-JSON-Dateien enthalten die Namen und Typen der in der ursprünglichen Umgebung verwendeten Anmeldeinformationen. Dadurch können unbeabsichtigt Details zu internen Systemen, Dienstkonten oder Integrationsmethoden preisgegeben werden. Solche Informationen könnten Angreifern wertvolle Einblicke in Ihre Infrastruktur verschaffen.
- Leck im Authentifizierungsheader: Wenn Konfigurationen aus cURL-Befehlen oder API-Dokumentation in HTTP-Anforderungsknoten kopiert werden, können vertrauliche Daten wie Authentifizierungstoken oder API-Schlüssel versehentlich in das Workflow-JSON eingebettet werden. Dies stellt ein erhebliches Sicherheitsrisiko dar. [6]..
- Offenlegung des Integrationsmusters: Die Anmeldeinformationstypen und Knotenkonfigurationen in einem Workflow können Integrationsstrategien, Workflowstrukturen und Geschäftslogik offenlegen. Auch ohne tatsächliche Geheimnisse können diese Informationen böswilligen Akteuren Hinweise darauf geben, wie sie Ihre Systeme ausnutzen können.
Um diese Risiken zu minimieren, befolgen Sie beim Teilen von Workflows die folgenden Best Practices:
- Bereinigen Sie JSON-Dateien vor der Verteilung, indem Sie die Anmeldenamen entfernen oder anonymisieren. Verwenden Sie stattdessen Platzhalter wie „email_service_auth“ oder „database_connection“.
- Entfernen Sie alle Authentifizierungsheader aus HTTP-Anforderungsknoten, um die Offenlegung vertraulicher Daten zu verhindern.
- Geben Sie Workflow-Dateien nur über verschlüsselte Kanäle oder sichere Filesharing-Plattformen frei. Vermeiden Sie öffentliche Repositories oder unverschlüsselte E-Mails.
- Geben Sie klare, separate Anweisungen zur Einrichtung der Anmeldeinformationen, ohne tatsächliche Konfigurationsdetails anzugeben.
- Fordern Sie die Empfänger auf, alle Knoten vor der Bereitstellung von Workflows gründlich auf potenzielle Sicherheitsprobleme zu überprüfen.
Die Auswirkungen der Freigabe von JSON-Workflow-Dateien gehen über einzelne Workflows hinaus. Sie können Geschäftsprozesse, Integrationsabhängigkeiten und Betriebsmuster offenlegen, die zur Wettbewerbsbeobachtung oder als Angriffsvektoren genutzt werden können. Unternehmen sollten formelle Richtlinien für die Freigabe von Workflows implementieren, einschließlich obligatorischer Sicherheitsüberprüfungen und Genehmigungsprozesse für die externe Verteilung.
| Sicherheitsrisiko | Auswirkungsstufe | Mitigationstrategie |
|---|---|---|
| Offenlegung des Anmeldenamens | Medium | Verwenden Sie generische Platzhalternamen |
| Leck im Authentifizierungsheader | Hoch | Entfernen Sie alle Authentifizierungsheader |
| Offenlegung des Integrationsmusters | Medium | Nur mit vertrauenswürdigen Parteien teilen |
| Offenlegung der Geschäftslogik | Hoch | Überprüfen Sie Workflows für vertrauliche Daten |
Diese Probleme unterstreichen die Bedeutung einer strengen Verwaltung der Anmeldeinformationen und sicherer Freigabepraktiken, um sowohl Funktionalität als auch Sicherheit bei der Workflow-Automatisierung zu gewährleisten.
sbb-itb-23997f1
Fehlerbehebung bei Importfehlern
Rund 40 % der n8n-JSON-Importe schlagen aufgrund von Anmeldeinformationsproblemen oder Versionskonflikten fehl.[7].Wenn Sie wissen, wie Sie diese Fehler identifizieren und beheben, können Sie wertvolle Zeit sparen, Arbeitsabläufe vor Beschädigungen schützen und die Fehlerbehebung optimieren.
Häufige Importfehler
Hier sind einige der häufigsten Fehler, die beim Importieren auftreten, sowie deren Ursachen:
Ungültige JSON-Struktur
Fehlerhafte JSON-Dateien – beispielsweise mit fehlenden Klammern oder falsch gesetzten Kommas – führen zu Importfehlern. Um diese Probleme zu beheben, validieren Sie Ihre JSON-Datei mit einem Online-Tool oder der Entwicklerkonsole Ihres Browsers.
Fehlende Knotendefinitionen
Wenn ein Workflow auf Knoten verweist, die in der Zielinstanz nicht verfügbar sind, schlägt der Import fehl. Überprüfen Sie Ihre JSON-Datei auf fehlende oder inkompatible Knoten. Bei veralteten oder umbenannten Knoten müssen Sie möglicherweise Ihre n8n-Instanz aktualisieren oder die JSON-Datei manuell bearbeiten, um die problematischen Knoten zu ersetzen oder zu entfernen.[7]..
Nicht übereinstimmende Anmeldeinformationsreferenzen
Ein Workflow kann zwar erfolgreich importiert werden, schlägt aber während der Ausführung aufgrund fehlerhafter Anmeldeinformationen fehl. Diese Probleme bleiben oft bis zur Aktivierung verborgen und führen zu Verzögerungen von 30–90 Minuten, da Authentifizierungsfehler auftreten.[7].Das umgehende Beheben dieser Verweise ist entscheidend, um kaskadierende Fehler in abhängigen Arbeitsabläufen zu vermeiden.
Schemavalidierungsfehler
Diese treten auf, wenn ein Workflow-JSON veraltete oder inkompatible Felder enthält, was häufig zu Fehlern wie „unbekannte Eigenschaft“ oder „fehlendes Pflichtfeld“ führt. Solche Fehler entstehen typischerweise durch Änderungen in Knotenschemata oder Workflow-Metadaten.
Versionskompatibilitätsmatrix
Das Verständnis der Versionskompatibilität ist der Schlüssel zur Vermeidung von Importproblemen. Workflow-JSON-Dateien, die in einer Version von n8n erstellt wurden, funktionieren möglicherweise aufgrund von Änderungen in Knotenschemata, der Anmeldeinformationsverarbeitung oder anderen Updates nicht in einer anderen Version.[7]..
| n8n Version | Änderungen am Knotenschema | Anmeldeinformationssystem | Brechen von Änderungen | Häufige Importprobleme |
|---|---|---|---|---|
| 0.235.x | Neustrukturierung des HTTP-Anforderungsknotens | Legacy-System | Webhook-Knotenparameter | HTTP-Authentifizierungsheader |
| 0.240.x | Abkündigung des E-Mail-Knotens | Übergangsphase | SMTP-Konfiguration | E-Mail-Knotenaustausch erforderlich |
| 1.0.x | Umfassende Schemaüberarbeitung | Neues Anmeldeinformationsformat | Mehrere Knotentypen | Umfangreiche manuelle Korrekturen erforderlich |
| 1.6.x | Stabile Basislinie | Aktuelles System | Minimal | Gutes Kompatibilitätsziel |
| 1.7.x | Webhook-Verbesserungen | Aktuelles System | Änderungen beim Webhook-Trigger | Neukonfiguration des Webhook-Knotens |
| 1.8.x | HTTP-Knotenaktualisierungen | Verbesserte Sicherheit | Authentifizierungsmethoden | Neuzuweisung von Anmeldeinformationen |
Beispielsweise können Workflows, die aus Version 1.8 exportiert wurden, möglicherweise nicht in Version 1.6 importiert werden, wenn sie auf Funktionen der neueren Version basieren. Um solche Konflikte zu vermeiden, testen Sie Exporte in einer Staging-Umgebung, bevor Sie Upgrades oder Importe durchführen.
Workflow-Sicherungsverfahren
Die Implementierung zuverlässiger Backup-Verfahren ist unerlässlich, um Risiken bei Importfehlern zu minimieren. Diese Strategien schützen Ihre Arbeitsabläufe und erleichtern die Wiederherstellung.
Sicherungsstrategie vor dem Import
Exportieren Sie Workflows mit eindeutigen Datums- und Namensbezeichnungen, um eine einfache Wiederherstellung zu gewährleisten. Das Aufbewahren mehrerer Sicherungsversionen kritischer Workflows bietet zusätzlichen Schutz vor versehentlichem Löschen oder Beschädigung.
Sicherungen auf Datenbankebene
Da n8n Workflow-Daten, Anmeldeinformationen und den Ausführungsverlauf in seiner Datenbank speichert, sind regelmäßige Datenbank-Snapshots unerlässlich. Planen Sie vor Importen automatische Backups ein und bewahren Sie mindestens drei Backup-Generationen auf, um Fallback-Optionen zu gewährleisten.
Wiederherstellungsverfahren
Wenn ein Import Ihre Daten beschädigt, können Sie Workflows mithilfe gespeicherter JSON-Dateien oder Datenbanksicherungen wiederherstellen[7].Um die Zuverlässigkeit zu gewährleisten, testen Sie Ihren Wiederherstellungsprozess in einer Entwicklungsumgebung und überprüfen Sie die Integrität Ihrer Sicherungen.
Integration der Versionskontrolle
Für zusätzliche Rückverfolgbarkeit und Sicherheit speichern Sie exportierte JSON-Dateien in einer Versionskontrollplattform wie Git. Dieser Ansatz verfolgt nicht nur Änderungen, sondern ermöglicht auch die Zusammenarbeit und erlaubt bei Bedarf ein einfaches Rollback auf frühere Versionen.
Beispiele für JSON-Workflows
Der Erfolg beim Importieren von Workflows hängt oft von der richtigen JSON-Formatierung ab. Durch die Betrachtung funktionierender Beispiele können Sie die Strukturierung von JSON-Dateien besser verstehen und häufige Importfehler vermeiden.
JSON-Beispielvorlagen
Nachfolgend finden Sie detaillierte Beispiele für JSON-Vorlagen, die mit dem Schema von n8n übereinstimmen und die zuvor besprochenen Prinzipien veranschaulichen.
Ein Beispiel ist ein HTTP-API zu Slack Benachrichtigungsworkflow, das eine geeignete JSON-Struktur für den Import in n8n veranschaulicht:
<span class="hljs-punctuation">{</span>
<span class="hljs-attr">"name"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"API Monitor to Slack"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"nodes"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
<span class="hljs-punctuation">{</span>
<span class="hljs-attr">"parameters"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"httpMethod"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"GET"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"url"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"https://api.example.com/status"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"options"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"timeout"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">10000</span>
<span class="hljs-punctuation">}</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"id"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"8b0c1e5d-4f2a-4b3c-9d8e-7f6a5b4c3d2e"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"name"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"HTTP Request"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"type"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"n8n-nodes-base.httpRequest"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"typeVersion"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">4.1</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"position"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span><span class="hljs-number">250</span><span class="hljs-punctuation">,</span> <span class="hljs-number">300</span><span class="hljs-punctuation">]</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
<span class="hljs-punctuation">{</span>
<span class="hljs-attr">"parameters"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"conditions"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"options"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"caseSensitive"</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"leftValue"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">""</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"typeValidation"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"strict"</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"conditions"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
<span class="hljs-punctuation">{</span>
<span class="hljs-attr">"id"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"leftValue"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"={{ $json.status }}"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"rightValue"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"error"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"operator"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"type"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"string"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"operation"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"equals"</span>
<span class="hljs-punctuation">}</span>
<span class="hljs-punctuation">}</span>
<span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"combinator"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"and"</span>
<span class="hljs-punctuation">}</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"id"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"9c1d2e6e-5f3b-4c4d-ae9f-8g7b6c5d4e3f"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"name"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"IF Status Error"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"type"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"n8n-nodes-base.if"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"typeVersion"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">2</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"position"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span><span class="hljs-number">450</span><span class="hljs-punctuation">,</span> <span class="hljs-number">300</span><span class="hljs-punctuation">]</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
<span class="hljs-punctuation">{</span>
<span class="hljs-attr">"parameters"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"authentication"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"oAuth2"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"select"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"channel"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"channelId"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"__rl"</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"value"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"C1234567890"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"mode"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"list"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"cachedResultName"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"#alerts"</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"text"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"🚨 API Status Alert: {{ $('HTTP Request').item.json.message }}"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"otherOptions"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"id"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"ad2e3f7f-6g4c-5d5e-bf0g-9h8c7d6e5f4g"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"name"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"Send Slack Alert"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"type"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"n8n-nodes-base.slack"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"typeVersion"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">2.1</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"position"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span><span class="hljs-number">650</span><span class="hljs-punctuation">,</span> <span class="hljs-number">300</span><span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"credentials"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"slackOAuth2Api"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"id"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"1a2b3c4d-5e6f-7g8h-9i0j-1k2l3m4n5o6p"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"name"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"Slack OAuth2 API"</span>
<span class="hljs-punctuation">}</span>
<span class="hljs-punctuation">}</span>
<span class="hljs-punctuation">}</span>
<span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"pinData"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"connections"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"HTTP Request"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"main"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
<span class="hljs-punctuation">[</span>
<span class="hljs-punctuation">{</span>
<span class="hljs-attr">"node"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"IF Status Error"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"type"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"main"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"index"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">0</span>
<span class="hljs-punctuation">}</span>
<span class="hljs-punctuation">]</span>
<span class="hljs-punctuation">]</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"IF Status Error"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"main"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
<span class="hljs-punctuation">[</span>
<span class="hljs-punctuation">{</span>
<span class="hljs-attr">"node"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"Send Slack Alert"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"type"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"main"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"index"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">0</span>
<span class="hljs-punctuation">}</span>
<span class="hljs-punctuation">]</span>
<span class="hljs-punctuation">]</span>
<span class="hljs-punctuation">}</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"active"</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">false</span></span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"settings"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"executionOrder"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"v1"</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"versionId"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"f2e3d4c5-b6a7-8h9i-0j1k-2l3m4n5o6p7q"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"meta"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"templateCredsSetupCompleted"</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"instanceId"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0"</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"id"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"123"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"tags"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span><span class="hljs-punctuation">]</span>
<span class="hljs-punctuation">}</span>
Dieses Beispiel enthält Anmeldeinformationsreferenzen. Es ist wichtig sicherzustellen, dass diese Referenzen mit gültigen Anmeldeinformationen im Zielsystem übereinstimmen.
Ein weiteres Beispiel, ein Webhook-Trigger für E-Mail-Workflowbeschreibt eine einfachere Einrichtung mit minimalen erforderlichen Feldern:
<span class="hljs-punctuation">{</span>
<span class="hljs-attr">"name"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"Contact Form Handler"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"nodes"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
<span class="hljs-punctuation">{</span>
<span class="hljs-attr">"parameters"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"httpMethod"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"POST"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"path"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"contact-form"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"options"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"id"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"webhook-trigger-001"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"name"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"Webhook Trigger"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"type"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"n8n-nodes-base.webhook"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"typeVersion"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">1.1</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"position"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span><span class="hljs-number">240</span><span class="hljs-punctuation">,</span> <span class="hljs-number">300</span><span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"webhookId"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"b3c4d5e6-f7g8-h9i0-j1k2-l3m4n5o6p7q8"</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
<span class="hljs-punctuation">{</span>
<span class="hljs-attr">"parameters"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"fromEmail"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"[email protected]"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"toEmail"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"[email protected]"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"subject"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"New Contact Form: {{ $json.subject }}"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"text"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"Name: {{ $json.name }}Email: {{ $json.email }}Message: {{ $json.message }}"</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"id"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"email-sender-001"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"name"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"Send Email"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"type"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"n8n-nodes-base.emailSend"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"typeVersion"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">2</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"position"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span><span class="hljs-number">440</span><span class="hljs-punctuation">,</span> <span class="hljs-number">300</span><span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"credentials"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"smtp"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"id"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"smtp-cred-001"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"name"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"Company SMTP"</span>
<span class="hljs-punctuation">}</span>
<span class="hljs-punctuation">}</span>
<span class="hljs-punctuation">}</span>
<span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"connections"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"Webhook Trigger"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"main"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
<span class="hljs-punctuation">[</span>
<span class="hljs-punctuation">{</span>
<span class="hljs-attr">"node"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"Send Email"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"type"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"main"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"index"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">0</span>
<span class="hljs-punctuation">}</span>
<span class="hljs-punctuation">]</span>
<span class="hljs-punctuation">]</span>
<span class="hljs-punctuation">}</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"active"</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"settings"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"versionId"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"version-001"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"id"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"workflow-001"</span>
<span class="hljs-punctuation">}</span>
Beispiele für Schemakonformität
Anhand dieser Vorlagen wird deutlich, dass die Einhaltung der Schemaanforderungen von n8n entscheidend ist. Nachfolgend finden Sie die wichtigsten Schemaelemente für erfolgreiche Importe.
Knotenanforderungen: Jeder Knoten muss die folgenden Felder enthalten: id, name, type, typeVersion, position und parameters.
Validierung des Verbindungsschemas: Die connections Das Objekt definiert den Datenfluss zwischen Knoten. Jede Verbindung verwendet den Quellknotennamen als Schlüssel und gibt die Zielknoten in einer Array-Struktur an:
<span class="hljs-attr">"connections"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"Source Node Name"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"main"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
<span class="hljs-punctuation">[</span>
<span class="hljs-punctuation">{</span>
<span class="hljs-attr">"node"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"Target Node Name"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"type"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"main"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"index"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">0</span>
<span class="hljs-punctuation">}</span>
<span class="hljs-punctuation">]</span>
<span class="hljs-punctuation">]</span>
<span class="hljs-punctuation">}</span>
<span class="hljs-punctuation">}</span>
Referenzen: Anmeldeinformationsobjekte müssen sowohl eine id und einem name. Notiere dass der id ist nach dem Import nicht mehr gültig, seine Einbeziehung bleibt jedoch erforderlich:
<span class="hljs-attr">"credentials"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"credentialType"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"id"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"original-credential-id"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"name"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"Descriptive Credential Name"</span>
<span class="hljs-punctuation">}</span>
<span class="hljs-punctuation">}</span>
Metadaten für die Kompatibilität: Für moderne n8n-Versionen (1.6+) sind Metadatenfelder erforderlich, um eine ordnungsgemäße Handhabung während des Imports sicherzustellen:
<span class="hljs-attr">"meta"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"templateCredsSetupCompleted"</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"instanceId"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"source-instance-identifier"</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"settings"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"executionOrder"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"v1"</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"versionId"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"workflow-version-identifier"</span>
Das Auslassen dieser wichtigen Felder kann während des Importvorgangs zu Schemavalidierungsfehlern führen. Erfahren Sie im Folgenden, wie Sie diese Workflows nach dem Import sicher ändern und verwalten.
Workflow-Management nach dem Import
Sobald Sie Importfehler behoben und Ihre Workflow-JSON-Datei erfolgreich übertragen haben, ist die anschließende effektive Verwaltung entscheidend. Der Import ist nur der erste Schritt – die Art und Weise, wie Sie den Workflow nach dem Import handhaben, bestimmt seine Zuverlässigkeit und langfristige Nutzbarkeit.
Importierte Workflows sicher bearbeiten
Stellen Sie nach dem Importieren eines Workflows dessen Stabilität sicher, indem Sie strukturiert vorgehen. Erstellen Sie zunächst eine Sicherungskopie des importierten Workflows. Dies kann über die Einstellungen Registerkarte, indem Sie den Workflow als JSON-Datei exportieren. Mit dieser Sicherung können Sie im Falle eines Problems zum ursprünglichen Zustand zurückkehren.
Beheben Sie anschließend alle Anmeldeinformationswarnungen umgehend. Verbinden Sie die Knoten erneut mit Ihrem lokalen Anmeldeinformationsspeicher, bevor Sie Änderungen an den Knotenparametern vornehmen. Diese Reihenfolge ist wichtig – das Ändern von Parametern vor der Behebung von Anmeldeinformationsproblemen kann zu unnötigen Komplikationen führen.
Nehmen Sie Änderungen schrittweise vor und testen Sie jede Anpassung mit dem Workflow ausführen Schaltfläche. Diese Methode isoliert potenzielle Probleme und erleichtert so die Lokalisierung und Lösung von Problemen, ohne einen Dominoeffekt von Fehlern auszulösen.
Wenn Warnungen zu veralteten Knoten auftreten, dokumentieren Sie die aktuelle Konfiguration, bevor Sie fortfahren. Testen Sie Aktualisierungen in einem duplizierten Workflow, um sicherzustellen, dass die Änderungen die vorhandene Logik nicht beeinträchtigen. Aktualisierungen der Knotenversion können manchmal Parameterstrukturen verändern und zu unerwarteten Fehlern führen.
Für Workflows mit Webhooks generieren Sie deren URLs nach dem Import neu und aktualisieren Sie alle externen Systeme, die auf sie angewiesen sind. Webhook-URLs werden nicht zwischen n8n-Instanzen übertragen, daher ist dieser Schritt für die Aufrechterhaltung der Integrationen unerlässlich. Die zusätzliche URL-Validierung kann außerdem dazu beitragen, defekte Links frühzeitig zu erkennen.
Überprüfen und passen Sie abschließend alle Ausdrücke innerhalb des Workflows an, wie z. B. {{ $json.fieldName }} or {{ $('NodeName').item.json.data }}Diese Ausdrücke hängen oft von bestimmten Knotenausgaben ab, die sich während des Importvorgangs geändert haben könnten.
Best Practices für die Freigabe von Workflow-Dateien
Um die Freigabe und Verwendung Ihrer Workflow-JSON-Dateien in verschiedenen n8n-Umgebungen zu vereinfachen, ist ein wenig Vorbereitung von großer Bedeutung. Beginnen Sie mit Entfernen sensibler Daten wie API-Schlüssel, E-Mail-Adressen und andere persönliche Kennungen. Ersetzen Sie sie durch Platzhalter wie YOUR_API_ENDPOINT or [email protected], wodurch Datenschutz und Kompatibilität gewährleistet werden.
Hinzufügen Dokumentation direkt im Workflow kann für Empfänger entscheidend sein. Verwenden Sie n8n's Haftnotiz Knoten, die Einrichtungsanweisungen, Anmeldeinformationen und erwartete Datenformate bereitstellen. Diese eingebettete Anleitung wird mit der Workflow-Datei mitgeführt und bietet Klarheit, die in der externen Dokumentation möglicherweise fehlt.
Wählen Sie bei der Benennung von Anmeldeinformationen aussagekräftige und generische Bezeichnungen. Verwenden Sie beispielsweise „Gmail SMTP“ anstelle von „[E-Mail geschützt] SMTP.“ Dieser Ansatz vermeidet die Offenlegung persönlicher Daten und gibt gleichzeitig klar an, welche Art von Anmeldeinformationen erforderlich sind.
Umfassen Hinweise zur Versionskompatibilität mit freigegebenen Workflows. Geben Sie die zum Erstellen des Workflows verwendete n8n-Version an und weisen Sie auf bekannte Kompatibilitätsprobleme hin. Beispielsweise funktionieren Workflows, die mit n8n 1.0+ erstellt wurden, aufgrund von Schemaaktualisierungen möglicherweise nicht in älteren Instanzen.
Testen Sie den Workflow vor der Freigabe in einer sauberen n8n-Instanz. Dieser Schritt hilft dabei, fehlende Abhängigkeiten, Anmeldeinformationsprobleme oder Kompatibilitätsprobleme zu identifizieren, die im ursprünglichen Setup möglicherweise nicht erkennbar sind.
Entwerfen Sie Workflows mit Modularität Denken Sie daran. Anstatt einen riesigen Workflow mit Dutzenden von Knoten zu erstellen, sollten Sie ihn in kleinere, spezialisierte Workflows aufteilen. Diese können über Webhooks oder gemeinsame Datenspeicher kommunizieren und sind so leichter zu verstehen, zu aktualisieren und wiederzuverwenden.
Für Teams, die mehrere Workflows verwalten, erstellen Sie Regeln der Namensgebung die Versionsnummern und Erstellungsdaten enthalten. Beispielsweise bietet ein Workflow mit dem Namen „CRM-Lead-Processing-v2.1-2025-01“ viel mehr Kontext als ein allgemeiner Name wie „Lead Processing“.
Mit der zunehmenden Anzahl gemeinsamer Workflows, regelmäßige Wartungsüberprüfungen - idealerweise vierteljährlich. Aktualisieren Sie während dieser Überprüfungen veraltete Knoten, aktualisieren Sie Anmeldeinformationen und stellen Sie sicher, dass die Workflows weiterhin den aktuellen Anforderungen entsprechen. Dieser proaktive Ansatz minimiert technische Schulden und sorgt für effiziente Workflows.
Schließlich betrachten Verfolgung von Änderungen Für Workflows, die häufig aktualisiert werden. Führen Sie ein einfaches Protokoll, in dem detailliert aufgeführt ist, was geändert wurde, warum und von wem. Diese Aufzeichnung ist von unschätzbarem Wert, wenn Sie später Probleme beheben oder problematische Änderungen rückgängig machen möchten.
Fazit
Die Möglichkeit, Workflow-JSON-Dateien in N8N zu importieren, erleichtert die gemeinsame Nutzung von Automatisierungs-Setups, bringt aber auch einige Herausforderungen mit sich. Eines der drängendsten Probleme ist die Zuverlässigkeit, insbesondere bei Versionsinkompatibilitäten. Workflows, die aus einer N8N-Version exportiert wurden, können aufgrund von Änderungen oder veralteten Knoten möglicherweise nicht ordnungsgemäß in eine andere importiert werden, was die Standardisierung erschwert. Darüber hinaus treten bei etwa 40 % der gemeinsam genutzten Workflows Probleme aufgrund fehlender oder falsch konfigurierter Anmeldeinformationen auf, die oft selbst nach einem scheinbar erfolgreichen Import manuelle Eingriffe erfordern.
Ein weiteres Problem ist die Sicherheit. Workflow-Dateien können unbeabsichtigt vertrauliche Informationen wie Anmeldeinformationen, API-Endpunkte oder eingebettete Konfigurationen preisgeben. Um dieses Risiko zu minimieren, ist eine sorgfältige Bereinigung dieser Dateien vor der Freigabe unerlässlich.
Diese Herausforderungen unterstreichen die Vorteile von Alternativen wie der Vorlagenfreigabe von Latenode. Mit Funktionen wie der automatischen Abhängigkeitsauflösung und Kompatibilitätsprüfungen vereinfacht Latenode den Prozess und reduziert gleichzeitig das Fehlerpotenzial. Für Teams, die die JSON-Importfunktion von N8N nutzen, ist die Umsetzung bewährter Methoden jedoch unerlässlich. Dazu gehören regelmäßige Backups, die Aktualisierung von Workflows und strenge Tests von Importen in Staging-Umgebungen, um Sicherheit und Zuverlässigkeit zu gewährleisten.
Letztendlich hängt die erfolgreiche Nutzung der Workflow-Importe von N8N davon ab, dass man sich ihrer Grenzen bewusst ist und starke Sicherheitsvorkehrungen implementiert, um Workflows effektiv zu verwalten und aufrechtzuerhalten.
FAQs
Wie konfiguriere ich Anmeldeinformationen beim Importieren einer N8N-Workflow-JSON-Datei richtig?
Um Ihre Anmeldeinformationen beim Importieren einer N8N-Workflow-JSON-Datei korrekt zu konfigurieren, überprüfen Sie zunächst die exportierte JSON-Datei. Entfernen oder anonymisieren Sie vor der Freigabe alle vertraulichen Daten, um Ihre Daten zu schützen und gleichzeitig die Struktur des Workflows zu erhalten.
Sobald die JSON-Datei in Ihre N8N-Instanz importiert wurde, überprüfen Sie, ob alle referenzierten Anmeldeinformationen vorhanden und korrekt mit den jeweiligen Knoten verknüpft sind. Sollten Anmeldeinformationen fehlen oder nicht korrekt zugeordnet sein, müssen Sie diese manuell in der N8N-Oberfläche aktualisieren oder neu konfigurieren, um sicherzustellen, dass sie mit Ihrem Setup übereinstimmen. Dieser Schritt ist entscheidend, um Authentifizierungsfehler zu vermeiden und einen reibungslosen Ablauf Ihrer Workflows zu gewährleisten.
Wenn Sie sich während des Importvorgangs die Zeit nehmen, die Anmeldeinformationen zu überprüfen und anzupassen, können Sie häufige Probleme vermeiden und die Funktionalität Ihrer Automatisierungs-Workflows erhalten.
Welche Probleme treten häufig beim Importieren einer N8N-Workflow-JSON-Datei auf und wie kann ich sie beheben?
Beim Importieren einer N8N-Workflow-JSON-Datei in Ihr System können einige häufige Probleme auftreten. Dazu gehören ungültige JSON-Formatierung, fehlende oder nicht übereinstimmende Anmeldeinformationen und Herausforderungen bei der VersionskompatibilitätUm diese Probleme zu beheben, stellen Sie zunächst sicher, dass die JSON-Datei gut strukturiert ist, und validieren Sie sie mit einem zuverlässigen JSON-Validator.
Stellen Sie anschließend sicher, dass alle erforderlichen Anmeldeinformationen entweder in der Datei enthalten oder in Ihrer N8N-Instanz korrekt konfiguriert sind. Überprüfen Sie außerdem unbedingt, ob Ihre N8N-Version mit der Version übereinstimmt, mit der der Workflow erstellt wurde. Inkompatibilitäten können auftreten, wenn der Workflow auf Funktionen oder Knoten basiert, die in einer neueren oder älteren Version eingeführt wurden.
Wenn Sie fehlende Knoten oder Abhängigkeiten feststellen, überprüfen Sie die Workflow-Konfiguration und stellen Sie sicher, dass alle erforderlichen Module installiert sind. Durch schrittweises Testen des Workflows können Sie spezifische Probleme identifizieren und die Fehlerbehebung vereinfachen. Erstellen Sie vor dem Importieren neuer Workflows stets Backups Ihrer aktuellen Workflows, um versehentliches Überschreiben oder Datenverlust zu vermeiden.
Wie kann ich N8N-Workflow-JSON-Dateien sicher freigeben, ohne vertrauliche Daten preiszugeben?
Um N8N-Workflow-JSON-Dateien sicher freizugeben, ist es wichtig, alle sensiblen Daten wie Anmeldeinformationen und Authentifizierungstoken zu entfernen oder zu anonymisieren. Ersetzen Sie spezifische Anmeldenamen, IDs oder eingebettete Authentifizierungsdaten durch Platzhalter oder generische Werte, um eine unbeabsichtigte Offenlegung zu vermeiden.
Überprüfen Sie die Datei vor der Freigabe gründlich, um sicherzustellen, dass keine vertraulichen Informationen enthalten sind. Testen Sie den Workflow mithilfe der Platzhalter, um sicherzustellen, dass er wie vorgesehen funktioniert. So stellen Sie sicher, dass der Workflow funktionsfähig bleibt und gleichzeitig private Daten geschützt sind.
Ähnliche Blog-Beiträge
