Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Assigning a task to a robotic work queue

Updated on March 29, 2022

Use the Assign to Robot Queue shape in a flow to integrate Robotic Process Automation (RPA) with a case. By defining the tasks that a virtual machine (VM) can run, you can reduce the need for human input in your application and resolve cases faster.

  1. Add the Assign to Robot Queue shape to your flow:
    1. Open a flow by searching for it or by using the Application Explorer. For more information, see Finding rules by class.
    2. On the Diagram tab of the Flow form, click the Flow shapes icon, and select Advanced ShapesAssign to Robot Queue.
    3. Drag the Assign to Robot Queue shape to a position on the flow diagram, based on the order of events in the flow.
    4. Connect the Assign to Robot Queue shape, by dragging connector end points to connection points on different shapes in the flow.
  2. Open the Robot queue dialog box by double-clicking the Assign to Robot Queue shape.
  3. Define the context of the robotic automation, which runs as a subprocess of the current flow:
    • To work on the current case, from the Define flow list, select On current page.
    • To work on a specific case, from the Define flow list, select On specific work item. Complete the Work property, Class , and Page name fields.

      If the case is open as a page on the clipboard, you can leave the Work property field blank.

      If the case does not already have a page and you do not provide a page name, you application creates a page named pyNextObj, pyNextObj_1, and so on.

    • To work on an embedded page, from the Define flow list, select On embedded page. Complete the Page property and Class field names.

      The Page property field must use a mode of Page, Page List, or Page Group.

      If you want to use a class that is not known at design time, in the Class field, you must enter a property reference or expression.

  4. In the Route to queue field, enter the name of the work queue from which the VM retrieves assignments.
    Result: The Route to robot queue shape creates the assignment that the VM retrieves.
  5. In the Run robotic automation field, enter the automation that the virtual machine runs after retrieving the assignment.
  6. Optional: To update the status of a case by synchronizing it with the state of the robotic assignment, set the case status changes in the Set case status when section. For each of the assignment states that you want to map to a case status, perform one of the following actions:
    • To select a case status that is triggered by a robotic assignment state, press the Down Arrow key in the corresponding field.
    • To create a custom status, enter a unique name in the field and click on the Open rule icon.

    If you do not select a status in a corresponding field, the previous state of the case will be carried forward.

    The following predefined robotic assignment states add the capability to automatically update your case status and track its progress in a more granular way.

    Robotic assignment stateDescription
    Assignment is queuedChange case status when a robotic assignment is added to a work queue.
    Note: Work queues are called assignment types in Pega Robot Manager.
    Robotic Automation is in progressChange case status when a robot pulls the assignment and starts working on it.
    Robotic Automation has conflicting resultsChange case status when a robotic assignment is completed but returns data that fails validations specified for the case.
    Robotic Automation failsChange case status when a robotic assignment could not be completed and failed.
    Robotic Automation times outChange case status when a robotic assignment could not be completed in the threshold time specified in the assignment type/work queue.
  7. Optional: Validate case data after the assignment is processed by pressing the Down Arrow key in the Assignment validation criteria field and selecting a validation rule.
  8. Optional: Apply a goal and deadline to the assignment by pressing the Down Arrow key in the Assignment service level field, and select the name of a service-level agreement.
  9. Optional: Allow the main flow to continue processing without waiting for the robotic automation to complete by selecting the Spinoff flow check box.
  10. Close the Robot queue dialog box by clicking Submit.
  11. Click Save.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us