The type and aspect of the control element depends on the document and place where the business process was launched. An additional option in the actions menu of the business process may be an example of such a control element.
An example of use of the action: change in the progress of a business process in the structure Listening for Parallel Event depending on the command chosen by the user.
The command may also be used separately, but in this case the user must be notified, for example through the User notification function wherein the user has to execute this command.
Action Parameters
The event can be sent by – permits limiting a circle of users for whom this command is available.
Action Results
The results of this action can be obtained using the form Insert value - Additional results where they will be available immediately after adding the action to the template.
The following is available:
- User who sent the command.
A Short Example of Using the Action
In this example, having performed the action block, the business process will stop and wait for the user to decide which branch the events will follow.
The conditions are checked from left to right. If a condition is met, the actions located in the branch below will be executed. If a condition is not met, the condition located to the right will be checked, and so forth until one of the conditions is met.
Condition Type – PHP Code
The code is indicated as a condition.
If the indicated PHP code returns the value
true, the branch of actions below such a condition will be executed; if false is returned, the next condition will be checked.
Attention! Only a PHP code can be used for this type of condition. The parameters of the type
{=Variable:Variable2_printable} are not supported.The code executed in the condition must also result in a logical expression (
true or false).Condition Type – Document Field
This action branch of the condition will be executed if the parameters related to the document fields coincide.
Condition Type – Variable Value
This action branch of the condition will be executed if the parameters related to business process variables coincide.
This action branch will be executed immediately. This condition is always met.
In order to choose the action branch, this structure must use the actions Wait for Event or Pause Execution first.
In other words, the action that occurs earlier in any branch will result in the execution of the chain below such an action.
This action Pause Execution permits you to resume a business process in a certain time in case no command is executed. Otherwise, the business process will just stop and wait for execution of any command inside the structure.
In other words, the cycle works so far as the condition is valid (true), otherwise (false) the loop is terminated.
Condition Type – PHP Code
Code is indicated as a condition.
If the indicated PHP code returns the value true, the loop will continue operating; if false is returned, the loop will be terminated.
Condition Type – Document Field
The loop will continue operating so long as the parameters related to the document fields coincide.
Condition Type – Variable Value
The loop will continue operating so far as parameters related to variables of the business process coincide.
Condition Type – TRUE