QUEUE functions overview

Description

This article provides an overview of the Queue functions available in RPA. Queues allow you to distribute high volumes of work items across bots for processing, with built-in retry logic, priority handling, and SLA tracking.

Key concepts

• Queue – a named container that holds work items for processing
• Work item – a unit of work with input data (specific content), priority, and status
• Dispatcher – a process that adds items to a queue
• Performer – a process that retrieves and processes items from a queue
• SLA – service level agreement tracking per item (on time, at risk, overdue)

Item lifecycle

Each queue item moves through these statuses:

1. New – item added, waiting to be picked up
2. In Progress – a bot has claimed the item and is processing it
3. Successful – processing completed without errors
4. Failed – processing failed (application errors auto-retry, business errors are permanent)

Available Queue Functions

• Add item to queue: Adds a single work item to a queue.
• Add multiple items to queue: Adds multiple items in bulk.
• Get next item: Retrieves and locks the next unprocessed item.
• Mark item as complete: Marks an item as successfully processed.
• Mark item as failed: Marks an item as failed with an error.
• List queue items: Lists items in a queue filtered by status.
• Get queue statistics: Returns queue metrics and counts.