Skip to content

Escalate Work Item

Properties

  • Input
  • Work Item Id
    • Type:int?
    • Description: The unique identifier of the work item to escalate. This is a required argument.
  • Method
    • Type:WorkItemMethod?
    • Description: The method used to escalate the work item (e.g.,WorkItemMethod.Random). This is a required argument.
    • Default Value:WorkItemMethod.Random
  • Group Id
    • Type:int?
    • Description: The group ID that contains the user(s) to escalate the work item to. This is an optional argument.
  • Roles
    • Type:List<GroupRoleType>
    • Description: The user roles that this work item will be assigned to (e.g.,verifydocorverifyshred). This is an optional argument.
  • User Id
    • Type:string
    • Description: The user ID to escalate the work item to. Only valid if Method is set toWorkItemMethod.User. This is an optional argument.
  • Comment
    • Type:string
    • Description: The comment that will be visible to the user actioning the work item. This is an optional argument.
  • Grace Period
    • Type:TimeSpan?
    • Description: The grace period allowed before the work item is automatically escalated to a different user. This is an optional argument.
  • Reason
    • Type:WorkItemReason?
    • Description: Work item reason (e.g.,WorkItemAction.DataSet). This is an optional argument.
  • ReasonLookup
    • Type:int?
    • Description: An optional reason lookup identifier. This is an optional argument.
  • ReasonRecord
    • Type:int?
    • Description: An optional reason record identifier. This is an optional argument.
  • ReasonCode
    • Type:string
    • Description: An optional reason code. This is an optional argument.
  • ReasonDescription
    • Type:string
    • Description: An optional reason description. This is an optional argument.
  • ReasonComment
    • Type:string
    • Description: An optional reason comment. This is an optional argument.

Usage

  1. Setup Activity:
  2. Add the "Escalate Work Item" activity to your UiPath workflow.
  3. Configure the required input arguments:
    • Work Item Id: Provide the unique identifier of the work item to escalate.
    • Method: Specify the method used to escalate the work item.
  4. Optionally, specify additional parameters such as group ID, user ID, roles, comments, grace period, and reasons.
  5. Execution:
  6. The activity executes asynchronously, escalating the specified work item to another user or group based on the defined options.
  7. It uses the configured API context to perform the escalation via the work item client.
  8. Output:
  9. The activity returns anObservableCollection<WorkItemViewModel>, representing the escalated work item(s).

Considerations

  • Escalation Method: Choose the appropriate method for escalation, whether it's to a specific user, group, or based on roles.
  • Assignment Options: Use theGroup IdandUser Idproperties to control work item assignment. Specify roles if needed.
  • Performance: Be mindful of the potential performance impact when escalating a large number of work items, and consider batching or throttling if necessary.
  • Error Handling: Implement error handling to manage potential issues such as network connectivity problems or invalid input data.