Difference between revisions of "Manual:Extension/Workflows"

 
Line 45: Line 45:
 
[[File:Manual:bpmn-SingleUserApproval.svg|center|thumb|750x750px|BPMN diagram of a "Single user approval" workflow|alt=BPMN diagram of a "Single user approval" workflow]]
 
[[File:Manual:bpmn-SingleUserApproval.svg|center|thumb|750x750px|BPMN diagram of a "Single user approval" workflow|alt=BPMN diagram of a "Single user approval" workflow]]
 
{| class="wikitable" style="width:100%;"
 
{| class="wikitable" style="width:100%;"
!Activity
+
! style="width:200px;" |Activity
 
!Description
 
!Description
 
|-
 
|-
| CollectData
+
| style="width:200px;" | CollectData
 
|In the first workflow step, the workflow initiator enters the settings:
 
|In the first workflow step, the workflow initiator enters the settings:
  
Line 55: Line 55:
 
*''Send report to:'' An email report with the results will be sent to this email address when the review is finished. If a username is specified here, an email address must be stored in the user administration so that the report can be sent.
 
*''Send report to:'' An email report with the results will be sent to this email address when the review is finished. If a username is specified here, an email address must be stored in the user administration so that the report can be sent.
 
|-
 
|-
|PageCheckout
+
| style="width:200px;" |PageCheckout
 
|The page is locked for editing by other wiki users. Only the user  with the workflow task can edit while this workflow is running.
 
|The page is locked for editing by other wiki users. Only the user  with the workflow task can edit while this workflow is running.
 
|-
 
|-
|UserVote
+
| style="width:200px;" |UserVote
 
|The assigned user carries out a vote and either accepts the page or rejects it. Alternatively, the task can be delegated. In the event of a rejection, the workflow skips the next step (ApprovePage).
 
|The assigned user carries out a vote and either accepts the page or rejects it. Alternatively, the task can be delegated. In the event of a rejection, the workflow skips the next step (ApprovePage).
 
|-
 
|-
| ApprovePage
+
| style="width:200px;" | ApprovePage
 
|'''Only if''' the user has submitted a positive vote (accept), the page is set to an approved state.
 
|'''Only if''' the user has submitted a positive vote (accept), the page is set to an approved state.
 
|-
 
|-
|SendMail
+
| style="width:200px;" |SendMail
 
|An email report is sent to the report recipient who was specified in the first step.
 
|An email report is sent to the report recipient who was specified in the first step.
 
|-
 
|-
|PageCheckin
+
| style="width:200px;" |PageCheckin
 
|The page is unlocked.
 
|The page is unlocked.
 
|}
 
|}
Line 78: Line 78:
 
[[File:Manual:bpmn-ExpertDocControl.svg|center|thumb|550x550px|BPMN diagram of the "Expert document control" workflow|alt=BPMN diagram of the "Expert document control" workflow]]
 
[[File:Manual:bpmn-ExpertDocControl.svg|center|thumb|550x550px|BPMN diagram of the "Expert document control" workflow|alt=BPMN diagram of the "Expert document control" workflow]]
 
{| class="wikitable" style="width:100%;"
 
{| class="wikitable" style="width:100%;"
!Activity
+
! style="width:200px;" |Activity
 
! Description
 
! Description
|-
+
|- style="height:25px;"
|CollectData
+
| style="width:200px;" |CollectData
 
|In the first workflow step, the workflow initiator enters the settings:
 
|In the first workflow step, the workflow initiator enters the settings:
 
''User:'' User who is assigned to a task. Three different users have to be specified: '''Editor''', '''Reviewer''', '''Approver'''
 
''User:'' User who is assigned to a task. Three different users have to be specified: '''Editor''', '''Reviewer''', '''Approver'''
Line 89: Line 89:
 
''Send report to:'' An email report with the results will be sent to this email address when the review is finished. If a username is specified here, an email address must be stored in the user administration so that the report can be sent.
 
''Send report to:'' An email report with the results will be sent to this email address when the review is finished. If a username is specified here, an email address must be stored in the user administration so that the report can be sent.
 
|-
 
|-
| PageCheckout
+
| style="width:200px;" | PageCheckout
 
|The page is locked for users who do not participate in the workflow. Only the '''Editor''' (first workflow participant) and '''Reviewer''' (second participant)  of the workflow can edit the page during checkout.
 
|The page is locked for users who do not participate in the workflow. Only the '''Editor''' (first workflow participant) and '''Reviewer''' (second participant)  of the workflow can edit the page during checkout.
 
|-
 
|-
|EditPage
+
| style="width:200px;" |EditPage
 
|The '''Editor''' user can edit the page and completes the task without comment.
 
|The '''Editor''' user can edit the page and completes the task without comment.
 
|-
 
|-
|UserVote
+
| style="width:200px;" |UserVote
 
|After the '''Edito'''r step has been completed,the '''Reviewer''' user can edit the page and submit a vote. As an alternative, the '''Reviewer''' can delegate the task.  If the vote is positive (Approve), the workflow continues. If the '''Reviewer''' rejects, the workflow goes back to the '''Editor'''.
 
|After the '''Edito'''r step has been completed,the '''Reviewer''' user can edit the page and submit a vote. As an alternative, the '''Reviewer''' can delegate the task.  If the vote is positive (Approve), the workflow continues. If the '''Reviewer''' rejects, the workflow goes back to the '''Editor'''.
 
|-
 
|-
|PageCheckin
+
| style="width:200px;" |PageCheckin
 
|After the '''Reviewer''' submits a positive vote (accept), the page is checked in and the workflow continues.
 
|After the '''Reviewer''' submits a positive vote (accept), the page is checked in and the workflow continues.
 
|-
 
|-
|PageCheckout
+
| style="width:200px;" |PageCheckout
 
|In this step, the page checkout locks the page for editing completely. The '''Approver''' user will not be able to change the page, but needs to approve it.
 
|In this step, the page checkout locks the page for editing completely. The '''Approver''' user will not be able to change the page, but needs to approve it.
 
|-
 
|-
|ApprovePage
+
| style="width:200px;" |ApprovePage
 
|The Approver can either complete or delegate the task. After the '''Approver''' (or the delegate) finishes the assigned task, the page is set from "draft" to "approved" status if the page was in draft status (only if the approver submits a positive vote). If not, this step is skipped.
 
|The Approver can either complete or delegate the task. After the '''Approver''' (or the delegate) finishes the assigned task, the page is set from "draft" to "approved" status if the page was in draft status (only if the approver submits a positive vote). If not, this step is skipped.
 
|-
 
|-
|SendMail
+
| style="width:200px;" |SendMail
 
|If an email or user was specified in the workflow settings, the report is now getting sent to that user.
 
|If an email or user was specified in the workflow settings, the report is now getting sent to that user.
 
|-
 
|-
|PageCheckin
+
| style="width:200px;" |PageCheckin
 
|The page gets unlocked for editing.
 
|The page gets unlocked for editing.
 
|}
 
|}
Line 121: Line 121:
 
[[File:Manual:bpmn-GroupFeedback..svg|center|thumb|450x450px|BPMN diagram of the "Group feedback" workflow|alt=BPMN diagram of the "Group feedback" workflow]]
 
[[File:Manual:bpmn-GroupFeedback..svg|center|thumb|450x450px|BPMN diagram of the "Group feedback" workflow|alt=BPMN diagram of the "Group feedback" workflow]]
 
{| class="wikitable" style="width:100%;"
 
{| class="wikitable" style="width:100%;"
!Activity
+
! style="width:200px;" |Activity
 
!Description
 
!Description
 
|-
 
|-
| CollectData
+
| style="width:200px;" | CollectData
 
| In the first workflow step, the workflow initiator enters the settings:
 
| In the first workflow step, the workflow initiator enters the settings:
  
Line 131: Line 131:
 
* S''end report to:'' An email report with the results will be sent to this email address when the review is finished. If a username is specified here, an email address must be stored in the user administration so that the report can be sent.
 
* S''end report to:'' An email report with the results will be sent to this email address when the review is finished. If a username is specified here, an email address must be stored in the user administration so that the report can be sent.
 
|-
 
|-
|GroupFeedback
+
| style="width:200px;" |GroupFeedback
 
|All users in the assigned group provide feedback via a comment field. This is a parallel workflow, which means that the order of the feedback does not matter.
 
|All users in the assigned group provide feedback via a comment field. This is a parallel workflow, which means that the order of the feedback does not matter.
 
|-
 
|-
|SendMail
+
| style="width:200px;" |SendMail
 
|If an email or user was specified in the workflow settings, the report is now getting sent to that user.
 
|If an email or user was specified in the workflow settings, the report is now getting sent to that user.
 
|}
 
|}
Line 145: Line 145:
 
[[File:Manual:bpmn-UserFeedback.svg|center|thumb|500x500px|BPMN diagram of the "Single user feedback" workflow|alt=BPMN diagram of the "Single user feedback" workflow]]
 
[[File:Manual:bpmn-UserFeedback.svg|center|thumb|500x500px|BPMN diagram of the "Single user feedback" workflow|alt=BPMN diagram of the "Single user feedback" workflow]]
 
{| class="wikitable" style="width:100%;"
 
{| class="wikitable" style="width:100%;"
!Activity
+
! style="width:200px;" |Activity
 
!Description
 
!Description
 
|-
 
|-
|CollectData
+
| style="width:200px;" |CollectData
 
|In the first workflow step, the workflow initiator enters the settings:
 
|In the first workflow step, the workflow initiator enters the settings:
  
Line 155: Line 155:
 
* Send report to: An email report with the results will be sent to this email address when the review is finished. If a username is specified here, an email address must be stored in the user administration so that the report can be sent.
 
* Send report to: An email report with the results will be sent to this email address when the review is finished. If a username is specified here, an email address must be stored in the user administration so that the report can be sent.
 
|-
 
|-
| UserFeedback
+
| style="width:200px;" | UserFeedback
 
|The assigned user sends a comment.
 
|The assigned user sends a comment.
 
|-
 
|-
|SendMail
+
| style="width:200px;" |SendMail
 
|If an email or user was specified in the workflow settings, the report is now getting sent to that user.
 
|If an email or user was specified in the workflow settings, the report is now getting sent to that user.
 
|}
 
|}

Latest revision as of 13:11, 27 April 2022

Introduction

In BlueSpice 4.1, workflows are based on BPMN 2.0. Four different types of page-based workflows are already integrated. Their purpose is a page review to obtain feedback via a user vote or to trigger a page approval. In the following, these workflows are therefore called review workflows.

Types of reviews
Workflow type Participants Description
Single user approval 1 user A single user is asked to vote about a page. If a user submits a positive vote, the page is automatically approved.
Expert document control 3 users After a page has been edited by a specific user, the page is reviewed by an expert and then approved by a user who is responsible for approvals.
Group feedback 1 group A group (which needs to exist in the group manager) is requested to leave a comment on a page.
Single user feedback 1 user A user is asked to send a comment regarding a page.

Notifications and reports

  • When a task gets assigned: When a user needs to complete a workflow task, both a notification and a task are created.
  • At the end of a worfklow: After a workflow has ended, the initiator receives a notification and an email is sent to a report recipient (as defined at the beginning of the workflow).
  • When a workflow gets aborted:
    • A notifications are sent to users with a pending workflow task
    • A notifications are sent to the originator if a workflow got aborted
    • Participants of past or future steps don't receive a notification

Workflow activities

All approval workflows start with a form where the necessary workflow data is entered by the workflow initiator. Each workflow results in one or more workflow activities.

Single user approval

Purpose: Approval of a draft page by a user with approval rights. This workflow only makes sense if the approval function (FlaggedRevs) is activated on a page.

Workflow instances: Only one approval workflow can run per page.

BPMN diagram of a "Single user approval" workflow
BPMN diagram of a "Single user approval" workflow
Activity Description
CollectData In the first workflow step, the workflow initiator enters the settings:
  • User: ser who is assigned to the task.
  • Instructions: A comment or instructions for the user to understand the task.
  • Send report to: An email report with the results will be sent to this email address when the review is finished. If a username is specified here, an email address must be stored in the user administration so that the report can be sent.
PageCheckout The page is locked for editing by other wiki users. Only the user with the workflow task can edit while this workflow is running.
UserVote The assigned user carries out a vote and either accepts the page or rejects it. Alternatively, the task can be delegated. In the event of a rejection, the workflow skips the next step (ApprovePage).
ApprovePage Only if the user has submitted a positive vote (accept), the page is set to an approved state.
SendMail An email report is sent to the report recipient who was specified in the first step.
PageCheckin The page is unlocked.

Expert document control

Purpose: Approval of a draft page according to the "4-eyes principle".

Workflow instances: A page can only have one approval worfklow at a time.

BPMN diagram of the "Expert document control" workflow
BPMN diagram of the "Expert document control" workflow
Activity Description
CollectData In the first workflow step, the workflow initiator enters the settings:

User: User who is assigned to a task. Three different users have to be specified: Editor, Reviewer, Approver

Instructions: A comment or instructions for the users to understand their tasks.

Send report to: An email report with the results will be sent to this email address when the review is finished. If a username is specified here, an email address must be stored in the user administration so that the report can be sent.

PageCheckout The page is locked for users who do not participate in the workflow. Only the Editor (first workflow participant) and Reviewer (second participant) of the workflow can edit the page during checkout.
EditPage The Editor user can edit the page and completes the task without comment.
UserVote After the Editor step has been completed,the Reviewer user can edit the page and submit a vote. As an alternative, the Reviewer can delegate the task. If the vote is positive (Approve), the workflow continues. If the Reviewer rejects, the workflow goes back to the Editor.
PageCheckin After the Reviewer submits a positive vote (accept), the page is checked in and the workflow continues.
PageCheckout In this step, the page checkout locks the page for editing completely. The Approver user will not be able to change the page, but needs to approve it.
ApprovePage The Approver can either complete or delegate the task. After the Approver (or the delegate) finishes the assigned task, the page is set from "draft" to "approved" status if the page was in draft status (only if the approver submits a positive vote). If not, this step is skipped.
SendMail If an email or user was specified in the workflow settings, the report is now getting sent to that user.
PageCheckin The page gets unlocked for editing.

Group feedback

Purpose: Obtaining feedback from the members of a user group. The group must exist in the group manager.

Workflow instances: Several feedback workflows can run independently of one another on one page at the same time.

BPMN diagram of the "Group feedback" workflow
BPMN diagram of the "Group feedback" workflow
Activity Description
CollectData In the first workflow step, the workflow initiator enters the settings:
  • Group: User group who is assigned to the task.
  • Instructions: A comment or instructions for the users to understand their task.
  • Send report to: An email report with the results will be sent to this email address when the review is finished. If a username is specified here, an email address must be stored in the user administration so that the report can be sent.
GroupFeedback All users in the assigned group provide feedback via a comment field. This is a parallel workflow, which means that the order of the feedback does not matter.
SendMail If an email or user was specified in the workflow settings, the report is now getting sent to that user.

Feedback

Purpose: Obtaining feedback from a single user on a page.

Workflow instances: Multiple feedback worfklows can run independently of one another on one page at the same time.

BPMN diagram of the "Single user feedback" workflow
BPMN diagram of the "Single user feedback" workflow
Activity Description
CollectData In the first workflow step, the workflow initiator enters the settings:
  • User: User who is assigned to the task.
  • Instructions: A comment or instructions for the users to understand their task.
  • Send report to: An email report with the results will be sent to this email address when the review is finished. If a username is specified here, an email address must be stored in the user administration so that the report can be sent.
UserFeedback The assigned user sends a comment.
SendMail If an email or user was specified in the workflow settings, the report is now getting sent to that user.

Overview page

All workflows in the wiki are listed on the page Special:Workflows overview. A view for all active workflows and a view for all workflows can be selected.

Workflows overview page
Workflows overview page

Tasks overview

Users are informed about new and pending tasks in their notifications. They can view assigned workflows on their My tasks page.

How to add a custom workflow

Users can upload an xml-file of a BPMN diagram with custom activities to the wiki. Currently, the following predefined activities exist:

Extension: Workflows


Extension: PageCheckout


Extension: BlueSpiceFlaggedRevsConnector

Example of a customized workflow (coming soon)

No categories assignedEdit

Discussions

Attachments