Creating the Subprocess Call Step

To create a step for starting one or several nested subprocesses with specific parameters, open the subprocess step wizard.

After the basic step properties have been determined, click the Next button on the first page of the wizard.

Step Description

The next wizard page is Step Description:

Determine the following for the Subprocess Call step on the Step Description page:

• Subprocess. The box is mandatory. Select the start subprocess in the drop-down list, when selecting you can use search. The list contains repository objects tree where processes and folders containing them are only displayed.

To edit the selected subprocess, click the button. The Set Up Business Process dialog box opens to edit a subprocess.

If the required subprocess is absent in the list, click the Create Process button. A new process creation dialog box opens.

• Subprocess Version. Creation date and time of subprocess version is displayed.

After the parameters have been determined on the Step Description page, click the Next button.

Managing Parameters

The next wizard page is Manage Parameters:

Determine the following for the Subprocess Call step on the Manage Parameters page:

• Group Call. Select the Group Call checkbox to start several subprocesses and set parameters from the Splitting Parameter and Splitting Schema drop-down lists.

The Group Call checkbox is selected by default with unselected splitting parameter value that is required to be filled. If during process execution there is not necessity to divide a subprocess by a parameter, deselect the checkbox.

• Splitting Parameter. The splitting parameter can be selected only when the Group Call checkbox is selected. Subprocess parameters are used as splitting parameter. Select dictionary which elements will be used to start subprocesses. For each dictionary element selected on process start, single subprocess instance will be started.

To filter subprocess start by splitting parameter attributes or by its values, set up subprocesses call conditions using the Filter button.

• Splitting Schema. The splitting schema can be selected only when the Group Call checkbox is selected.Select a step splitting method to subprocesses. Subprocesses are split by main process parameter elements specified in the Correspondence Between Process and Subprocess Parameters area. starting, the subprocesses will be started depending on the splitting schema selection:

• Source. Subprocesses are started for each selected dictionary element. Subprocesses are not started for dictionary children elements.

• Child Elements. NOTE. If selected dictionary elements has no children elements, then on executing subprocess, the step will finish without subprocesses start.

  Example of splitting schema use

  The example of Source and Child Elements splitting schema use:

  • Fore Method. Subprocesses are started by elements obtained after Fore method execution. For Fore method determine assembly and method.

  Determine assembly and method

  

  Determine for the Fore method:

  • Assembly. In the hierarchical list select the unit that will determine the selection.

  To edit the selected assembly, click the button.

  To create a unit, click the button.

  • Method. The method is automatically determined according to signature:

  Sub <Fore method name>(Sender: IBProcessInstance; Args: IBProcessStepParamValueEventArgs);

  Parameter:

  Sender. Process instance.

  Args. Event information: step, parameter value.

  To refresh the methods list, click the button.

  To copy method signature, click the button.

  • Execution Method. Select the Manual or Automatic radio button:

  • Manual. The step is started manually.

  • Automatic. The step is started automatically after the previous step was executed.

  By default, automatic execution is selected for the step. The steps of the process with automatic execution method are marked with the sign at the top right corner of the block.

  It is possible to change execution option after step setup. To do this, select the step in the workspace on business process setup and select the Automatic Step Execution context menu item

  • Rejection. Select the First Step or Last Step radio button:

  • First Step. After rejecting the current step for the Subprocess Call finished step the subprocesses are restarted from the first step.

  Example of restarting subprocess from the first step

  The example of rejecting the Call Subprocess finished step and restarting subprocesses from the first step:

  • Last Step. After rejecting the current step for the Subprocess Call finished step the subprocesses are restarted from the last step.

  Example of restarting subprocess from the last step

  The example of rejecting the Call Subprocess step and restarting subprocesses from the last step:

  NOTE. To restart single instances of subprocess with automatic execution method on rejecting the current step for the Subprocess Call finished step select the Selective rejection of Subprocesses checkbox and manually start required subprocess instances.

  • Correspondence Between Subprocess and Process Parameters. Determine:

  • Fixed. To limit the list of parameters values used for embedded process start, select the Fixed checkbox.

  • Subprocess Parameter. The list of subprocesses parameters is filled in automatically.

  NOTE. If for subprocess parameter which is a splitting parameter the empty value was fixed, then on the process execution the step finishes without subprocesses start.

  • Process Parameter. In the Process Parameter drop-down list select parameter or parameter attribute of the main process.If the Group Call checkbox is selected, select a dictionary corresponding to subprocess parameter in the drop-down list. The dictionaries selected as a process and subprocess must have identical structure. If one dictionary is a division parameter by several process parameters, add it several times in the Process Settings and Parameters dialog box for each parameter.

  If the drop-down list of process parameters does not contain the required value, click the Process Parameters button. The Process Settings and Parameters dialog box opens, in which a process parameter can be added.

  After the parameters have been determined on the Manage Parameters page, click the Next button.

  Events

  The next wizard page is Events:

  

  Set up automatically executed actions launched on step execution start or end.

  On generating a list of executed actions, select a tab with event first:

  • Before Execution. The list of actions will be started before executing the current step in the specified order.

  • After Execution. The list of actions will be started after executing the current step in the specified order.

  • On Rejection. The list of actions will be started on the current step rejection. The list is available for steps with manual execution. If the step is executed automatically, the tab is not displayed.

  • On Failures. The list of actions will be started on failure to execute the current step in the specified order. To execute the actions:

  • When the server execution of processes is selected, select the Check Steps Execution Failures checkbox on the Scheduler page of the Parameters Setup and Business Process Management dialog box and set check frequency.

  • When the client execution of processes is selected, select the Check Failures item on the Administration page of the Parameters Setup and Business Process Management dialog box.

  To add an event, click the button on the ribbon. The number of added actions is unlimited.

  Actions to be added:

  • . Execute Fore method. In the right part of the window select:

  • Unit. In the drop-down list select a unit written in the Fore language, the list contains all repository units and folders containing units. Search by unit name is available.

  To edit the selected unit, click the button.

  To create a unit, click the button.

  • Method. In the drop-down list select a method. The list contains all unit methods corresponding to the signature:

  Sub <Fore-method name>(Sender: IBProcessInstance; Args: IBProcessStepStateEventArgs);

  Parameter:

  Sender. Process instance.

  Args. Event information: step, step old state, new state.

  To refresh the methods list, click the button.

  To copy method signature, click the button.

  • . Send Email. In the right part of the window select:

  • To; Copy; Bcc. The recipient email is entered manually, using option of copy/paste from clipboard.

  • Subject. The email subject is entered manually, using option of copy/paste from clipboard.

  • Contents. The contents is entered manually using the option of variables values substitution with step parameters, links to step objects to view in the web application, file attachment.

  To change order of operations execution, use the / buttons on the toolbar, to delete use the button.

  The list of automatically executed actions can be empty.

  Click the Finish button to exit the wizard.

  After creating the process steps, set up process steps execution conditions.