Queue Triggers

Enable you to trigger a process whenever new queue items are available in your queues. The trigger runs in the environment associated with the selected process.

There are three options which help you parameterize the rules for process triggering:

Option	Description
Minimum number of items to trigger the first job	The item-processing job is only started after the targeted queue has at least this number of new items. Deferred queue items are not counted.
Maximum number of pending and running jobs allowed simultaneously	The maximum number of allowed pending and running jobs, counted together. For 2 or more jobs allowed simultaneously, the third option needs to be defined as described below.
Another job is triggered for each __ new item(s).	A new job is triggered for each number of new items added on top of the number of items defined for the first option. Only enabled if there are 2 or more jobs allowed simultaneously (defined using the option described above).

Once every 30 minutes, a check for new items (retried items included) is performed, and if the triggering condition is met, the trigger is launched once again. This ensures all items in the queue are processed in the following situations:

• Queue items are added to the queue much faster than they can be processed with the available resources.
• Queue items are added to a queue during non-working days, but they can only be processed during working hours.

• Queue items processing is postponed for a later time. After that time has elapsed, they are ready to be processed once they have been identified by the 30-minute check.

  Note: Due to the 30-minute check, there's a risk of resource obstruction during non-business hours. To avoid this, make sure there are no unprocessed items at the end of the working day. If that is not a possibility, ensure the triggered process does not require human intervention.

Example

I have two jobs:

• One that adds 3 items per second for 20 seconds to the targeted queue (60 items in total).
• One that processes 1 items per second from the targeted queue.

I have defined my trigger as follows:

• Minimum number of items to trigger the first job:31.
• Maximum number of pending and running jobs allowed simultaneously:3.
• Another job is triggered for each 10 new item(s).

I launch the job that adds items to my queue.

1. After 11 seconds (33 items) the first item-processing job is triggered.
2. After another 4 seconds (12 items) the second item-processing job is triggered.
3. After another 4 seconds (12 items) the third item-processing job is triggered.

By the time queue item addition ended, the first job had processed 9 items, the second one 5 items, the third one 1 item. That's 15 items in 20 seconds processed by three jobs.

That means a remainder of 45 items to be processed (60-15). Having 3 jobs, each processing 1 item per second, that means 15 second for the remainder to be processed.

A total of 35 seconds.