Manual:Extension/Workflows/Activity/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	Description	Type
due_date	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.