Paperless-ngx-Handbuch

Dokumente hinzufügen

Sobald Paperless eingerichtet ist, geht es darum, Dokumente hineinzugeben. Beim Hinzufügen führt Paperless folgende Schritte aus:

OCR, falls das Dokument keinen Text enthält. Digitale Dokumente haben meist bereits Text; dann wird dieser Schritt übersprungen.
Paperless erzeugt aus Ihrem Dokument eine archivierbare PDF/A-Datei. Stammt das Dokument von Ihrem Scanner, enthält diese eingebetteten, markierbaren Text.
Paperless ordnet dem Dokument automatisch Tags, Korrespondenten und Typen zu, bevor es in der Datenbank gespeichert wird.

Hinweis: Unabhängig von den gewählten Optionen bewahrt Paperless immer das Originaldokument auf, das im Consume-Ordner oder in der E-Mail gefunden wurde, und überschreibt es nie (außer bei bestimmten, klar gekennzeichneten Dokument- Aktionen). Archiv-Versionen werden zusätzlich neben den Originalen abgelegt.

Der Consume-Ordner

Der wichtigste Weg, Dokumente in die Datenbank zu bekommen, ist das Ablegen im Consume-Ordner. Der Consumer wartet geduldig auf neue Dateien in diesem Ordner. Findet er welche, verarbeitet er sie per OCR, indiziert den Inhalt und legt ihn im Medienverzeichnis ab. Betrachten Sie diesen Ordner als temporären Ort: Die Dateien werden innerhalb von Paperless neu erzeugt und anschließend aus dem Consume-Ordner entfernt.

Wie die Dateien in diesen Ordner gelangen, entscheiden Sie. Auf dem lokalen Rechner ziehen Sie sie vielleicht einfach per Drag-and-drop hinein; auf einem Server, der Dateien automatisch vom Scanner erhalten soll, richten Sie einen entsprechenden Dienst ein (etwa einen FTP-Server oder eine Windows-Freigabe per Samba).

Achtung: Verarbeitete Dateien werden aus dem Consume-Ordner entfernt und gemäß Ihren Einstellungen bzw. Speicherpfaden innerhalb von Paperless abgelegt. Das geschieht so sicher wie möglich – rechnen Sie aber damit, dass die Dateien nach der Verarbeitung dort nicht mehr liegen.

Upload über die Weboberfläche

Das Dashboard hat einen Button zum Hochladen. Alternativ ziehen Sie eine Datei einfach irgendwo in die App, um die Verarbeitung zu starten.

Upload per Mobilgerät

Für Mobilgeräte gibt es eine von der Community gepflegte Liste kompatibler Projekte und Apps im Paperless-ngx-Wiki.

Eingehende E-Mails

Sie können Paperless anweisen, Dokumente aus Ihren E-Mail-Konten aufzunehmen – eine sehr flexible und mächtige Funktion, wenn Sie regelmäßig Dokumente per Mail erhalten. Der Mail-Consumer wird in den Einstellungen (/settings/mail) konfiguriert:

E-Mail-Konten definieren.
E-Mail-Regeln für das Konto definieren.

Diese Regeln verbinden sich mit dem Mailserver, holen alle passenden Mails (nach Ordner, Höchstalter und Filtern), prüfen auf verwertbare Anhänge und weisen Paperless an, diese aufzunehmen – optional samt der in der Regel hinterlegten Metadaten. Danach wird die festgelegte Regel-Aktion auf die Mail angewendet.

Paperless prüft jede Mail nur einmal und ignoriert Nachrichten, die nicht zu Ihren Filtern passen. Die Aktion wird nur auf Mails angewendet, aus denen tatsächlich Dokumente aufgenommen wurden.

Folgende Aktionen stellen sicher, dass dieselbe Mail nicht mehrfach verarbeitet wird:

Löschen: Löscht Mails, aus denen Dokumente aufgenommen wurden, sofort. Mit Vorsicht verwenden.
Als gelesen markieren: Bereits gelesene Mails werden nicht mehr verarbeitet.
Markieren (Flag): Setzt das „Wichtig"-Flag; markierte Mails werden nicht verarbeitet.
In Ordner verschieben: Verschiebt verarbeitete Mails, damit sie nicht erneut aufgenommen werden.
Eigenes Tag hinzufügen: Versieht Mails mit einem Schlagwort (im IMAP-Standard „Keyword"). Nicht jeder Mailserver unterstützt das.

Hinweis: Mit dem richtigen Regelsatz automatisieren Sie Ihre E-Mail-Dokumente vollständig. Die Standard-Aktion „Als gelesen markieren" ist unkritisch und verursacht keinen Datenverlust. Sie können auch einen eigenen Mailordner für Paperless anlegen und Mails dorthin verschieben.

Paperless prüft Ihre Mails standardmäßig alle 10 Minuten.

Verarbeitete Mails

Paperless merkt sich verarbeitete Mails, um sie nicht doppelt aufzunehmen. Dazu dient die eindeutige Nachrichten-UID des Mailservers. Unter Mail → Verarbeitete Mails können Sie diese einsehen und verwalten. Möchten Sie eine Nachricht erneut verarbeiten, löschen Sie den zugehörigen Eintrag – beim nächsten Abruf wird die Mail wieder aufgenommen.

Hinweis: Für Gmail- und Outlook-Konten wird auch die Anmeldung per OAuth2 unterstützt. Die Einrichtung erfordert etwas Konfiguration und ist Sache der Administration bzw. Ihres Hosting-Partners.

Doppelte Dokumente

Standardmäßig weist Paperless Duplikate nicht ab. Nehmen Sie eine Datei auf, deren Inhalt exakt einem bestehenden Dokument entspricht (gleiche Prüfsumme), wird die Kopie trotzdem aufgenommen und eine Warnung protokolliert. Der Aufgaben-Eintrag kennzeichnet das erkannte Duplikat und verlinkt auf das/die bestehende(n) Dokument(e).

Zum Prüfen öffnen Sie ein Dokument und wechseln auf den Reiter Duplikate. Dort werden Dokumente mit identischem Inhalt aufgelistet (auch solche im Papierkorb, mit Kennzeichnung), sodass Sie entscheiden können, welches Sie behalten.