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:

Id	Name	Type	Default	Required	Readable	Writable
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	Source expression	Target
  voterUserExpression		voterUserExpression
  	${false}	addComments
  	${"Approve/Reject"}	voteButtonLabel

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]