Voting Sub-Process instructions

The Voting Sub-Process is not a standalone workflow and you use it as part of a parent workflow. The configuration of this packaged workflow is different from the rest because you define how the sub-process works through the parent workflow.

Voting Sub-Process start form variables

The following process variables are available for the Voting Sub-Process:








decisionInfo Decision Info string   true    
voterUserExpression The user expression resulting to users required to vote string   true    
votePercentage The percentage of voters that are needed to approve (%) long 50 true    
voteWarningTimeDuration Time duration before a warning mail is send to vote string B3D true    
voteTimeoutDuration Time duration before the voting is stopped and the process continued string B5D true    
addComments Add voting comments to resource boolean false true    
addCommentsToParent Provide the id if you want comments to be added to a parent comment string        
earlyComplete Stop voting if votingPercentage is impossible to reach boolean false true    
voteButtonLabel Label for the voting button string   true    
voteTaskName The name of the actual voting task string   true    
sendActionEmail Send a mail to the users allowing completing the vote by sending a email boolean false      
resultTemplate Email template for sending voting result string result      
reminderTemplate Email template for sending voting reminder string reminder      
names Email Template Names string resultTemplate,reminderTemplate true false  
defaults Defaults string result,reminder true false  

Most of the process variables are required but not readable. You must provide a value for all required variables when calling the Voting Sub-Process from the parent workflow because the workflow cannot use the defaults, except for names and defaults, which you can configure on the workflow definition page in Collibra Data Governance Center.

Call the Voting Sub-Process workflow

To use the Voting Sub-Process, edit the parent workflow with the Flowable BPMN 2.0 Designer and add a CallActivity to your diagram where you would like the voting to happen. Edit the Main config section of the call activity to set the values of the required process variables:

  • In the Called element field, use the process ID of the Voting Sub-Process.

    The packaged process ID of the Voting Sub-Process is votingSubProcess.

  • Create nine new Input parameters that have each one of the required process variables as Target.
  • Provide a value for the variables:
    • Use parent workflow variables in the Source field.
    • Use expressions in the Source expression field.

      Expressions are always written as ${ }.


    Source expression


    voterUserExpression voterUserExpression

You can call the Voting Sub-Process multiple times in the same parent workflow.

Although the Voting Sub-Process is restricted to assets, you can use it in a parent workflow that has other or no restrictions. Voters can only add comments when the parent workflow refers to a community, domain or asset, but the voting can work without comments even as part of a global workflow.

Voting Sub-Process results

The main output of the Voting Sub-Process is the boolean process variable, votingSuccess. In the Main config section of the call activity, add a new Output parameter, where the Source is votingSuccess and the Target is a process variable of the parent workflow. You can then use the value of that variable to route the parent workflow based on the outcome of the voting.

You can map any additional process variables of the Voting Sub-Process to an output variable such as:

  • votingResult: a list of arrays containing the names the approval statuses and the comments of the participants.

    [[name:John, approved:true, comment:Approved by Data Steward], [name:Mary, approved:false, comment:]]

  • voters: a list of the names of all the voters.

    [John, Mary, Anita]