This article describes the RPA Queue functionality to add multiple work items to a queue at once.
For a full list of available functions, please read QUEUE functions.
Description
The Add multiple items function adds a batch of work items to a queue from a data variable. This is more efficient than adding items one by one in a loop. Each item in the array can have its own reference, priority, and data payload.
Setting it up
To use the Add multiple items function, follow these instructions:
{{popups:rpas/add:action=queue-bulk-add}}
Once on a process map:
- Navigate to the process where you would like to add the function
- Click on the green button’s drop-down (right side of the green button labelled “Process”)
- On the menu that appears, click on the “+ Activity” item
- From here you can select the QUEUE Add multiple items to queue option
- Click "Add" once you are done
Input parameters
| Parameter | Required | Type | Default | Description |
|---|---|---|---|---|
| Queue ID | Yes | Text | - | The ID of the queue, or a variable such as {queue_id} |
| Variable | Yes | Text | - | Name of the variable containing the JSON array of items to add |
Output variables
| Variable | Type | Description |
|---|---|---|
| Variable | Array | Array of created queue items |
Errors
- Queue not found – if the queue ID is invalid
- Duplicate reference – individual items may fail if unique references are enforced
Tips
- Load data from Excel or a database first, then use this function to enqueue all rows at once
- Each item in the array should have keys like: reference, priority, specificContent