Introduction

The Finish Instruction makes an order leave a workflow or branch of the JS7 - Fork-Join Instruction. The order is considered to be completed and will assume a successful or unsuccessful outcome

...

in the JS7 - Order History, for details about order states see JS7 - Order State Transitions.

• By default finished orders leave their the workflow or branch with an unchanged outcome.
  • If a Finish Instruction is used in the Catch block of a JS7 - Try-Catch Instruction then by default the outcome will be unsuccessful as previously an error occurred.
  • Other occurrences of the the Finish Instruction, for example in a JS7 - If Instruction, by default will result in a successful outcome.
• Users can specify a successful outcome to be forced for any occurrence of the Finish Instruction.
• Users can specify an unsuccessful outcome to be assigned to an order to make such orders appear in the JS7 - Order Order History with a failed history status.For details see JS7 - Order State Transitions.

Workflow Instruction: Finish

Download Workflow Example (.json upload): pdwFinish.json

Finish Instruction with unchanged Outcome

Image Added

Explanation:

• The workflow makes use of a Try/Catch Instruction. If job1 in the Try block fails then the order will assume an unsuccessful outcome.
• The Catch block will catch the error and will cause the order's outcome to be successful.
• The Finish Instruction will make the order leave the workflow without modifying its outcome. Therefore the final outcome will be successful (unchanged).

Finish Instruction with successful Outcome

Image RemovedImage Added

Explanation:

• The workflow makes use of an If Instruction to check a previous job's return valuesvalue. See See JS7 - If Instruction for details of how to add expressions to If Instructions.
• If the If Instruction evaluates to true then the left-hand branch with the Finish Instruction is executed that is configured to force a successful outcome.
• The order can optionally be assigned a message, for example, specifying the reason for finishing the order.

...

• If the If Instruction evaluates to false then the right-hand branch with the Finish Instruction is executed.
• The checkbox radio-button for Unsuccessful outcome is selected.
• The order can optionally be assigned a message, for example, specifying the reason for finishing the order.

• Display feature availability
  StartingFromRelease 2.5.0

...