Document Central Job Queues
Document Central relies on Business Central job queue entries to execute background operations such as archiving, synchronizing repositories, and handling retention policies. The extension installs the standard queues automatically, but administrators can adjust recurrences or recreate the entries whenever needed.
Standard Job Queue Entries
| Job Queue Entry | Purpose | Notes / When to Use | Object to Run | Parameter String |
|---|---|---|---|---|
| Document Central Job Queue – Archive | Processes the Report Queue and uploads reports generated via Shadow Printing to the configured repository. | Default schedule: every minute. Only relevant when Shadow Printing is enabled. | Codeunit 5227515 | ARCHIVE |
| Document Central Job Queue – Synchronize Document Library | Automatically starts the synchronization for all document libraries whose status in the synchronization list is set to “Ready”. | Default schedule: every minute. Not used for manual synchronization: the “Start Synchronization” action triggers a synchronization process without this job queue. | Codeunit 5227515 | SYNCHDOCLIB |
| Document Central Job Queue – Import / Assign | Processes imports and assignments of documents from the Inbound list. | Default schedule: every minute. Only relevant for older versions without Document Inbound. | Codeunit 5227515 | IMPORT |
| Document Central Job Queue – Cycle Creation | Creates and publishes new future SharePoint subsites with their Document Libraries according to the configured cycle (e.g., yearly sites for “2025”, “2026”). | Default schedule: first day of the year. Only relevant for SharePoint repositories. Should be disabled for other repository types. | Codeunit 5227515 | CYCLE |
| Document Central Job Queue – Clean Uploads | Correct internal upload status values for document entries where the upload succeeded in the repository but the status in Business Central is incorrect. | Default schedule: every minute. Only relevant for SharePoint Repositories. Does not delete any BLOB fields. Only fixes an internally used upload status record. | Codeunit 5227515 | CLEANUPLOADS |
| Document Central Job Queue – Migration | Migrates documents from a SharePoint site using Basic Authentication to the currently configured SharePoint site. Scope of migrated data can be defined. | Default schedule: every minute. Only required during a SharePoint migration scenario. | Codeunit 5227515 | MIGRATIONQUEUE |
| Document Central Job Queue – Search Indexer | Indexes documents stored in Azure Blob Storage to provide full-text search capabilities across the repository. | Default schedule: every hour. Only relevant when using Azure Blob Storage with full-text search enabled. | Codeunit 5227515 | SEARCHINDEXER |
| Document Central Job Queue – Set Retention Label | Processes Retention Queue entries and applies retention labels to document entries based on the retention queue entry entry. | Default schedule: every minute. | Codeunit 5227515 | SYNCRETENTIONLABELS |
| Document Central Job Queue – Retention Crawler | Scans all documents to determine whether they should receive a retention label and submits corresponding entries to the retention queue queue. | Default schedule: every minute. When an document was dropped and should have recieved an retention label based on the configuration, the retention crawler will not transfer this document to the retention queue. | Codeunit 5227515 | RETENTIONCRAWLER |
| Document Central Job Queue – Clear BLOB Fields | Removes all document BLOBs stored in the Business Central database (Archive Queue Entries with the Status Archived, Document Entries) once the corresponding files are safely stored in an external repository (e.g., SharePoint or Azure Blob Storage) to reduce database size. | Runs once (not recurring). Only relevant when external repositories are in use. This job queue is for troubleshooting purposes when blobs were unintentionally stored in the Document Blob fields while using an external repository in older versions. Use this job queue when the Document Entry table takes up enormous space to check whether the space relates to the problem. | Codeunit 5227515 | CLEARBLOBFIELDS |
| Document Central Job Queue – Delete Expired Retention | Deletes document entries whose retention label has expired. Only entries whose label has the Automatic Deletion property enabled in Document Central are removed. | Default schedule: every minute. For SharePoint, enable Automatic Deletion on the label in Microsoft Purview; Document Central cannot modify this setting. For Azure Blob Storage, configure Automatic Deletion on the retention label ind Document Central when required. | Codeunit 5227515 | DELETEEXPIREDRETENTION |
| Document Central Job Queue – Recreate Metadata | Automatically starts metadata recreation for all document libraries whose status in the Metadata Recreation list is set to “Ready”. | Default schedule: every minute. Not used for manual recreation; the “Start Recreation” action runs immediately without this job queue. | Codeunit 5227515 | RECREATEMETA |
Info
Adjust recurrences or disable individual queues directly in Business Central if you need to align processing with maintenance windows.
Additional Usage Guidelines
Recurrence Customization
Administrators can adjust the recurrence interval of each job queue (e.g., every minute, hourly) to match performance considerations, service windows, or system load.
Error Threshold Configuration
In the Document Central setup, the maximum number of allowed errors per job execution can be configured before warnings or notifications are triggered.
Repository Use Cases
The following job queues are relevant for an SharePoint repository
- Cycle Creation
- Clean Uploads
- Synchronize Document Library
- Migration
- Set Retention Label
- Retention Crawler
- Delete Expired Retention
The following job queues are relevant for an Azure Blob Storage repository
- Search Indexer
- Clear BLOB Fields
- Synchronize Document Library
- Set Retention Label
- Retention Crawler
- Delete Expired Retention
The following job queues are relevant for All repository
- Archive
- Import / Assign
- Recreate Metadata
Restoring the Standard Entries
If job queue entries are missing or were modified incorrectly, recreate them from the Document Central role center:
- Open the Document Central - Administrator role center.
- Run the Create Default Entries action in the Job Queue Entries list.
- Confirm the dialog to rebuild all Document Central job queue entries.
Configuring Error Handling
Use the module setup to limit how many errors a queue run can accumulate:
- Navigate to the Document Central - Administrator role center.
- Choose Setup > Module Setup.
- In the Job Queue section, set Maximum Errors per Job Queue Run to the desired threshold.
- Save the changes.
Monitoring and Maintenance
- Review the status of Document Central queues regularly on the Job Queue Entries page.
- Investigate entries that remain in Error before increasing the maximum error threshold.
- Keep dependent queues, such as Retention Crawler and Set Retention Label, on compatible recurrences when you adjust schedules.
- In sandbox environments, you can disable queues that are not required to avoid unnecessary processing.