Administering Oracle CRM On Demand > Business Process Management > Workflow Configuration > About Workflow Rule and Workflow Action Failures
About Workflow Rule and Workflow Action Failures
The behavior that you see when a workflow rule or a workflow rule action fails depends on the following:
- Whether the workflow rule is a pre-event rule, a post-event rule, or a scheduled event. This is determined by the trigger event on the workflow rule. For more information about trigger events, see About Workflow Rules.
- The type of error that causes the workflow rule or action to fail.
The following are some examples of errors that can cause a workflow rule or a workflow action to fail:
- A syntax error in an expression in a workflow rule condition or in a workflow action. Some syntax errors cannot be found by Expression Builder when a workflow rule or action is created.
- A semantic error in an expression in a workflow rule condition or in a workflow action. The following are examples of semantic errors that can occur:
- A field in the expression cannot be identified by Oracle CRM On Demand because the integration tag for the field was changed after the workflow rule or workflow action was created.
- An invalid value is specified for a picklist field in the expression.
Post-Event Workflow Rule and Workflow Action Failures
The following table describes the outcome for errors that occur in post-event workflow rules and the workflow actions on those rules.
Type of Error
|
Outcome
|
What is Reported in the Workflow Error Monitor
|
Syntax error in a workflow rule condition
|
- None of the actions on the workflow rule are performed.
- The failure is reported in the Workflow Error Monitor.
- None of the workflow rules configured for the same record type and trigger event are triggered.
- The operation that triggered the workflow rule is not affected by the failure of the rule.
|
Details of the workflow rule on which the error was found, along with details of the error.
|
Syntax error in a workflow action
|
- The workflow action fails.
- The failure is reported in the Workflow Error Monitor.
- If other actions exist on the workflow rule, then those actions are performed.
- If any other workflow rules exist for the same record type and trigger event, then those rules are triggered and the actions on those rules are performed.
- The operation that triggered the workflow rule is not affected by the failure of the workflow action.
|
Details of the workflow action on which the error was found, along with details of the error.
|
Semantic error in a workflow rule condition
|
- None of the actions on the workflow rule are performed.
- The failure is reported in the Workflow Error Monitor.
- If any other workflow rules exist for the same record type and trigger event, then those rules are triggered and the actions on those rules are performed.
- The operation that triggered the workflow rule is not affected by the failure of the rule.
|
Details of the workflow rule on which the error was found, along with details of the error.
|
Semantic error in a workflow action
|
- The workflow action fails.
- The failure is reported in the Workflow Error Monitor.
- If other actions exist on the workflow rule, then those actions are performed.
- If any other workflow rules exist for the same record type and trigger event, then those rules are triggered and the actions on those rules are performed.
- The operation that triggered the workflow rule is not affected by the failure of the workflow action.
|
Details of the workflow action on which the error was found, along with details of the error.
|
Any other error in a workflow action
|
- The workflow action fails.
- The failure is reported in the Workflow Error Monitor.
- If other actions exist on the workflow rule, then those actions are performed.
- If any other workflow rules exist for the same record type and trigger event, then those rules are triggered and the actions on those rules are performed.
- The operation that triggered the workflow rule is not affected by the failure of the workflow action.
|
Details of the workflow action that failed, along with details of the error.
|
Pre-Event Workflow Rule and Workflow Action Failures
The following table describes the outcome for errors that occur in pre-event workflow rules and the workflow actions on those rules.
Type of Error
|
Outcome
|
What is Reported in the Workflow Error Monitor
|
Syntax error in a workflow rule condition or a workflow action
|
- None of the actions on the workflow rule are performed.
- The failure is reported in the Workflow Error Monitor.
- None of the workflow rules configured for the same record type and trigger event are triggered.
- The operation that triggered the workflow rule is not affected by the failure of the rule.
|
Details of the workflow rule or the workflow action that contains the first syntax error that was encountered, along with details of the error.
|
Semantic error in a workflow rule condition
|
- None of the actions on the workflow rule are performed.
- The failure is reported in the Workflow Error Monitor.
- If the rule was triggered by a delete operation, then the record is deleted.
- If the rule was triggered by an update operation, then the updated record is saved, unless the Cancel Save check box is selected on the workflow rule.
If the Cancel Save check box is selected on the workflow rule, then the update operation that triggered the workflow rule is canceled in the same way that an update operation is canceled if the condition on the rule is not met. For details of what happens when an update operation is canceled by the workflow Cancel Save functionality, see Canceling Workflow Save Operations.
|
Details of the workflow rule on which the error was found, along with details of the error.
|
Semantic error in a workflow action
|
|
Not applicable
|
Any other error in a workflow action
|
- None of the remaining actions on the workflow rule are performed.
- The error is reported back to the user whose action triggered the workflow rule. If the workflow rule was triggered by a Web service, then the failure of the workflow action is reported in the response to the Web service.
- The operation that triggered the rule is blocked.
|
Not applicable
|
Scheduled Event and Workflow Action Failures
The following table describes the outcome for errors that occur in scheduled events and the workflow actions on those scheduled events for record types other than Analytics.
Type of Error
|
Outcome
|
What is Reported in the Workflow Error Monitor
|
Syntax error in a workflow action
|
- The workflow action fails for each record in the list.
- An instance is reported in the Workflow Error Monitor for each failure.
- If other actions exist on the scheduled event, then those actions are performed.
- The failure of the workflow action does not prevent the generation of a pending instance for the next scheduled occurrence of the event.
|
Details of the workflow action that contains the syntax error that was encountered, along with details of the error.
|
Semantic error in a workflow action
|
- The workflow action fails for each record in the list.
- An instance is reported in the Workflow Error Monitor for each failure.
- If other actions exist on the scheduled event, then those actions are performed.
- The failure of the workflow action does not prevent the generation of a pending instance for the next scheduled occurrence of the event.
|
Details of the workflow action on which the error was found, along with details of the error.
|
The number of records returned in the list specified on the scheduled event exceeds the maximum number allowed.
|
- None of the actions on the scheduled event are performed for any record in the list.
- The failure is reported in the Workflow Error Monitor. A single instance is reported.
- The failure does not prevent the generation of a pending instance for the next scheduled occurrence of the event.
|
Details of the scheduled event that failed, along with details of the error.
|
The user who made the scheduled event active does not have access to the list specified on the scheduled event.
|
- None of the actions on the scheduled event are performed for any record in the list.
- The failure is reported in the Workflow Error Monitor. A single instance is reported.
- The failure does not prevent the generation of a pending instance for the next scheduled occurrence of the event.
|
Details of the scheduled event that failed, along with details of the error.
|
Any other error in a workflow action
|
- The workflow action fails for each record in the list.
- An instance is reported in the Workflow Error Monitor for each failure.
- If other actions exist on the scheduled event, then those actions are performed.
- The failure of the workflow action does not prevent the generation of a pending instance for the next scheduled occurrence of the event.
|
Details of the workflow action that failed, along with details of the error.
|
NOTE: After an instance of a scheduled event fails, another instance is generated for the next scheduled occurrence of the event. You cannot resubmit a failed instance.
Scheduled Event and Workflow Action Failures for the Analytics Record Type
The following table describes the outcome for errors that can occur for scheduled events for the Analytics record type and the workflow actions on those scheduled events. In all of the cases listed in the table, the failure of a workflow action for one or more users does not prevent the generation of a pending instance for the next scheduled occurrence of the event.
Type of Error
|
Outcome
|
What is Reported in the Workflow Error Monitor
|
Syntax error in a workflow action
|
- For each user in the list of users on the scheduled event, the workflow action fails, and no email is sent to the user.
- An instance is reported in the Workflow Error Monitor for each failure.
- If other actions exist on the scheduled event, then those actions are performed.
|
Details of the workflow action that contains the syntax error that was encountered, along with details of the error.
|
Semantic error in a workflow action
|
- For each user in the list of users on the scheduled event, the workflow action fails, and no email is sent to the user.
- An instance is reported in the Workflow Error Monitor for each failure.
- If other actions exist on the scheduled event, then those actions are performed.
|
Details of the workflow action on which the error was found, along with details of the error.
|
One or more of the following issues arises at the time that Oracle CRM On Demand attempts to perform an action on behalf of a user:
- ETL (extract, transform, load) is running.
- The Analytics server is down.
- One or more of the report services allotments is exceeded, or the file allotment for your company is reached.
|
- The workflow action fails.
- None of the remaining actions on the event are performed for the user, and none of the actions are performed for any of the remaining users in the list.
- If any action on the event instance was successfully performed for a user before the issue arose, then the email with the results is sent to that user.
- An instance is reported in the Workflow Error Monitor for the failure.
|
Details of the workflow action that failed, along with details of the error.
|
One or more of the following issues is found when Oracle CRM On Demand attempts to perform an action on behalf of a user:
- The user's role does not have the Access V3 Analytics privilege.
- The user is inactive.
- Oracle CRM On Demand cannot sign in to the Analytics server on the user's behalf.
|
- None of the workflow actions on the event are performed for the user.
- The failure does not prevent the action from being performed for other users in the list of users on the scheduled event.
- An instance is reported in the Workflow Error Monitor for the failure.
|
Details of the workflow action that failed, along with details of the error.
|
One or more of the following issues is found when Oracle CRM On Demand attempts to perform a workflow action on behalf of a user:
|
- The workflow action fails for the user.
- If other actions exist on the scheduled event, then those actions are performed for the user.
- An instance is reported in the Workflow Error Monitor for the failure.
|
Details of the workflow action that failed, along with details of the error.
|
An analysis executed by a Send Email action on a scheduled event returns no results for a given user, and the Send Email if No Results check box on the Send Email action is deselected.
|
- No email is sent to the user.
- If other actions exist on the scheduled event, then those actions are performed for the user.
- If the analysis returns results for other users on the scheduled event, then the email and the results of the analysis are sent to those users.
- An instance is reported in the Workflow Error Monitor for the failure.
|
The name and folder path of the analysis and the name of the user for whom no results were returned.
|
|