Troubleshoot Workflow Instances

When a workflow instance fails, an error message is generated on the Workflow Instance page. You are notified through several different channels that link to the Workflow Instance page.

Error Messages

Error messages that appear on the Cloudsnap Workflow Instance page often come from other vendors, not Cloudsnap, which means the same error may be described differently from application to application.

Important: You must know your data and applications thoroughly to resolve an error. The error can occur in the data, with the trigger or target application or within the Cloudsnap platform. You must know your data and applications thoroughly to resolve an error. 

Error messages for each instance are listed under Attempts on the Workflow Log’s Instances page.

1. Workflow: Name
2. Details: Successful, Unsuccessful, running, or waiting
3. Errors that occurred during an attempt to run the workflow:
   • Error Type, category of the error: Function Error, API Error, etc.
   • Step Name where the error occurred
   • App Name where the error originated
   • Message

Use a combination of the error message and responses in the workflow steps on the Workflow Instance page to begin your investigation of the workflow failure and fix.

Notifications

When a workflow instance fails, you are notified all the following ways:

• Via email, if the email notification has been set up. If not set up yet, Set Up Notification Emails.
• Workflow Daily Digest, a single date snapshot.
• Workflow Logs in the Cloudsnap platform, a running list of instances for all workflows.

Links in these notifications lead to the Workflow Instance page. 

Types of Errors

 The following failed transactions are errors that Cloudsnap customers may encounter and repair.

• User Error, which generally involve invoice payment, and vendor codes. Transactions fail when data is missing or incorrect or it is invalid because the value does not meet the requirements in an API’s requirements. The most frequent errors are incorrect, or invalid, data on invoices, POs, and vendor codes.
• Intermittent Errors, which occur within the API, not the data in the source or destination application. These errors are corrected when the workflow instance is restarted automatically or manually.
• Cloudsnap Agent Errors, which usually require Cloudsnap involvement. These errors can be a lost connection or an out-of-date version of the agent.

Also see:

• Error Handling in Workflows
• Troubleshoot Cloudsnap Agent