Änderungen von Dokument N8n Workflow Engine

Zuletzt geändert von Daniel Herrmann am 2026/02/22 21:17

Von Version Icon 14.1 Icon
bearbeitet von Daniel Herrmann
am 2026/02/22 19:52
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version Icon 19.1
bearbeitet von Daniel Herrmann
am 2026/02/22 21:17
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Icon Seiteneigenschaften
Inhalt
... ... @@ -45,12 +45,40 @@
45 45  
46 46  === Sync Tags für Einweisungen ===
47 47  
48 -ToDo
48 +In Paperless unterscheiden wir verschiedene Arten von Dokumente, diese sind [[hier im Wiki beschrieben>>doc:PROJ.Digitale Mitgliederverwaltung.WebHome]]. Es wäre aber nicht zweckmäßig, für jede Einweisung ebenfalls einen eigenen Typ zu erzeugen, daher verwenden wir Tags. **Dieser Workflow liest die verfügbaren Einweisungen vom Backend der Homepage aus und erzeugt die Tags.**
49 49  
50 +[[image:1771790486089-157.png||height="150"]]
51 +
52 +Dieser Workflow **regelmäßig als Cronjob ausgeführt**.
53 +
54 +* liest verschiedene Informationen aus Paperless aus
55 +** Alle Gruppe, und findet die ID der Gruppen für Mitgliederverwaltung und IT-Admins
56 +** Alle User, und findet die ID des MV Owner Users
57 +** Alle bestehenden Tags
58 +* Dann werden die verfügbaren Einweisungen aus dem Backend ausgelesen
59 +* Im Merge Node werden Tags herausgefiltert, die noch nicht in Paperless existieren
60 +* Diese werden dann erzeugt.
61 +
50 50  === Sync Document Types ===
51 51  
52 -ToDo
64 +Die verfügbaren Dokumenten-Typen werden [[in Directus verwaltet>>https://assets.makerspace-darmstadt.de/admin/content/paperless_document_types]], und können dort einfacher verändert werden. Dieser Workflow synchronisiert die Dokumenten-Typen ähnlich der Tags für Einweisungen.
53 53  
66 +[[image:1771790995906-398.png||height="150"]]
67 +
68 +Dieser Workflow **regelmäßig als Cronjob ausgeführt**.
69 +
70 +* liest verschiedene Informationen aus Paperless aus
71 +** Alle Gruppe, und findet die ID der Gruppen für Mitgliederverwaltung und IT-Admins
72 +** Alle User, und findet die ID des MV Owner Users
73 +** Alle bestehenden Dokumenten-Typen
74 +* Dann werden die verfügbaren Typen aus Directus ausgelesen
75 +* Im Merge Node werden Typen herausgefiltert, die noch nicht in Paperless existieren
76 +* Diese werden dann erzeugt
77 +
78 +{{info}}
79 +Wir müssen überdenken, ob dies wirklich so sinnvoll ist. Die Dokumenten-Typen werden vom Backend in den QR Code rein kodiert und müssen übereinstimmen, damit das Dokument erfolgreich zugeordnet werden kann. Es macht eventuell mehr Sinn, dass IT-Admins diese direkt in Paperless verwalten. Dann würde die Directus Collection und dieser Workflow wegfallen.
80 +{{/info}}
81 +
54 54  == Backend Event Workflows ==
55 55  
56 56  Bestimmte Events aus dem Backend werden über NATS als Event gepublished. Details dazu sind auf der [[Seite zu NATS>>doc:PROJ.Digitale Mitgliederverwaltung.Technische Dokumentation.NATS Setup.WebHome]] beschrieben. Hier werden die Events beschrieben, die Paperless betreffen:
... ... @@ -120,10 +120,18 @@
120 120  
121 121  Alle notwendigen Daten (inklusive der Paperless Korrespondent-ID) sind im NATS Event vorhanden. Es wird also lediglich ein neuer Display-Name erzeugt (Format: siehe Tabelle oben) und der Korrespondent wird aktualisiert.
122 122  
123 -== Subflows ==
151 += N8n Nodes =
124 124  
125 -ToDo
153 +N8n nodes sind im Prinzip die Schnittstelle zwischen N8n und externen Tools. Einige Funktionalitäten sind Teil des N8n Cores (beispielsweise HTTP Anfragen, MQTT, ...), andere müssen über externe Nodes hinzugefügt werden. Für einige Tools nutzen wir bestehende Community Nodes, für andere haben wir selbst welche entwickelt.
126 126  
127 -= Community Nodes =
155 +== Paperless Node ==
128 128  
129 -asd
157 +Es gibt stand heute keinen Community Node für die Anbindung von Paperless. Wir haben daher im Rahmen des Projekts diesen Community Node erstellt und unter eine Open Source Lizenz gestellt.
158 +
159 +Der Paperless Node inklusive Beschreibung ist auf [[GitHub verfügbar>>https://github.com/makerspace-darmstadt/n8n-nodes-paperless]].
160 +
161 +== NATS Node ==
162 +
163 +NATS ist die Event-Queue, die Events zwischen dem Backend und der Infrastruktur im Makerspace transportiert. Das Setup [[ist hier im Wiki beschrieben>>doc:PROJ.Digitale Mitgliederverwaltung.Technische Dokumentation.NATS Setup.WebHome]]. Die bestehenden NATS Nodes hatten entweder kein Support für Trigger Nodes, oder haben TLS fehlerhaft implementiert und daher keine Verbindung zu unserer NATS Umgebung ermöglicht, die korrekte Zertifikate benötigt. Wir haben daher im Rahmen des Projekts diesen Community Node erstellt und unter eine Open Source Lizenz gestellt.
164 +
165 +Der NATS Node inklusive Beschreibung ist auf [[GitHub verfügbar>>https://github.com/makerspace-darmstadt/n8n-nodes-nats]].
Icon 1771790486089-157.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dherrman
Größe
... ... @@ -1,0 +1,1 @@
1 +227.4 KB
Inhalt Icon
Icon 1771790995906-398.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dherrman
Größe
... ... @@ -1,0 +1,1 @@
1 +280.3 KB
Inhalt Icon