Internal background job system

ImageMaster has an internal background job processing system. The job system is used to fulfill tasks by executing background jobs periodically. Each task is performed by a dedicated job. Each job is denoted by a job name according to the table in the bottom.

Some jobs are system jobs, which are special in the following ways:

  • A system job must exist exactly once in the system.

  • A system job has no schedule, or an empty schedule. It only reacts to specifically enqueued tasks and does not enqueue its own tasks.

  • A system job cannot be deleted via deleteJob().

  • A system job cannot be configured via the AdminClient.

Job-related configurations can be set according to the installation manual [IM ImageMaster], like:

Each non-system job has a schedule when it needs to be run (see Job schedules) and a job configuration (see Job configuration). These two job properties can be configured via the ImageMaster AdminClient [UM AdminClient].

ImageMaster may have custom jobs at customer side, for instance, for reporting automatically via e-mail statistics on the documents archived on the previous day.

The pre-installed jobs are:

Job name

Role

Core system

 

jobController (system job)

jobController

manages the periodic execution of other jobs

ddlRunner (system job)

ddlRunner

performs changes in the database model of ImageMaster (for instance, if new attributes are added to a document type)

mailSender (system job)

mailSender

sends e-mails (for instance, used by the password reset mechanism)

folderCleaner (system job)

folderCleaner

deletes unused folders

planRunner (hourly)

planRunner

executes retention plans

SearchConnector (system job)

roleSearchConnector

performs fulltext indexing of documents

MasterDetailFulltextUpdate (system job)

roleSearchConnector

generates tasks for fulltext indexing of detail documents after a related master document has been updated or scheduled for indexing

recycleBinCleanup

recycleBinCleanup

deletes documents in the recycle bin

Before a document in the recycle bin is permanently deleted, a maximum age needs to be reached. This age is defined by a java.time.Duration. The accepted format is based on the ISO-8601 duration format PnDTnHnMn.nS with days considered to be exactly 24 hours. One job is restricted to one document type. In case of an error (Error DOC-00043 (recycle bin cleanup job)) the recycle bin cleanup job will retry deleting this document during the next run.

Related to exports and reports of the WorkplaceClient

exportCleanupJob

exportCleanupRole

cleans up old exports, which are visible in the WorkplaceClient “Activities” room

gdprReportCleanupJob

gdprReportCleanupRole

cleans up old reports created by the ImageMaster Compliance Cockpit, which are visible in the WorkplaceClient “Activities” room

Signature Service

 

TrustListUpdate (monthly)

signatureService

downloads national eIDAS trusted lists of the European Commission

Business Process management

 

WorkflowHistoryJob (system job)

workflow

stores the workflow history as a hidden XML attachment on the document when a workflow completes (for long-term preservation)

WorkflowNotificationDaily (daily)

workflow

sends daily notifications about pending workflow tasks for users who have daily notifications enabled

WorkflowNotificationWeekly (weekly)

workflow

sends weekly notifications about pending workflow tasks for users who have weekly notifications enabled

Content Services for E-Mail

 

purgeMsxStatisticsJob

purgeMsxStatisticsRole

deletes the OPCS statistics for batch archiving runs (Spider or Add-in) of mailboxes according to the configured threshold

disposeMsxMailboxesJob

disposeMsxMailboxesRole

deletes the mailbox document/object from the ImageMaster mailbox list based on the “disposal threshold (in months)” of the mailbox policy

This job is used in the context of retention management to also delete the mailbox information after all e-mails of a mailbox have been deleted by retention management.

triggerMailboxSpiderQueueUpdateJob

triggerMailboxSpiderQueueUpdateRole

needed internally for the Mailbox Spider process

Based on the “Spider threshold (days)” value of mailbox archiving policies, the expired mailboxes are forced to be archived by the Mailbox Spider. The mailboxes are enqueued to the "Mailbox Spider Queue".

triggerFinalArchiveMailboxSpiderQueueUpdateJob

triggerMailboxSpiderQueueUpdateRole

needed internally for the Final Archive Spider process

Based on the “Spider threshold (minutes)” value of final archiving policies, the expired mailboxes are forced to be archived by the Final Archive Spider. The mailboxes are enqueued to the "Final Archive Spider Queue".

synchronizeMailboxesJob

synchronizeMailboxesRole

synchronizes existing mailboxes of the configured Exchange environments with the internal ImageMaster mailbox list

New mailboxes are added. Existing mailboxes are updated. Deleted mailboxes are kept untouched in ImageMaster.

Messaging for ERP

 

CleanupTransferJobs

SAPMSGrole

deletes successfully processed transfer jobs (see Messaging Service maintenance via job system in [SM ERP MSG])

executeTransferJobs

SAPMSGrole

initiates document transfers to SAP (see Messaging Service job “executeTransferJobs” in [SM ERP MSG])

Table 370: Pre-installed jobs