action-center
2023.4
false
- Release notes
- Before you begin
- Getting started
- Activities
- Designing long-running workflows
- Start Job And Get Reference
- Wait For Job And Resume
- Add Queue Item And Get Reference
- Wait For Queue Item And Resume
- Create Form Task
- Wait For Form Task And Resume
- Resume After Delay
- Assign Tasks
- Create External Task
- Wait For External Task And Resume
- Complete Task
- Forward Task
- Get Form Tasks
- Get Task Data
- Add Task Comment
- Update Task Labels
- Actions
- Processes
- Notifications
Add Queue Item And Get Reference
Action Center
Last updated Oct 17, 2024
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
variable, in order to wait for transaction completion at any time during the execution of the workflow.
Designer panel
- 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
. - Priority - The priority level of the Queue Item that is added. This property is a criterion for the prioritization of queue items, alongside Due Date and Defer Date.
- 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::
,.
,,
,@
,"
. - 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.
Properties panel
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)
andDateTime.Now.Add(New System.TimeSpan(5, 0, 0, 0))
. Additionally, you can use the US notation to add an exact time, such as12/10/2017 07:40:00
. Automatically correcting this date is available. For example, if you write8 9 2018 9:0
, it is automatically transformed to08/09/2018 09:00:00
. - Orchestrator Folder Path - 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: The FolderPath 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 permissions 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 accepts
Dictionary<string, object>
variables only. - 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)
andDateTime.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 write8 9 2018 9:0
, it is automatically transformed to08/09/2018 09:00:00
. - Priority - The priority level of the Queue Item that is 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 Queue Item that is added. 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.
- 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
. - Priority - The priority level of the Queue Item that is added. This property is a criterion for the prioritization of queue items, alongside Due Date and Defer Date.
- 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::
,.
,,
,@
,"
. - 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.
Advanced options
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)
andDateTime.Now.Add(New System.TimeSpan(5, 0, 0, 0))
. Additionally, you can use the US notation to add an exact time, such as12/10/2017 07:40:00
. Automatically correcting this date is available. For example, if you write8 9 2018 9:0
, it is automatically transformed to08/09/2018 09:00:00
. - Orchestrator 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: The FolderPath 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 permissions for the target folder, queue item creation fails and throws a critical error. You can
view more info on Folder Permissions here.
- ItemInformationCollection - Enables importing an entire dictionary of information for a queue item. This field accepts
Dictionary<string, object>
variables only. - 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)
andDateTime.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 write8 9 2018 9:0
, it is automatically transformed to08/09/2018 09:00:00
. - Priority - The priority level of the Queue Item that is added. This property is a criterion for prioritizing 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 Queue Item that is added. 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.