Configuring Approvers and Workflows
•Configuring the Approval Sequence
•Configuring the Approval Criteria
•Configuring Approver Notifications
•Configuring Owner Notifications
•Configuring a Voting Deadline for an Approval Request
Approval Workflows
Knowledge management provides an approval workflow for each knowledge article type.
Article Type |
Workflow Name |
Business Object |
Document |
Document Knowledge Approval Workflow |
FRS_Knowledge.Document |
Error Message |
Error Message Approval Workflow |
FRS_Knowledge.ErrorMessage |
Issue and Resolution |
Issue Resolution Approval Workflow |
FRS_Knowledge.IssueResolution |
Patch |
Patch Knowledge Approval Workflow |
FRS_Knowledge.Patch |
Q&A |
Q and A Knowledge Approval Workflow |
FRS_Knowledge.QandA |
Reference |
Reference Knowledge Approval Workflow |
FRS_Knowledge.Reference |
Workflows mostly consist of the Get Approval and Notification workflow block. These define the approvers, the approval sequence and criteria, the notification recipients during the approval process, and the voting deadlines. These settings can be changed to customize the approval process as described in the following sections.
See Using Workflows for information on workflows.
Configuring Approvers
Approvers can be configured as groups or as an individual.
Groups
By default, approvers are configured using these contact groups:
•Knowledge Business Approval Group
•Knowledge Technical Approval Group
•Knowledge Presentation Approval Group
For example, if a knowledge article requires business approval, all members of the Knowledge Business Approval Group are notified when the article is ready for review by one or more group members. Reviewers can be specified by adding or removing users to or from this group.
You can also create a new approval group and then reconfigure an approval workflow to use the new group instead of a default group.
1.From the Configuration console, click Configure > Users and Permissions > Groups, to open the Contact Group workspace.
2.Click New Contact Group.
3.Fill in the contact group form.
4.Reconfigure one or more approval workflows to use the new contact group:
5.Access the approval workflow that you will reconfigure.
6.Double-click the Get Approval block that will use the new approval group. (Approval workflows typically have three Get Approval blocks; one each for technical, presentation, and business approval). The Get Approval properties window appears.
7.In the Approvers area, use the drop-down list in the From a Group field to select the new contact group.
8.Click Save followed by OK to save the new workflow version.
9.Return to the version list for this workflow and publish the new version.
Individuals
Approval workflows can be configured to specify one or more individual approvers rather than an approval group. In this case, approval is required from specified individuals.
You can use Get Approval workflow blocks to specify individual approvers rather than approval groups. However, only one individual approver can be specified in a Get Approval block. To specify multiple individual approvers, you must use multiple Get Approval blocks.
1.Access the approval workflow that will use individual reviewers.
2.Double-click the Get Approval block to reconfigure.
3.In the block properties dialog Approvers area, select From a User and use the drop-down lists in the group and user fields to select an individual approver.
4.Click Save followed by OK to save the new workflow version.
5.Return to the version list for this workflow and publish the new version.
Configuring the Approval Sequence
By default, the Get Approval blocks in all of the provided knowledge approval workflows are arranged in this sequence:
1.Technical approval
2.Presentation approval
3.Business approval
All three approval types are not always required for a knowledge article. The knowledge collection in the article is placed depending on the type of approval that is required.
Configuring the Approval Criteria
1.Open the knowledge workflow for the knowledge article type.
2.Double-click the Get Approval block to reconfigure.
3.In the Approval/Denial Criteria area of the Get Approval block properties window, select an approval method.
4.Click Save.
Approval criteria are controlled by the information in the Approval/Denial Criteria area of the Get Approval block properties window.
Configurable Criteria | Conditions for Approval/Rejection |
---|---|
Approve if all approved |
Every member of the approval group approves the request. |
Approve if any approved |
One member of the approval group must approve the request. |
Approve if at least N% approved |
The specified percentage of the approval group members approve the request. |
Deny if any rejected |
One member of the approval group rejects the request. |
Deny if at least N% rejected |
The specified percentage of approval group members rejects the request. |
Email Notifications
Email notification occurs at two general stages in a knowledge approval workflow:
•Approvers are notified when an article is ready for them to review.
•The owner of an article is notified about the article status after it is reviewed or after a review deadline expires.
Configuring Approver Notifications
The Send Notification for Knowledge quick action (affiliated with the FRS_ApprovalVoteTracking business object) sends email to approvers when an article is ready for them to review. By default, this notification is sent to $(OwnerEmail).
To reconfigure this quick action:
1.From the Configuration console, click Build > Automation Tools > Quick Actions to open the Actions Manager workspace.
2.Scroll to FRS_ApprovalVoteTracking and click Add/Edit.
3.Under Your Actions, double-click Send Notification for Knowledge and reconfigure it as necessary.
4.Click Save.
To specify that another quick action be used:
1.Log in to Neurons for ITSM as a Knowledge Manager.
2.Open the Knowledge workspace.
3.Open a knowledge record.
4.From the toolbar, click View Workflow, then click Open Definition. The Workflow Designer opens.
5.Double-click the Get Approval block to reconfigure it.
6.In the Approval Notification Quick Action area, use the drop-down list to select another quick action.
7.Click Save in the Workflow Designer.
Configuring Owner Notifications
1.Log in to Neurons for ITSM as a Knowledge Manager.
2.Open the Knowledge workspace.
3.Open a knowledge record.
4.From the toolbar, click View Workflow, and then click Show Definition. The Workflow Designer opens.
5.Double-click the Notification block to reconfigure it. The Notification properties window opens.
6.You can use the default template that appears, or modify it as needed.
7.Click Save and then OK to save the new workflow version.
8.Return to the version list for this workflow and publish the new version.
Notification blocks in the knowledge workflows are configured to send the following notifications to an article owner after an article is reviewed or if a review deadline expires.
Notification | Indicates ... |
---|---|
Failed Technical Review |
A failed technical review. |
Failed Presentation Review |
A failed presentation review. |
Failed Business Review |
A failed business review. |
Technical Review Deadline |
The deadline for technical review has expired and the article must be resubmitted for approval. |
Presentation Review Deadline |
The deadline for presentation review has expired and the article must be resubmitted for approval. |
Business Review Deadline |
The deadline for business review has expired and the article must be resubmitted for approval. |
Notification to Owner |
Article is approved. |
Configuring a Voting Deadline for an Approval Request
Voting deadlines for article approvers are configured through Get Approval workflow blocks. Deadlines can be based on a duration (in days, hours, and minutes) or on the date in a field that you specify.
1.Log in to Neurons for ITSM as a Knowledge Manager.
2.Open the Knowledge workspace.
3.Open a knowledge record.
4.From the toolbar, click View Workflow, and then click Show Definition. The Workflow Designer opens.
5.Double-click the Get Approval workflow block that is labeled as default, to reconfigure it. The Get Approval properties window opens.
6.In the Approval Voting Deadline area, do one of the following:
•Click Field and use the drop-down list to specify a field name.
•Click Duration and specify the duration length in the provided fields. (The duration clock starts when the Get Approval workflow block is triggered; the deadline is reached when the duration ends).
7.Click Save and then OK to save the new workflow version.
8.Return to the version list for this workflow and publish the new version.