Introduction
Softlinks provide a flexible way to integrate additional processes within a main process without the need for strict sequential execution. They offer a dynamic approach to process modeling, allowing for greater adaptability and scalability.
Softlinks are established through a process variable contained within the softlink, referencing the main process's ID. This dynamic linking enables runtime determination of process relationships.
Softlinks can be created using either custom JavaScript functions or built-in ActionHandlers, offering flexibility in implementation based on specific requirements and expertise.
To facilitate the evaluation and monitoring of softlinks within a process, a corresponding Actionhandler can be used or JavaScript code must be implemented. This code enables graphical representation and analysis of softlink interactions within the form of the main process, enhancing visibility and understanding of process dynamics.
Use case 1: Starting softlinks via StartSoftlinkFromProcessVariableHandler
First, let’s prepare the form process variables to be processed by softlinks.
Inside the Form, set the variables in the form as below:
softlink_nr[0]
softlink_nr[1]
softlink_nr[2]
This means, that when we start the process, the process variables to be created by Form are named in a sequence ‘softlink_nr[0]’, ‘softlink_nr[1]’, ‘softlink_nr[2]’. This is achieved by using the
Let us set the softlink Actionhandler details
Parameter | Description |
|---|---|
Softlink process name | Specifies the name of the process which should be started by a softlink. In this case it will start the process named: NewProcessFromSoftlink |
Include process variables by suffix | Specifies a suffix that will determine which process variables of the main process are to be included in the softlink started instances. |
Amount to start | Specifies the amount of instances that are to be started by softlinks. |
Softlink suffix | Specifies which variables are to be assigned to the individual softlinks. So, the three instances that will be started will take into consideration process variables ending with “_nr” and these will be set as process variables in each started instance via softlink. |
Softlink process instance starting
Specify the variable names, and click the 'Start Process Instance' button to initiate the process.
After initiating the process instance, you can download the instance report by navigating to the 'Properties' tab and clicking on the 'Reports' button to see which process variables are created.
Choose the option for the desired sheet(ex.PDF)
Process Variables displayed in the Downloaded PDF, that are created by the Form fields
Choose the task within the process and finalize it by selecting the 'Save and Complete' button.
After completing the task, the list now successfully displays the three softlink process instances (Workflow NewProcessFromSoftlink) that have been started by the ActionHandler (those matching _nr as provided in the actionhandler Softlink suffix) and created as much as it is set in “Amount to start”
The process variable is set in each starting instance by softlink as you can see in the screenshot below.
Use case 2: Using StartSoftlinksFromXLSVariablesHandler for setting process variables and Starting softlinks via
In this example, we will set process variables via an Excel file, and those matching the softlink suffix will be used to start new instances. Here you can see the configuration of the CreateSoftlinkVariablesFromXLSX Handler:
Parameter | Description |
|---|---|
Event name | Specifies the name of the event, which in this case it to create variables. |
docName | Specifies the name of the document of XLS softlink. |
softLinkSuffix | Specifies which variables are to be assigned to the individual softlinks. |
softLinkCount | Specifies the row count for the softlinks. |
The following screenshot shows the configuration of the
Parameter | Description |
|---|---|
Softlink process name | Specifies the name of the process which should be started by a softlink. |
Include process variables by suffix | Specifies a suffix that will determine which process variables of the main process are to be included in the softlink started instances. |
Amount to start | Specifies the amount of instances that are to be started by softlinks. |
Softlink suffix | Specifies which variables are to be assigned to the individual softlinks (in this case is email). |
The Excel file that contains data to be set as process variables in the process instance is as follows.
If our example is published, you can start a new process instance.
Upload the Excel file from above.
After adding the file, the instance is ready to be started. The tasks associated with the instance must be completed as well.
After completing the 'Testing Case' task, the two softlink instances are automatically started by the Actionhandler as defined in the Excel file.
These are the process variables displayed in the report of the main process instance:
Process Variables displayed in the report of the first softlink process instance
