diff --git a/docs/integrations/document-import.md b/docs/integrations/document-import.md index 0c5c54628..d7a0163f1 100644 --- a/docs/integrations/document-import.md +++ b/docs/integrations/document-import.md @@ -152,8 +152,15 @@ What it does: quick. Documents you deleted in HealthLog stay deleted, also after they are removed for good. The same goes for a file you had already uploaded by hand: the import recognises it by its content (sending it once to - compare), and if you delete it later, the import leaves it deleted. An - interrupted run simply picks up where it stopped. + compare), and if you delete it later, the import leaves it deleted. Since + v1.39.3 a deleted document is also recognised by its content while it is + in the 30-day undo window: the same file arriving from another system or + under a new id is answered "deleted" and not stored again. After the purge + HealthLog keeps the ids it saw, not the content. An interrupted run simply + picks up where it stopped. +- Once HealthLog has refused one file as too large, the script skips any + further document the source already lists as larger (Papra lists sizes) + without downloading it. - When HealthLog asks it to slow down, it waits as long as HealthLog says and carries on. By default a document token may send 120 uploads an hour, so an archive of a thousand documents takes a night. Every upload that diff --git a/docs/self-hosting/document-sources.md b/docs/self-hosting/document-sources.md index 8b35367a0..4a30cdd2c 100644 --- a/docs/self-hosting/document-sources.md +++ b/docs/self-hosting/document-sources.md @@ -49,7 +49,9 @@ Settings → Integrations → Document archives: - **Paperless-ngx:** the base address and an API token (Paperless-ngx: My Profile → API token). Paperless-ngx 2.16 or later (API version 9). - **Papra:** the base address, the organization id (from the Papra address - bar) and an API key with `documents:read` and `tags:read`. + bar, `org_` followed by 24 letters and digits) and an API key with + `documents:read` and `tags:read`. The connection test reads the tags too, + so a key without `tags:read` is refused at save. HealthLog tests the connection before saving it. A saved token is only ever sent to the address it was saved for: changing the address to another origin @@ -69,6 +71,15 @@ limit for a document). ## Limits and rules +- Name search on Paperless-ngx uses its own title filter. On a Paperless-ngx + that stores its data in SQLite, that filter ignores upper and lower case + only for plain ASCII letters: searching `röntgen` does not find `Röntgen`. + That is Paperless-ngx's behaviour, not HealthLog's; PostgreSQL-backed + Paperless does not have it. +- A document deleted in HealthLog is recognised by its content during the + 30-day undo window, so the same file from another archive is not stored + again; after the purge only its ids are remembered. + - Imports count against the person's normal upload allowance (60 an hour) and storage quota. - A document that is already in HealthLog is not stored twice, and one the