Introduction

The JS7 - Try / Catch Instruction can be used for error handling in a workflow. If any job within a Try Instruction block fails then the jobs available from the Catch Instruction block will be executed. If no error occurs in the Try Instruction block then the jobs in the Catch Instruction block are skipped. If a job in a Catch Instruction block also fails then the order will be considered being failed. Nested try/catch blocks can be used for more complex error handling.

Workflow

The folder 04_ErrorHandling contains an example for error handling the try/catch blocks.

The jdFail workflow deliberately fails due to the JS7 - Fail Instruction that is used in the workflow. When the order is in a failed state then a user can resume execution of the order or can cancel the order.

To execute the workflow in the folder 04_ErrorHandling please follow the below steps:

1. Click the folder 04_ErrorHandling and expand the jdFail workflow.
   
   
   
   
   
2. To add an order to the workflow click the action menu of the workflow and use Add Order from the drop-down menu.
   
   
   
   
   
3. When clicking Add Order a popup window will appear.
4. You can add an Order ID or leave the Order ID value empty, it will then use a default Order ID. Click the Submit button.
   
   
   
   
5. To check the status of the order click the name of the workflow. This will make the Order History panel appear.
   
   
   
   
6. From the Order History panel you can verify that the order is failed. Click the Order ID to see log output created by jobs executed for this order.
   
   
   
   
7. A log view window will open and the order log will be displayed. This log contains output to stdout/stderr from all jobs executed by the order.
8. You can download the log file by clicking the Download button from the upper right corner of the log view window. Also, you can expand and collapse the individual job output using the chevron icons from the left upper corner of the log view window.