GroupVote

Description

The activity GroupVote is responsible for collecting necessary data about the voting of a group on a special topic. Unlike the UserVote, it is not possbile to delegate the task. A user that is part of a group can accept or decline a vote and also leave a comment that justifies their decision. The voting result is determined by whatever threshold has been reached first and ends the activity.

Short profile
Name	GroupVote
Async	No
BPMN type	`bpmn:userTask`
BPMN Extension Element "wf:type"	`group_vote`

Extension elements

Name of extension element	Description	Type
`threshold`	Multiple thresholds can be defined	element
`threshold/type`	Arbitraty identifier, to be used in the connected gateway	string
`threshold/value`	Either absolute or relative number of users. Depends on `unit`.	int
`threshold/unit`	Either `user` or `percent`.	string

Example

<bpmn:extensionElements>
   <wf:type>group_vote</wf:type>
   <wf:threshold>
   		<wf:type>yes</wf:type>
<wf:value>3</wf:value>
<wf:unit>user</wf:unit>
    </wf:threshold>
    <wf:threshold>
   		<wf:type>no</wf:type>
<wf:value>10</wf:value>
<wf:unit>percent</wf:unit>
    </wf:threshold>
</bpmn:extensionElements>

<bpmn:outgoing>FromGroupVoteToGatewayGroupVote</bpmn:outgoing>

Once one of the thresholds is reached, the activity will be completed and a <bpmn:exclusiveGateway> (referenced by <bpmn:outgoing>) will be called. It will choose its outgoing <bpmn:sequenceFlow> by mapping its name to the "type" of the threshold that has been reached.

<bpmn:exclusiveGateway id="GatewayGroupVote">
  <bpmn:incoming>FromGroupVoteToGatewayGroupVote</bpmn:incoming>
  <bpmn:outgoing>FromGatewayUserVoteToApproveRevision</bpmn:outgoing>
  <bpmn:outgoing>FromGatewayUserVoteToSendMail</bpmn:outgoing>
</bpmn:exclusiveGateway>
<bpmn:sequenceFlow
    name="yes"
    id="FromGatewayGroupVoteToApproveRevision"
    sourceRef="GatewayGroupVote" 
    targetRef="ApproveRevision"
/>
<bpmn:sequenceFlow
    name="no"
    id="FromGatewayGroupVoteToSendMail"
    sourceRef="GatewayGroupVote"
    targetRef="SendMail"
/>

Properties

Name of property	Source	Description	Type
`due_date`	`UIActivity`	Due date for task completion	date/timestamp
`assigned_group`	-	Name of the user group that should vote; can be plain grouname as used in the DB (e.g. "sysop")	string
`instructions`	-	Text that is shown to the group of user, so they know what to vote about	string
`users_voted`	-	Not to be set in the workflow definition. Used to store data during the activities life cycle. E.g. [ { "userName": "UserA", "vote": "yes", "comment": "Good" }, { "userName": "UserB", "vote": "no", "comment": "Not good" } ] Can be accessed by follow up activitites by e.g. `{{<GroupVoteActivityID>.0.userName}}`	string

To submit feedback about this documentation, visit our community forum.