Zum Inhalt springen

Änderungen von Dokument N8n Workflow Engine

Zuletzt geändert von Daniel Herrmann am 2026/02/22 21:17
Von Version Icon 18.1 Icon
bearbeitet von Daniel Herrmann
am 2026/02/22 21:11
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version Icon 10.1 Icon
bearbeitet von Daniel Herrmann
am 2026/02/22 19:42
Änderungskommentar: Neuen Anhang 1771785764191-239.png hochladen

Zusammenfassung

Details

Icon Seiteneigenschaften
Inhalt
... ... @@ -12,73 +12,22 @@
12 12  
13 13  === Document Consumed Workflow ===
14 14  
15 -Dieser Workflow wird durch das [[Paperless Post-Consume Script>>doc:PROJ.Digitale Mitgliederverwaltung.Paperless NGX.WebHome]] ausgelöst, immer dann, wenn ein **QR Code mit dem korrekten Inhalt **erkannt wird. Die Idee hier ist, dass **ausgedruckte und handschriftliche Dokumente **automatisch verarbeitet werden können.
15 +ToDO
16 16  
17 -Im Prinzip ersetzt dieser Workflow den Docuseal Webhook, der automatisch dem Backend bescheid gibt, wenn alle Parteien unterschrieben haben. Bei ausgedruckten Dokumenten passiert dies stattdessen hierüber.
18 -
19 -[[image:1771785973968-394.png||height="150"]]
20 -
21 -Der Workflow:
22 -
23 -* wird über ein Webhook vom Post Consume Script ausgelesen. Als Inhalt wird der Inhalt des dekodierten QR Codes übergeben
24 -* nur handschriftlich unterschriebene Dokumente werden verarbeitet
25 -* dem Backend wird signalisiert, dass das Dokument erfolgreich verarbeitet wurde
26 -
27 -Als Konsequenz kann das Backend weitere automatische Aktionen ausführen, beispielsweise vorläufige oder dauerhafte Berechtigungen eintragen.
28 -
29 29  === Paperless Papierkorb ===
30 30  
31 -**In Paperless kann nur der Owner Dokumente in den Papierkorb verschieben**. Dies lässt sich leider nicht anders konfigurieren, sodass wir uns hier mit einem Workaround behelfen: die Mitgliederverwaltung und/oder der Vorstand können dem Dokument **ein Tag zuweisen**. **Dieses Tag löst einen Workflow in Paperless aus:**
19 +asd
32 32  
33 -[[image:1771786279823-587.png||height="250"]]
34 -
35 -Dieser Workflow löst zwei Dinge aus (leider ist Dokument löschen keine verfügbare Aktion):
36 -
37 -* er entfernt das Tag wieder, um Rekursion zu vermeiden
38 -* und löst ein N8n Webhook aus
39 -
40 -**Der N8n Workflow löscht dann das Dokument.**
41 -
42 -[[image:1771786234093-932.png||height="150"]]
43 -
44 44  == Cron Jobs - Sync von Daten ==
45 45  
46 46  === Sync Tags für Einweisungen ===
47 47  
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.**
25 +ToDo
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 -
62 62  === Sync Document Types ===
63 63  
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.
29 +ToDo
65 65  
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 -
82 82  == Backend Event Workflows ==
83 83  
84 84  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:
... ... @@ -87,17 +87,9 @@
87 87  
88 88  Dieses Event wird ausgelöst, wenn im Backend ein Signatur-Prozess abgeschlossen ist (d.h. alle Parteien haben unterschrieben und die Unterschrift wurde im Backend erfasst). Dies kann auf zwei Arten passieren:
89 89  
90 -* Bei **rein digitalen Signaturen** durch einen über **Docuseal ausgelösten Webhook**
91 -* Bei **handschriftlich** unterschrieben Zetteln durch **Einscannen** und den oben beschrieben **"Document Consumed" N8n Workflow**
39 +* Bei rein digitalen Signaturen durch einen über Docuseal ausgelösten Webhook
40 +* Bei handschriftlich unterschrieben Signaturen durch Einscan
92 92  
93 -[[image:1771785764191-239.png||height="150"]]
94 -
95 -**Der Workflow löst nur bei digitalen Dokumenten eine Aktion aus**. Bei handschriftlich unterschriebenen Dokumenten ist das Dokument bereits eingescannt. Für digital unterschriebene Signaturen:
96 -
97 -* wird der Status der Submission aus Docuseal ausgelesen
98 -* wird das PDF mit den Unterschriften aller Parteien runtergeladen...
99 -* und anschließend in Docuseal hochgeladen und dort verarbeitet.
100 -
101 101  === mksp.backend.user.created ===
102 102  
103 103  Dieser Workflow wird immer dann getriggert, wenn im Backend ein **neuer User** angelegt wird. Die Informationen aus der NATS Nachricht werden dann verwendet, um den **Korrespondenten in Paperless anzulegen**.
Icon 1771785973968-394.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.dherrman
Größe
... ... @@ -1,1 +1,0 @@
1 -83.1 KB
Inhalt Icon
Icon 1771786234093-932.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.dherrman
Größe
... ... @@ -1,1 +1,0 @@
1 -56.7 KB
Inhalt Icon
Icon 1771786279823-587.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.dherrman
Größe
... ... @@ -1,1 +1,0 @@
1 -173.8 KB
Inhalt Icon
Icon 1771790486089-157.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.dherrman
Größe
... ... @@ -1,1 +1,0 @@
1 -227.4 KB
Inhalt Icon
Icon 1771790995906-398.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.dherrman
Größe
... ... @@ -1,1 +1,0 @@
1 -280.3 KB
Inhalt Icon