Setting up Job Queues

Synchronizing regularly can be a time-consuming process. Job queues enable you to automate this process, as they can run automatically in the background. When you set up job queues, you can still synchronize manually, if necessary.

In Expense Management, the following recurring activities can be set up for any given job queue:


ActivityDescription
Synchronizing with Continia OnlineA synchronization with Continia Online will:
  • Update setup from Business Central to Continia Online (and consequently to the Continia Expense App and the Continia Approval Portal).
  • Download documents from Continia Online that were submitted by expense users.
Synchronization is required on a regular basis so new documents can be processed as quickly as possible.

To synchronize with Continia Online using a job queue, follow the guide below, but use codeunit 6086305 CEM Online Mgt. instead.
Sending approval emailsExpense Management can send regular emails to approvers to remind them about documents pending approval. This job can be set to run on a daily basis. Expense Management will send an email only if there are new documents to be approved, and the same email will never be sent twice in a day.

To send approval emails using a job queue, follow the guide below, but use codeunit 6086313 Expense Approval E-Mail instead.
Sending reminder emailsExpense Management can send reminder emails to expense users to remind them about pending documents. The reminder setup needs to be configured – otherwise no email will be sent. The reminder setup determines how many days should pass before a reminder email is sent out, and it can be configured for each user.

To send reminder emails using a job queue, follow the guide below, but use codeunit 6086314 Reminder E-Mail instead.
Sending status reportsExpense Management can also send a status report with detailed information about all documents claimed by a user. These documents can be either posted or open documents.

If you would like to specify what details should be included in this report, go to Expense Management Setup, select the E-mail FastTab, and update Status Report Filters. The user will receive an email with a PDF document attached.

To send status reports using a job queue, follow the guide below, but use codeunit 6086353 Send Expense Status Report instead.

To set up job queues

As indicated above, you can use job queues to schedule and run many different tasks and processes. The setup procedure is always the same – only the codeunits/reports are different.

To set up a job queue, follow these steps:

  1. Choose the Search icon, enter Job Queue Entries, and then choose the related link.
  2. In the action bar, select New to open the Job Queue Entry Card.
  3. On the General FastTab, go to Object Type to Run and select the relevant type, depending on whether you're running a codeunit or a report.
  4. In the field Object ID to Run, enter the relevant codeunit/report (see the table above).
  5. In Earliest Start Date/Time, specify the earliest date and time to start running the job queue.
  6. When you've picked or entered a date, the Earliest Start Date/Time field is autofilled with the default time of day, but you can change this if necessary.
  7. On the Recurrence FastTab, specify the recurrence rate of the job queue (if any) by enabling the recurrence toggle for each of the days you want it to run.
  8. Fill out the remaining fields on the Recurrence FastTab as needed.

Note

Job queues sometimes fail, for example due to interrupted communication with an essential external resource that's become unresponsive, eventually resulting in an error status. To avoid this, we recommend that you fill in the fields Maximum No. of Attempts to Run and Rerun Delay (sec.), which are located on the General FastTab. Note that you may have to select Show more for these fields to become visible.

See also

Microsoft's article on job queues