Working with the Assignments in Error report

Select > Process & Rules > Tools > Work Admin > Worklist Assignment Errors (or Workbasket) to access a list of assignments on user worklists or in workbaskets that cannot be performed by those users.

What is an assignment in error?

After a flow execution creates an assignment, many types of rules other than flows may operate on the assignment, including:

When such rules, operating on an assignment, encounter problems, the system:

  1. Changes the Instruction text on the assignment to begin with the word Error: followed by a problem description.
  2. Includes the assignment on one of the two reports accessed from this panel, depending on whether the assignment resides on an operator worklist or in a workbasket.

You may need to update a flow, a router activity, add a missing workbasket, and so on.

In a production setting, review and diagnose every problem assignment to insure data integrity.

Using the In Worklists report

Assignments are grouped by the type of error encountered:

Error

Description and possible causes

Agent SLA Activity The Pega-ProCom agent or another agent cannot find the flow, the Operator ID data instance, an activity referenced in the service-level agreement rule or another object needed to process an assignment. Confirm that the agent(s) have access to all the needed RuleSets and versions, through an access group.
Agent SLA Open The Pega-ProCom agent or another agent cannot find the service-level agreement rule referenced in a flow. Confirm that the agent(s) have access to all the RuleSets and versions, through an access group.
Agent Work Object The Pega-ProCom agent or another agent cannot find the work item referenced in an assignment.
Assignment Mismatch Assignment details in the work item do not match data in an instance in the Assign-Worklist or Assign-Workbasket. See PDN article Troubleshooting: Error:Assign Mismatch " when a Before This Action activity transfers a work item.
Flow Not at Task The assignment instance does not match any assignment shape in the flow. The flow may have been updated to rename or delete the assignment shape after the assignment was created.
Flow removed The flow referenced in this assignment cannot be found.
Harness Fail Problems were encountered in finding or processing a harness for this assignment.
Work Open The work item referenced in the assignment cannot be opened, or the class (work type) cannot be found.

Click the plus sign to expand the group. Click any row to review the assignment.

After you have diagnosed and addressed a problem, select the Add box in one or more rows of this report. Then click a button to reflect your disposition of the issue.

Button

Result

Refresh   Update this report with the latest list of assignments with error.
Select All   Select the Add box for every row in the report.
Deselect All   Clear the Add box for every row in the report.
Clear Error  
Status  
Restore the previous value for the Instructions for this assignment. Remove this assignment from the report. The assignment remains on the worklist or workbasket as before.
Delete   Delete the assignment. Use this with caution; this does not restart flow execution or resolve the work item.

Fixing missing assignments and assignment mismatches

As of Version 5.4, an operator can fix assignments that are missing from or have mismatching information on the pxFlow page.

Missing assignments

If an assignment is missing, the work item cannot be opened when a flow is initiated. Here is an example of the error message:

Unable to open an instance using the given inputs: ASSIGN-WORKLIST PEGASAMPLE W-12221!BASICPROCESS.

This error can occur after a work item is created and the flow is validated. This error is not displayed in your worklist or Assignments in Error report.

The error typically occurs when the property .pxAssignmentKey was deleted from table pc_assign_worklist or pc_assign_workbasket and therefore is not present on page pxFLow. To fix the null assignment, open the work item and start the flow by clicking the flow link. When the error message appears, click Restore This Assignment. When you run the flow again, a new assignment is created for the work item.

Assignment mismatches

An assignment mismatch error appears in the Assignments in Error report when assignment details in the work item do not match data in an instance in the Assign-Worklist or Assign-Workbasket. The error can be the result of the property .pxTaskName having been modified in table pc_assign_worklist or pc_assign_workbasket causing a mismatch on page pxFLow. Here is an example of the error message:

The work item references a different assignment than the current one.

To create the correct the mismatch, locate and open the item and click Repair This Assignment. When you run the flow again, the assignment is rebuilt matching .pxTaskName property with the property name on page pxFlow. (For examples, see PDN article How to fix assignments that are deleted or do not match work items.

NoteAssignments can be repaired or recreated only when the page pxFlow is present and valid .

Using the In Workbaskets report

The Assignments with Errors In Workbaskets report lists assignments with errors routed to workbaskets that you can access.

This report operates similarly to the Assignments with Errors in Worklist report. See above instructions.

Definitions Assign- base class, assignment, flow
Related topics Flows — Concepts and terms

Up Process and Rules category — Tools menu