Error Handling for Asynchronous Workflow Tasks

When you create an asynchronous workflow task and an error occurs while processing, NetSuite sends the error details to the to the workflow owner in an email. An error can be a user error or an internal SuiteFlow error. You can use the information in the email message to troubleshoot the workflow.

NetSuite sends an email message for errors that occur with the Asynchronous workflow execution task when initiated using task.WorkflowTriggerTask in SuiteScript 2.x.

The following errors can happen when workflow tasks are processed asynchronously:

• Errors during workflow execution. For instance, a workflow creates a new record using the Create Record action, however the action doesn’t specify values for all required fields. The Create Record action consequently fails.

• Skipped record errors. These errors happen when two asynchronous tasks run at the same time and try to process the same record. In such cases, NetSuite prevents records from being processed by two or more asynchronous workflow tasks in parallel. When this happens, some records may get skipped. For instance, if one task starts processing the record and the second task attempts to as well, the second task must wait until the first finishes. The second task only waits for a limited time, so it might not get to process the record before time runs out.

• Infrastructure shutdown. During maintenance, asynchronous tasks might be stopped. The tasks would finish processing the current record, but would be unable to process any more records until the next scheduled workflow execution. Any records that can’t be processed during downtime are reported as skipped.

In the case of any of the listed errors, NetSuite sends an email to the workflow owner to notify of the errors occurrence.

General Notices