Der VereinWiki-Quellcode von N8n Workflow Engine
Version 9.2 von Daniel Herrmann am 2026/02/22 19:41
Verstecke letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 1 | n8n ist ein **Open-Source-Tool zur Workflow-Automatisierung**, das man selbst hosten kann. Über eine **visuelle Oberfläche** baut man Workflows per Drag-and-drop aus sogenannten „Nodes“, die verschiedene Dienste und Aktionen miteinander verbinden. Es gibt Hunderte vorgefertigte Integrationen, z. B. für Slack, Mail oder MQTT. Ebenfalls gibt es eine große Auswahl an für uns relevante Community Nodes (Vikunja, Listmonk, und so weiter) sowie die Möglichkeit, eigene Nodes zu schreiben (beispielsweise Paperless oder NATS). |
| 2 | |||
| |
9.1 | 3 | = Inhaltsverzeichnis = |
| 4 | |||
| 5 | {{toc/}} | ||
| 6 | |||
| |
3.1 | 7 | = Workflow Übersicht = |
| |
1.1 | 8 | |
| |
3.2 | 9 | Workflows bestehen grundsätzlich aus einem oder mehreren **Triggern** und einer oder mehreren **Aktionen**. Im Folgenden werden nur die für die Mitgliederverwaltung relevanten Workflows beschrieben, N8n kann aber natürlich auch für andere Automatisierung verwendet werden. |
| 10 | |||
| |
3.4 | 11 | == Workflows für Dokumente == |
| 12 | |||
| 13 | === Document Consumed Workflow === | ||
| 14 | |||
| 15 | ToDO | ||
| 16 | |||
| 17 | === Paperless Papierkorb === | ||
| 18 | |||
| 19 | asd | ||
| 20 | |||
| 21 | == Cron Jobs - Sync von Daten == | ||
| 22 | |||
| |
3.3 | 23 | === Sync Tags für Einweisungen === |
| 24 | |||
| 25 | ToDo | ||
| 26 | |||
| 27 | === Sync Document Types === | ||
| 28 | |||
| 29 | ToDo | ||
| 30 | |||
| |
3.4 | 31 | == Backend Event Workflows == |
| |
3.3 | 32 | |
| |
3.5 | 33 | 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: |
| |
1.1 | 34 | |
| |
4.1 | 35 | === mksp.docuseal.signature.completed === |
| |
3.5 | 36 | |
| |
9.2 | 37 | 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: |
| |
3.3 | 38 | |
| |
9.2 | 39 | * Bei rein digitalen Signaturen durch einen über Docuseal ausgelösten Webhook |
| 40 | * Bei handschriftlich unterschrieben Signaturen durch Einscan | ||
| 41 | |||
| |
4.1 | 42 | === mksp.backend.user.created === |
| |
3.5 | 43 | |
| |
5.3 | 44 | 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**. |
| |
3.5 | 45 | |
| |
5.2 | 46 | [[image:1771784637258-114.png||height="200"]] |
| 47 | |||
| |
5.3 | 48 | Die folgenden Aktionen werden ausgeführt: |
| |
5.2 | 49 | |
| |
8.1 | 50 | 1. Parallel werden **alle Gruppen und Benutzer **aus Paperless ausgelesen |
| 51 | 1. Es wird auf die relevanten Gruppen und Benutzer gefiltert. Ziel ist es, **die ID der entsprechenden Gruppen und Benutzer auszulesen**. Wir sind **interessiert an den Gruppen für die Mitgliederverwaltung und die IT Admins** sowie dem statischen **MV Owner**. | ||
| 52 | 1. Zuletzt wird der Subflow "Create Paperless Correspondent" angelegt. Dieser bekommt als Info: | ||
| 53 | 11. **firstname** - aus NATS Trigger | ||
| 54 | 11. **lastname** - aus NATS Trigger | ||
| 55 | 11. **isGuest** - true wenn membership_number in NATS Trigger = null, false otherwise | ||
| 56 | 11. **membership_number** - aus NATS Trigger | ||
| 57 | 11. **user_id** - aus NATS Trigger | ||
| 58 | 11. **owner_id** - ID des MV Data Owner Benutzers | ||
| 59 | 11. **permissions** - siehe unten | ||
| 60 | 11. **backend_url** - URL des Makerspace Backends | ||
| |
5.3 | 61 | |
| |
8.1 | 62 | Der Subflow erzeugt dann den Display-Namen des Korrespondenten und **speichert die Paperless-ID über die Backend-API zurück ins Backend.** Der **Display-Name **setzt sich wie folgt zusammen: |
| 63 | |||
| 64 | |=Nutzer-Typ|=Format|=Beispiel | ||
| 65 | |Mitglied|Vorname Nachname (#Mitgliedsnummer)|Daniel Herrmann (#250) | ||
| 66 | |Gast|Vorname Nachname (Gast #Nutzer-ID)|Daniel Herrmann (Gast #1) | ||
| 67 | |||
| 68 | Die **Berechtigungen** werden dabei wie folgt gesetzt: | ||
| 69 | |||
| 70 | {{code language="none"}} | ||
| 71 | {"view":{"users":[],"groups":[{{ $('Static Data').item.json.mv_group_id }}]},"change":{"users":[],"groups":[{{ $('Static Data').item.json.it_admin_group_id }}]}} | ||
| 72 | {{/code}} | ||
| 73 | |||
| 74 | D.h. Owner (und damit alle Rechte) hat der statische MV Owner Nutzer. Alle Mitglieder der Gruppe "Mitgliederverwaltung" können den Korrespondenten sehen (notwendig für Zuweisung und Filterung), IT-Admins können diese verändern. | ||
| 75 | |||
| |
4.1 | 76 | === mksp.backend.user.converted_to_guest === |
| |
3.5 | 77 | |
| |
8.1 | 78 | Dieser Workflow wird dann ausgelöst, wenn ein Mitglied den Verein verlässt und daher zum Gast wird. |
| |
4.1 | 79 | |
| |
8.1 | 80 | [[image:1771785245954-780.png||height="150"]] |
| 81 | |||
| 82 | 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. | ||
| 83 | |||
| |
4.1 | 84 | === mksp.backend.user.converted_to_member === |
| 85 | |||
| |
9.1 | 86 | Dieser Workflow wird dann ausgelöst, wenn ein neues Mitglied dem Verein beitritt. |
| |
8.1 | 87 | |
| 88 | [[image:1771785309574-242.png||height="150"]] | ||
| 89 | |||
| 90 | 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. | ||
| 91 | |||
| 92 | == Subflows == | ||
| 93 | |||
| |
4.1 | 94 | ToDo |
| 95 | |||
| |
3.1 | 96 | = Community Nodes = |
| |
1.1 | 97 | |
| 98 | asd |