Troubleshooting errors in bulk processing
When you process cases in bulk, you might encounter errors. To resolve common issues that prevent you from processing multiple cases, follow the respective guidelines for each problem scenario.
The following are the most common issues that can occur during bulk question imports:- The Operator menu of your portal does not contain the Bulk actions option.
- The list of items to bulk process is read-only.
- The Processing Results column displays a failed status.
- The Processing Results column never displays a status.
- The Instruction column displays errors.
- You receive no notification when background processing is complete.
- The list of flow actions in the Select Action list is incomplete.
Condition
Users want to create or update cases, or run flow actions on multiple cases. One of several problems prevents users from processing cases.
Cause: The Operator menu of your portal does not contain the Bulk actions option.
Solution: Granting the appropriate privileges to your operator.
- Associate a role with your access group that grants you the Work-.PerformBulk privilege. For more information, see Granting privileges to an access role.
- Refresh your browser session.
Cause: The list of items to bulk process is read-only because another user has a lock on some cases.
Solution: Coordinating your work on cases with other users.
- Hover over the Lock icon in the list of cases to see the name of the user who currently has the case open.
- Contact the user to coordinate an appropriate time for you to bulk process the case.
- After the user releases the lock, click Update to refresh the list.
Cause: The Processing Results column displays a failed status.
Solution: Resolving bulk processing errors.
- Hover over the failed status to view an error message.
- Follow the instructions in the error message to resolve the issue.
- Rerun the bulk action.
Cause: The Processing Results column never displays a status.
Solution: Enabling the bulk processing agent.
- In the navigation pane of Dev Studio, click Records.
- Expand the SysAdmin category, and then click Agents.
- In the list of agents on your node, click the Pega-ProCom agent.
- On the Schedule tab, in the Scheduled Agents list, add the AgentBulkProcessing activity, and then select the Enabled check box for this activity.
- In the Agent-Wide Settings section, select the Enable this agent check box.
- Click Save.
Cause: The Instruction column displays errors.
Solution: Resolving assignment errors.
- In the header of Dev Studio, click .
- In the Assignments with errors window, review the list of problem assignments and their corresponding error messages to determine which errors you can clear.
Cause: You receive no notifications when background processing is complete.
Some flow actions support background processing, which can help you complete your work faster when you run a flow action for many cases. As a result, an agent queues each request and sends you an email when processing finishes. For more information, see Queue processor rules.
Solution: Configuring the email account
- Ensure that the Default email account is correctly configured in your application. For more information, see Creating an email account.
- On your Operator form, verify that the Email field contains a valid email address.
Cause: The list of flow actions in the Select Action list is incomplete.
Solution: Configuring the display of flow actions.
- Display a flow action that is disqualified from bulk processing:
- In the navigation pane of Dev Studio, click Records.
- Expand the Process category, and then click Flow Action.
- Open the flow action that is missing from the Select Action list.
- On the Action tab of the Flow Action form, in the Indicator section, clear the Disqualify this action from bulk processing check box.
- Click Save.
- Display flow actions for cases:
- On the Bulk actions page, in the Filter Property column, remove the filter criteria that evaluate an assignment.
- Click Filter Cases.
- Select the check box next to each case for which you want to run the flow action.
- Display flow actions and connector actions for assignments:
- On the Bulk actions page, in the Filter Property column, add filter criteria that evaluate an assignment.
- Click Filter Cases.
- Select the check box next to each assignment for which you want to run the flow action.
Complete any of the following steps:
Previous topic Running flow actions in bulk Next topic Following a case