WaitQueueItem

Retrieves an Orchestrator queue item from a specified queue and stores it in a QueueItem variable. This method is different from the Get Transaction Item method as, at runtime, in case the specified queue is empty, it sends a message to Orchestrator stating it is ready to receive a queue item and then waits for a new queue item to be added to the specified queue. Once retrieved, the status of the queue item is set to In Progress.

Definition

Namespace: UiPath.Activities.System.API

Assembly: UiPath.System.Activities.Api (in UiPath.System.Activities.Api.dll)

Overloads


`WaitQueueItem(String)`	Waits for an item in the queue to be available so that you can process it (start the transaction) and sets its status to In Progress.
`WaitQueueItem(String, String)`	Waits for an item in the queue, from a specified folder path, to be available so that you can process it (start the transaction) and sets its status to In Progress.
`WaitQueueItem(String, String, Int32, ReferenceFilterStrategy, String, Int32)`	Waits for an item in the queue, from a specified folder path, to be available so that you can process it (start the transaction) and sets its status to In Progress. You can look for queue items based on a filter strategy, and by reference.

`WaitQueueItem(String)`

Waits for an item in the queue to be available so that you can process it (start the transaction) and sets its status to In Progress.

QueueItem WaitQueueItem(
	string queueName
)QueueItem WaitQueueItem(
	string queueName
)

queueName String: The name of the queue where you want to search for the queue item.

`WaitQueueItem(String, String)`

Waits for an item in the queue, from a specified folder path, to be available so that you can process it (start the transaction) and sets its status to In Progress.

QueueItem WaitQueueItem(
	string queueName,
	string folderPath
)QueueItem WaitQueueItem(
	string queueName,
	string folderPath
)

queueName String: The name of the queue where you want to search for the queue item.
folderPath String: The path of the folder where the specified queue is located, if different from the folder where the process is running. This field only supports string values, with / as the separator to indicate subfolders. For example "Finance/Accounts Payable".

`WaitQueueItem(String, String, Int32, ReferenceFilterStrategy, String, Int32)`

Waits for an item in the queue, from a specified folder path, to be available so that you can process it (start the transaction) and sets its status to In Progress. You can look for queue items based on a filter strategy, and by reference.

QueueItem WaitQueueItem(
	string queueName,
	string folderPath,
	int pollTimeMS,
	ReferenceFilterStrategy filterStrategy,
	string reference,
	int timeoutMS
)QueueItem WaitQueueItem(
	string queueName,
	string folderPath,
	int pollTimeMS,
	ReferenceFilterStrategy filterStrategy,
	string reference,
	int timeoutMS
)

queueName String

The name of the queue where you want to search for the queue item.

folderPath String

The path of the folder where the specified queue is located, if different from the folder where the process is running. This field only supports string values, with / as the separator to indicate subfolders. For example "Finance/Accounts Payable".

pollTimeMS Int32

Specifies the amount of time (in milliseconds) between two attempts to retrieve a new item. The default value is 30000 milliseconds (30 seconds).

filterStrategy ReferenceFilterStrategy

The strategy to use when filtering according to reference. The following options are available:

StartWith - looks for items whose references start with the value indicated in the Reference field.
Equals - looks for items whose references are the same as the value indicated in the Reference field.

reference String

Filter items according to their reference.

timeoutMS Int32

Specifies the amount of time (in milliseconds) to wait for the activity to run before an error is thrown. The default value is 30000 milliseconds (30 seconds).