Modeling Business Processes and Their Execution > Getting Started with the Business Process Management Extension in the Desktop Application > Building Process > Setting Up Process Parameters > Setting Up Events

Setting Up Events

Process events during specific step execution can be set up on the Events page in the Process Settings and Parameters dialog box.

Set up automatically executed operations started when one of the events occurs: starting process, stopping process steps execution, restarting process steps, finishing process execution:

To create a list of executed operations, select the corresponding tab with the event: Start, Stop, Restart, End, then click the Add button on the toolbar and select the added operation:

Execute Fore Method. Fill in mandatory boxes highlighted in rose at the right pat of the window:

Unit. The box is mandatory. Select Fore unit in the drop-down list. The list contains all units in the repository and folders containing units. Search by unit name is available.
Method. The box is mandatory. Select a method in the drop-down list. 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.

Send Email. Set message parameters:

To. Enter address of one or several main recipients separated by the ; character. The box is mandatory.
Copy. Enter address of one or several recipients separated by the ; character.
BCC. Enter address of one or several recipients separated by the ; character. The address will be hidden from other message recipients.
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 attachments:

@(STEPROLEBACK). Previous step role. Type: string.
@(STEPNAMEBACK). Previous step name. Type: string.
@(STEPROLENEXT). Next step role. Type: string.
@(STEPNAMENEXT). Next step name. Type: string.
@(STEPNAME). Step name. Type: string.
@(PROCESSNAME). Process name. Type: string.
@(PROCESSCUSTOMER). Process manager. Type: string.
@(PROCESSSTARTTIME). Process start time. Type: date and time.
@(STEPDEADLINE). Step execution deadline. Type: date and time.
@(EVENTUSER). The user who executed the event. Type: string.
@(EVENTCOMMENT). Event comment. Type: string.
@(STEPBACKFINISHUSER). The user who executed previous manual step. Type: string.
@(STEPBACKFINISHCOMMENT). Comment for previous manual step execution. Type: string.
@(STEPDECLINEUSER). The user who rejected manual step. Type: string.
@(STEPDECLINECOMMENT). Comment for manual step rejection. Type: string.

NOTE. The number of added actions is unlimited.

To reorder operations execution, use the Move Up and Move Down buttons on the toolbar. To delete operations, click the Delete button.

After executing the operations, the list of operations started in the specified order when the particular event occurs is created. The list of automatically executed actions can be empty.