docs: add documentation for Paperless custom field configuration
Co-authored-by: christianlouis <361235+christianlouis@users.noreply.github.com>
This commit is contained in:
@@ -212,10 +212,11 @@ SECURITY_HEADER_CSP_VALUE="default-src 'self'; script-src 'self' https://trusted
|
||||
|
||||
### Paperless NGX
|
||||
|
||||
| **Variable** | **Description** |
|
||||
|-------------------------------|-----------------------------------------------------|
|
||||
| `PAPERLESS_NGX_API_TOKEN` | API token for Paperless NGX. |
|
||||
| `PAPERLESS_HOST` | Root URL for Paperless NGX (e.g. `https://paperless.example.com`). |
|
||||
| **Variable** | **Description** |
|
||||
|-----------------------------------|-----------------------------------------------------------------------------------------------------|
|
||||
| `PAPERLESS_NGX_API_TOKEN` | API token for Paperless NGX. |
|
||||
| `PAPERLESS_HOST` | Root URL for Paperless NGX (e.g. `https://paperless.example.com`). |
|
||||
| `PAPERLESS_CUSTOM_FIELD_ABSENDER` | (Optional) Name of the custom field in Paperless-ngx to store the sender ("absender") information. If set, the extracted sender will be automatically set as a custom field after document upload. Example: `Absender` or `Sender` |
|
||||
|
||||
### Dropbox
|
||||
|
||||
|
||||
@@ -145,6 +145,19 @@ Depending on the system configuration, DocuElevate can perform:
|
||||
- **PDF Conversion** - Convert various file formats to PDF
|
||||
- **Document Distribution** - Store documents in Dropbox, Nextcloud, or Paperless NGX
|
||||
|
||||
### Paperless-ngx Integration
|
||||
|
||||
If Paperless-ngx is configured, DocuElevate can automatically upload processed documents and set custom fields with extracted metadata:
|
||||
|
||||
1. **Automatic Upload**: After processing, documents are automatically uploaded to Paperless-ngx
|
||||
2. **Custom Fields**: If configured via `PAPERLESS_CUSTOM_FIELD_ABSENDER`, the sender ("absender") information extracted by AI will be automatically set as a custom field in Paperless
|
||||
3. **Setup Requirements**:
|
||||
- Create a custom field in Paperless-ngx (e.g., named "Absender" or "Sender")
|
||||
- Set the `PAPERLESS_CUSTOM_FIELD_ABSENDER` environment variable to match your custom field name
|
||||
- Ensure the custom field exists in Paperless before processing documents
|
||||
|
||||
**Note**: The custom field feature requires that the field is already created in your Paperless-ngx instance. DocuElevate will look up the field by name and set its value automatically.
|
||||
|
||||
## API Access
|
||||
|
||||
For programmatic access, DocuElevate provides a comprehensive REST API:
|
||||
|
||||
Reference in New Issue
Block a user