Vote Step
Vote Step
The principle of the step is to conduct a survey to gather group opinions before deciding on a workflow step. The survey is initiated by the user creating definitions. It requires selecting a group of users, adding predefined answers, and a moderator who will make the final decision. Members of the group choose one or more predefined answers.
Once the survey is complete, the system aggregates and displays the results, allowing the moderator to manually approve or reject the workflow.
This approach promotes collaborative decision-making while preserving the moderator's ultimate authority.
When the Vote Step is placed within a definition with multiple steps, the outcome of the Vote Step determines what happens next in the overall approval process.
Moderator rejects from Vote Step:
This rejection will immediately finalize (end) the approval process, no matter how many steps were originally in the workflow. In other words, once a rejection occurs, the process stops right there, and the approval path is considered rejected.Moderator approves or chooses another outcome from Vote Step:
The approval path does not end. Instead, the process will move on to the next step in the defined sequence of the approval definition.
Poll types
Single choice - Voters can select only one option from the predefined list.
Multiple choice - Voters can select more than one option from the predefined list.
Voting group / Moderator
Voting group - Responsible for casting their votes. (Predefined Jira groups)
Moderator - Responsible for reviewing the voting results and finalizing the vote step by either approving or rejecting it.
If all members of the voting group cast their votes or if the voting period expires, the moderator is notified and prompted to finalize the step.
Voting options
Voting options are predefined choices that users in the voting group can select. These options are customizable. Additionally, you can include an optional description for each option, which will appear as a tooltip next to the option name for users to view.
Voting expiration
The Vote Step allows you to optionally define an expiration date for the voting process. Once the expiry date is reached:
Voting is automatically disabled.
The moderator is notified; the step requires that person’s decision.
Work item watchers notification
The Vote Step includes a feature to manage notifications sent to work item watchers during the approval process. It grants the user the ability to prevent unnecessary notifications, enhancing overall communication efficiency.
Anonymize results for JSM customers
When enabled, voters' identities and vote timestamps will be hidden from the JSM customer view.
Only aggregated vote counts per option will be displayed.
Create a step condition
To include a Vote Step based on a predefined condition in a Jira Expression, use the Step Condition feature. When the condition is met, the step becomes part of the approval workflow.
If the condition is not fulfilled or an error occurs, the step is excluded from the process. For more details, refer to Conditions in Approval Path.
Label condition
The Label condition determines whether this approval step is included in the approval path based on the labels assigned to the work item.
When configured, this step will only be added to the approval path if the defined label criteria are met. You can specify that:
The work item must include one or more specific label(s), AND/OR
The work item must not include one or more specific label(s)
If the work item satisfies the configured label condition, the approval step is automatically introduced into the approval path. If the condition is not met, the step is skipped.
Voting Group Display
There is an option to expand the group step to display users, with the default view showing a compact version. When you hover over the person icon, a tooltip saying Click to view members appears, allowing you to check the group members. Additionally, clicking Show all entries expands the approval view, displaying the total votes and indicating who has voted.