Creating a Queue
- In the Queues page, click Add. Three buttons are displayed allowing you to add a queue, link queues from other folders, or hide the options.
- Click Add. The Create Queue window is displayed.
- In the Name field, enter a name for the queue.
- In the Description field, add a description for the queue.
- In the Unique Reference field, select Yes or No, to indicate if you want transaction references to be unique or not.
- In the Auto Retry field, select Yes or No to indicate if you want to use the auto-retry mechanism.
- In the Max # of retries field, if you selected Yes at step 5, input the number of times you want a queue item to be retried.
- Upload a JSON schema for any or each of Specific Data, Output Data, and Analytics Data by using the corresponding Browse button.
- Enable SLA predictions if you want to better control the processing time of your items, and to assess what resources you need such that they meet their deadline. If SLA predictions are enabled, configure the following fields:
- From the Process drop-down, select the process which handles the queue items, and then fill in the SLA value below. The maximum value is 90 days.
- Enable Risk SLA if you want to define a buffer zone before the actual SLA, and fill in the value below. The risk SLA must be smaller than the SLA.
- Click Add. The queue is created and displayed on the Queues page, yet it is empty.
You can populate queues either using Studio or on the Upload Items window. Processing items from a queue is only possible using Studio. For more information, see the Managing Queues in Studio page.
Managing Queue Links
Sharing queues between folders enables launching jobs in multiple folders without redesigning your workflows in Studio when the underlying processes are targeting the same queue. Linking a queue to a folder makes the queue and all queue-associated objects, such as queue items, available in that folder.
Note
A queue linked to multiple folders is marked using the icon. If the icon is not present, then the current folder is the only folder the queue resides in. Deleting it here completely removes the queue from Orchestrator.
You need the Queues - Create permission in the folders where you want to add the queue (target folders) and Queues - View in the folder where the queue currently resides (original folder). If you have Queues - Edit in the target folder, you also require Queues - Edit in the original folder.
Linking Multiple Queues to the Current Folder
- In the folder you want to link a queue to, on the Queues page, click Add. Three buttons are displayed allowing you to add a queue, link queues from other folders, or hide the options.
- Click Link Queues From Other Folders. The Link Queues window is displayed showing a list of all queues in the folders in which you have View permissions on Queues.
- On the Select Queues section, select one or multiple queues from the list.
- Click Continue. You are directed to the Folder Validation section. Here you can see the folders the queues are already linked to. If there are multiple folders, the number is displayed. Hover over it to see the folder names.
- Click Remove for the corresponding queue to revert the change or click Exit to cancel the operation.
- Click Link if you want to make the link between the queues you selected and the current folder. The queues are displayed on the Queues page.
Linking a Queue to Multiple Folders
- Navigate to a folder the queue to be linked resides in.
- Click More Actions > Manage Links for the desired queue to open the Manage Links window. The Manage Queue Links window is displayed.
1 - Left-hand pane displaying all the folders you have been granted View permissions on Queues.
2 - The current state of the queue displaying the number of folders it currently resides in as well as their names.
3 - The folders the queue is to be added in according to your selection in the left-hand pane.
4 - The folders the queue will be removed from.
- Click Update. A confirmation window is displayed.
- Click Cancel if you want to abort the changes or Continue for the changes to take effect. The operations are now reflected in Orchestrator according to your changes.
Unlinking Queues From Folders
Unlinking queues from folders can be performed in a manner similar to the linking operation. Navigate to the link-management areas presented in the procedures above and remove the connections between a certain queue and a certain folder.
Alternatively, you can remove a queue using the Remove functionality. See Removing a Queue.
Important
Removing a queue that exists in multiple folders only removes it from the folder where the removal operation takes place, it does not remove it from the other folders as well. In order to completely delete a queue, you must remove all its existing links.
You cannot unlink a queue from a folder in the following situations:
- queue SLA has been enabled in that folder;
- a queue trigger is attached to the queue.
Displaying Transactions
In the Queues page, click More Actions > View Transactions. The Transactions page is displayed, containing only the items from the indicated queue.
Displaying Review Requests
In the Queues page, click on Review Requests to display all the queue items assigned for revision to the currently logged-in user. The page allows for status changes and managing item information.
Displaying the Queue Chart
To view the chart for a specific queue, click More Actions button, and then View Chart.
A line chart displays the transaction status evolution over a specific amount of time. The time period (last hour, day, week, 30 days) can be changed, and you can view the average execution time and the maximum number of retries.
Uploading Items into a Queue
This section concerns adding items into a queue in Orchestrator. For details on how to do that through workflows in Studio, click here.
- In the Queues page, click the corresponding More Actions button of your desired queue, and then Upload Items. The Upload Items window is displayed.
- Click Browse and select the desired .csv file.
- Click Upload. If your file is compliant with the supported formatting rules, the upload operation is successful.
- Select the upload strategy.
- Click Upload. The items are added to your queue according to the previously selected strategy.
- If you used the Process All Independently option and there are unprocessed items, the Upload button becomes Download and enables you to download a .csv file containing the unprocessed items.
Monitoring a Queue
To monitor a queue, click the corresponding More Actions button and then Monitor Queue. Alternatively, select it from the Queues Overview widget (Monitoring > Queues).
Note that monitoring a queue requires your user to have View permissions on Queues and on Monitoring. Additionally, Edit on Monitoring is required in order to disable errors from the Error Feed widget on the Monitoring > Queues page.
Removing a Queue
To remove a queue, click the corresponding More Actions button and then Remove.
Alternatively, select it from the Queues page and click Remove. The queue is no longer displayed on the Queues page.
Important
Removing a queue that exists in multiple folders only removes it from the folder where the removal operation takes place, it does not remove it from the other folders as well. In order to completely delete a queue, you must remove all its existing links.
Note:
After a queue is deleted, assigned transaction items belonging to the queue are no longer visible in the Review Requests page.
Updated about a year ago