Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introduction

The JS7 - Try / Catch Instruction is Fail Instruction can be used for the error handling in a workflow. If any job runs in the try block and failed due to any reason the catch block will execute otherwise it will skip the catch block. If the catch block will also fail then the order will be considered as failed. The folder 04_ErrorHandling contains the example for the try-catch. The four workflows are available with the different use cases for the try-catch:

The jdFail workflow will execute and fail due to the fail operation is used in the workflow. Even if all the jobs will execute successfully and the fail object is used at the end of the workflow the order will fail and complete the workflow.

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

...

Based on a condition that is checked with an If Instruction, an order is put to the failed state by use of the Fail Instruction. Users can resume the execution of a failed order or can cancel the order.

Workflow

The 04_ErrorHandling folder contains an example of error handling with the Fail Instruction.

The jdFail workflow deliberately fails due to the Fail 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 has failed. 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 04_ErrorHandling folder and expand the jdFail workflow.

    Image Added


  2. To add an order to the workflow click

...

  1. the action menu of the workflow and

...

  1. use Add

...

  1. Order 

...

  1. from the drop-down menu.

...


  1. Image Added


  2. When clicking Add Order

...

  1.  a popup window will appear.

...

  1. You can add

...

  1. an Order ID or leave the Order

...

  1. ID value

...

  1. empty, it will

...

  1. then use a default Order

...

  1. ID. Click

...

  1. the Submit button

...

  1. .

    Image Added

  2. To check the status of the

...

  1. order click

...

  1. the

...

  1. name of the workflow. This will make the Order History panel appear.

    Image Added

  2. From the Order

...

  1. History panel

...

  1. you can

...

  1. verify that the order has failed. Click

...

  1. the Order ID to

...

  1. see log output created by jobs executed for this order.

    Image Added

  2. A log view window will open and the order log will be displayed.

...

  1. This log contains

...

  1. output to stdout/stderr from all jobs executed by the order.

...

  1. You can download the log file by clicking the Download button

...

  1. in the upper right-hand corner of the log view window. Also, you can expand and collapse the individual job output using the

...

  1. chevron icons in the upper left-hand corner of the log view window.

    Image Added