Änderungen von Dokument Paperless NGX

Zuletzt geändert von Daniel Herrmann am 2026/02/22 11:41

Von Version Icon 17.1
bearbeitet von Daniel Herrmann
am 2026/02/22 11:41
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version Icon 16.1 Icon
bearbeitet von Daniel Herrmann
am 2026/02/22 11:37
Änderungskommentar: Neuen Anhang Screenshot 2026-02-22 at 11.36.43.png hochladen

Zusammenfassung

Details

Icon Seiteneigenschaften
Inhalt
... ... @@ -271,23 +271,21 @@
271 271  
272 272  === QR Code ===
273 273  
274 -Als Format für den Code wurde ein Standard QR Code ausgewählt, da dieser mehr Platz und Fehlerkorrektur bietet. Es wurde ebenfalls mit PDF417 Codes experimentiert, jedoch funktioniert die Erkennung mit Python Libraries nur sehr schlecht. Ein QR Code sieht beispielsweise so aus:
274 +Als Format für den Code wurde PDF417 ausgewählt, da dieser mehr Platz und Fehlerkorrektur bietet. Weiterhin gibt es eine einfach zu nutzende Library r Python (Erzeugung) und PDF417 wird von ZXING unterstützt, welches in Paperless eingebettet ist. Ein solcher Barcode sieht beispielsweise so aus:
275 275  
276 -[[image:Screenshot 2026-02-22 at 11.36.43.png||height="150"]]
277 277  
278 -=== Post Consumption Script ===
277 +[[image:barcode.jpg||height="250"]]
279 279  
280 -Die eigentliche Zuordnung der Meta-Daten erfolgt über ein so genanntes Post Consumption Script. Dieses befindet sich ebenfalls im Makerspace Gitlab: [[https:~~/~~/git.makerspace-darmstadt.de/makerspace-it-infrastructure/mitgliederverwaltung/paperless-post-consumption-script#>>url:https://git.makerspace-darmstadt.de/makerspace-it-infrastructure/mitgliederverwaltung/paperless-post-consumption-script]]
279 +Daraus kann dann eine Base64 basierte Repräsentation berechnet werden, die einfach in Docuseal hochgeladen werden kann.
281 281  
282 -Das Script macht drei Dinge:
281 +=== Referenz-Implementierung ===
283 283  
284 -* Es scannt jedes neue Dokument nach eingebetteten QR Codes
285 -* Jeder gefundene Code wird versucht als JWT zu Parsen. Fehler werden ignoriert
286 -* Wird ein Code erfolgreich geparsed, wird die Signatur validiert. Wenn erfolgreich:
287 -** werden die Meta-Daten über die Paperless API zugewiesen
288 -** ein N8n Workflow "[[Paperless Document Consumed>>url:https://n8n.mksp-da.de/workflow/4HYqb15erC7Q9vYK/executions/27908]]" wird ausgeführt. Dieser erhält den Inhalt des QR Code als Parameter (inklusive eventuell übermittelter zusätzlicher Daten) und kann automatisch Aktionen ausführen - so wird beispielsweise der Signaturvorgang im Backend als "beendet" markiert.
289 -** Je nach Signatur-Typ löst das Backend dann automatisch Folgeaktionen aus.
283 +Eine Referenz-Implementierung befindet sich im Makerspace Gitlab: [[https:~~/~~/git.makerspace-darmstadt.de/makerspace-it-infrastructure/mitgliederverwaltung/paperless-pdf417-reference>>url:https://git.makerspace-darmstadt.de/makerspace-it-infrastructure/mitgliederverwaltung/paperless-pdf417-reference]]
290 290  
285 +=== Post Consumption Script ===
286 +
287 +Die eigentliche Zuordnung der Meta-Daten erfolgt über ein so genanntes Post Consumption Script. Dieses befindet sich ebenfalls im Makerspace Gitlab: [[https:~~/~~/git.makerspace-darmstadt.de/makerspace-it-infrastructure/mitgliederverwaltung/paperless-post-consumption-script#>>url:https://git.makerspace-darmstadt.de/makerspace-it-infrastructure/mitgliederverwaltung/paperless-post-consumption-script]]
288 +
291 291  == Paperless Berechtigungen ==
292 292  
293 293  Paperless NGX hat ein Berechtigungssystem, welches sich über fast alle Ressourcen erstreckt. Grundsätzlich gibt es **Benutzer** und **Gruppen**. Berechtigungen können dann global vergeben werden (Sichtbarkeit von Features) und zusätzlich auf Objektebene vergeben werden.