Call Subprocess

Use

You can call a subprocess from an integration process or another subprocess. You can use subprocesses to make frequently-used functionality available in different processes.

At runtime, the calling process waits for the subprocess to be processed. Only then does the system resume the processing of the calling process.

Prerequisites

You have defined the required subprocess.

More information: Defining a Subprocess

Features

Exceptions in Subprocesses

A subprocess can trigger exceptions. These exceptions can only be handled within the subprocess. An exception that is triggered in the subprocess is not visible in the caller process.

If an exception for which no exception handler has been defined is triggered in the subprocess, the subprocess and all processes in the call hierarchy are given the status Error.

You can define how you want system errors to be handled when the call is executed. If a system error occurs, the sub process cannot be called because an error has occurred in deployment, for example.

Canceling a Subprocess

Subprocesses cancelled by a control step are not visible in the caller process. The caller process continues to wait for the subprocess to be executed and is not given a specific error status.

Using Configurable Parameters to Call the Subprocess

To be able to call a subprocess, a calling process must know the integration process component of the subprocess it is calling. However, this is something that is not known at definition time, but only at configuration time. Therefore, to specify the relevant subprocess without this information, you use a configurable parameter. You can assign the relevant integration process component to the configurable parameter at configuration time.

Activities

  1. Insert the Call Subprocess step type at the required position in the calling integration process.
  2. Open the Configurable Parameters view in the object area in the lower right corner of the process editor, and define a configurable parameter for the subprocess call.
    1. Enter a name for the configurable parameter.
    2. Select Subprocess as the category.
    3. Select the required subprocess as the type.
  3. In the properties area of the step, select the configurable parameter you defined as the value for the Subprocess property.
  4. If formal parameters are defined in the subprocess, assign the relevant container elements to them.