Introduction

The JS7 - Finish Instruction can be used for error handling in a workflow. Based on a condition that is checked with an If Instruction an order is put to the finished state by use of the Finish Instruction. By default finished orders automatically leave a workflow.

Workflow

The 04_ErrorHandling folder contains an example for error handling with the Finish Instruction.

The jdFinish workflow prematurely completes due to the Finish Instruction that is used in the workflow. The If Instruction used in this workflow includes the expression $return_value_job1 > 0 that implements a check of an order variable. If the value of the order variable evaluates to true then the order is finished. Otherwise the order continues with the job nodes following the If Instruction.

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

1. Click the folder 04_ErrorHandling and expand jdFinish 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 successful and has finished. 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-hand corner of the log view window. Also, you can expand and collapse the individual job output using the chevron icons in the upper left-hand corner of the log view window.