UiPath Activities

The UiPath Activities Guide

Add Queue Item And Get Reference

UiPath.Persistence.Activities.Queue.AddQueueItemAndGetReference

Adds an Orchestrator Queue Item with parameters and retrieves the corresponding Queue Item Object stored in a QueueItemData in order to wait for transaction completion at any time during the execution of the workflow.

Properties

Common

  • ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

Note:

If this activity is included in Try Catch and the value of the ContinueOnError property is True, no error is caught when the project is executed.

  • DisplayName - The display name of the activity.
  • TimeoutMS - 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).

Input

  • Deadline - The timestamp before which the queue item should be processed. This property can be filled in with relative timestamps such as DateTime.Now.AddHours(2), DateTime.Now.AddDays(10) and DateTime.Now.Add(New System.TimeSpan(5, 0, 0, 0)). Additionally, you can use the US notation to add an exact time, such as 12/10/2017 07:40:00. Automatically correcting this date is available. For example, if you write 8 9 2018 9:0, it is automatically transformed to 08/09/2018 09:00:00.
  • FolderPath - The path to an Orchestrator Folder different to the one the current process operates in, where you want to create the queue item. To read more on Orchestrator Folders, go here. For Classic folders, this property can only be used with Floating Robots and only if the current user has the correct task privilege in the target folder. For Modern folders, folder path overriding is not supported. This field supports only strings and String variables.

Note:

This property must be used only if the queue item must be created or queried from a folder different than the current one. If the user performing this action does not have the required permission for the target folder, queue item creation fails and throws a critical error. You can view more info on Folder Permissions here.

  • ItemInformation - A collection of additional information about the specific QueueItem that is to be added. The information is stored in the item and is used during a transaction processing. It is recommended to use only primitive values of the following types: Number, Boolean, String and DateTime. The value of string arguments cannot contain the following characters: [ and " ". Argument names cannot contain the following characters: :, ., ,, @, ".
  • ItemInformationCollection - Enables importing an entire dictionary of information for a queue item. This field only accepts Dictionary<string, object> variables.
  • Postpone - The timestamp after which the queue item may be processed. This property is a criterion for the prioritization of queue items, alongside Priority and Due Date. This property can be filled in with relative timestamps such as DateTime.Now.AddHours(2), DateTime.Now.AddDays(10) and DateTime.Now.Add(New System.TimeSpan(5, 0, 0, 0)). Additionally, you can use the US notation to add an exact time, such as 12/10/2017 07:40:00. Automatically correcting this date is available. For example, if you write 8 9 2018 9:0, it is automatically transformed to 08/09/2018 09:00:00.
  • Priority - The priority level of the queue item to be added. This property is a criterion for the prioritization of queue items, alongside Due Date and Defer Date.
  • Queue Name - The queue where the QueueItem object is to be added. The name is case insensitive, meaning that if in Orchestrator it was defined as "MyFirstQueue", it matches "myfirstqueue". The maximum number of characters is 50.
  • Reference - The reference of the added QueueItem. The reference can be used to link your transactions to other applications used within an automation project. Additionally, this feature enables you to search for certain transactions, in Orchestrator, according to the provided string.

Misc

  • Private - If selected, the values of variables and arguments are no longer logged at Verbose level.

Output

  • Queue Item (Output) - The queue object that is returned from Orchestrator as a QueueItemData object after the queue is created. This object can be passed to the Wait for Queue Item and Resume activity in order to suspend the execution of the workflow until the transaction is completed.

In the Body of the Activity

Some properties can be configured straight from the body of the activity itself, for easier handling, such as:

  • Queue Name
  • Priority
  • Item Information
  • Queue Item Object (Output)

Updated 4 months ago


Add Queue Item And Get Reference


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.