Exact Synergy

BDScheduler.exe - Background process

Introduction

BDScheduler.exe is a background job which performs four basic functions:

If you upload a document with pictures into e-Synergy the pictures in that document are also saved in the database. When you delete the document the pictures remain in the database but there are no links to them. When BDScheduler runs it checks for pictures that aren't linked to any document and deletes those pictures. This will ensure the database isn't using up too much diskspace.

Via [Documents > Reports > Statistics] you can view different overviews related to the documents in your e-Synergy database. For example you can view how many documents are linked to the main categories. These overviews are updated every time BDScheduler runs.

When creating a document you can enter a date after which the document is expired. When BDScheduler runs it checks all documents for an expiry date. When the expiry date of a document has passed the job will delete this document.

It updates active document versions - from batch 340 on Document Version Management is possible. This means there can be different versions saved of one document. When a new version is created for a certain document this new version needs to be activated. This can be done manually by the creator or the administrator. It can also be done automatically with the BDScheduler background job.

Technical Information

The following tables are involved when running BDScheduler.exe:

• BacoDiscussions (Documents)
• BacoDiscussionCounts (Counts new documents)
• BDPictureRefs (Links between documents and pictures
• BacoDiscussionPictures (Pictures)

There are a number of specific parameters which can be included when running BDScheduler.exe. Be advised that per scheduled job you can only add one specific parameter (the mandatory parameters /S: and /D: are not taken into account). It is mandatory to incluse a /C: parameter in the command line otherwise the job will not work. So for each parameter you'd like to be executed you need to add a scheduled job with the BDScheduler.exe application:

• /C:Counter - this parameter recalculates all document counts which are displayed when using the "Category" view of e-Documents. This parameter also removes the "New" indication in that same overview.
• /C:Picture - this parameter removes all pictures in the database that aren't used by any document.
• /C:FillPicture - this parameter is the calculation of all existing document references for pictures. This parameter is also executed when the /C:Picture parameter is added, but only if the BDPictureFilled = N.
• /C:DelExpiryDOC - this paramater removes all the expired documents based on the expiry date set for those documents
• /C:DocVersions - this parameter is only available from batch 340 and updates the versions of the documents. When a version is added for a specific document this parameter will make sure the new version is set to "active".

An example of the use of those specific parameters is:

• C:\Synergy\bin\BDScheduler.exe /S:SynServer /D:Synergy /C:Picture

Settings e-Synergy

If you want to let BDScheduler delete documents which are expired you need to enter a deletion date when creating or editing the document. This must be done in the header of the document (when in edit mode):

In order to make full use of the document version control parameter (/C:DocVersions) for BDScheduler.exe certain settings and functionality needs to be used in e-Synergy. To learn more about document version management within e-Synergy please read this document: Batch 340: New functionality: Document version management.

Troubleshooting

When running the BDScheduler.exe as a background job you can view the logentries made via [System > Reports > Log > Processes]. When checking those entries you might find following message:

The BDScheduler.exe job is programmed in a way that it only starts deleting pictures when the number of pictures is over a 1000. When the amount of pictures is below 1000 it will not delete any pictures.

Related Topics

• Installation background jobs
• Why do my documents remain listed as new, when they are created weeks ago?