Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 8 Next »

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.

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 StartSoftlinksFromProcessVariablesHandler.

Screenshot 2024-08-13 211606.png

Let us set the softlink Actionhandler details

Screenshot 2024-06-03 222113.png

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

Screenshot 2024-06-03 223417.png

Specify the variable names, and click the 'Start Process Instance' button to initiate the process.

Screenshot 2024-08-13 211838.png

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.

Screenshot 2024-06-03 224819.png

Choose the option for the desired sheet(ex.PDF)

Screenshot 2024-06-03 225005.png

Process Variables displayed in the Downloaded PDF, that are created by the Form fields

Screenshot 2024-08-13 212131.png

Choose the task within the process and finalize it by selecting the 'Save and Complete' button.

Screenshot 2024-06-03 225855.png

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”

Screenshot 2024-06-04 150301.png

The process variable is set in each starting instance by softlink as you can see in the screenshot below.

Screenshot 2024-08-13 212408.png

Use case 2: Using StartSoftlinksFromXLSVariablesHandler for setting process variables and Starting softlinks via StartSoftlinksFromProcessVariablesHandler.

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:

Screenshot 2024-06-05 111807.png

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 StartSoftlinksFromProcessVariablesHandler:

Screenshot 2024-06-05 091907.png

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.

Screenshot 2024-06-05 101714.png

If our example is published, you can start a new process instance.

Screenshot 2024-06-05 091025.png

Upload the Excel file from above.

Screenshot 2024-08-14 132512.png

After adding the file, the instance is ready to be started. The tasks associated with the instance must be completed as well.

Screenshot 2024-08-14 132354.png

After completing the 'Testing Case' task, the two softlink instances are automatically started by the Actionhandler as defined in the Excel file.

Screenshot 2024-06-05 103759.png

These are the process variables displayed in the report of the main process instance:

Screenshot 2024-08-14 132045.png

Process Variables displayed in the report of the first softlink process instance

needs to be changed

  • No labels