GOTOSTEP

Usage

TIBCO iProcess Workspace (Browser)

TIBCO iProcess Workspace (Windows)

Warning: (iProcess only) This expression is not available to the TIBCO iProcess Script Server Plug-in. Therefore, even though you can successfully enter the expression in your iProcess Script plug-in definition, it will not be processed by the iProcess Engine and returns a -110 error.

On release of the current step, you can jump to another step. You can either process the current step or not.

Syntax

GOTOSTEP (step, extra, flags)

where:

• step (text) is the step name to go to.
• extra (text) is currently ignored but may be used to modify the behavior of this function in the future.
• flags (numeric) is the following numeric value:

Value

Behavior

0

The specified step is processed and the current step’s actions are processed.

1

The specified step is processed but the current step’s actions are NOT processed.
Note: The GOTOSTEP expression is only valid in the context of an open work item. If the work item is not released at the end of the current session, the GOTOSTEP will be ignored. This means that if the expression is executed and the work item is kept, and then re-opened and released, the GOTOSTEP will have no effect.

Returns

One of the following numeric values:

Value

Description

1

Success

-101

Invalid or unknown step name

-102

Invalid or unknown case number

-104

Step is not a valid type

-108

Unknown error from server

-110

Function not supported in this context

Examples

TIBCO iProcess Modeler:

1. This example processes the step called Gotostep on release of the current step in the procedure. The actions of the current step are not actioned: 
GOTOSTEP (“gotostep”,“”,1)
2. This example processes the step called Gotostep on release of the current step in the procedure. The actions of the current step are actioned: 
GOTOSTEP (“gotostep”,“”,0)

TIBCO Business Studio

  1. Equivalent of iProcess Example 1:

    IPEProcessUtil.GOTOSTEP("gotostep", "", 1);

  2. Equivalent of iProcess Example 2:

    IPEProcessUtil.GOTOSTEP("gotostep", "", 0);