activities
latest
false
UiPath logo, featuring letters U and I in white

Workflow Activities

Last updated Dec 20, 2024

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).

Return value

QueueItem

The retrieved TransactionItem.

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.