Reviewing a knowledge article in Smart IT as a primary and alternate approver
This topic is based on the desktop web (universal client) platform. For Android and iOS users, the display might vary slightly. However, the procedure to review a knowledge article remains the same.
Smart IT retrieves the approval setup from BMC Remedy AR System Approval Central and applies it to the approval requests in Smart IT. In the knowledge article lifecycle, every article undergoes the review process for technical and content validation. When the reviews are complete, the article is promoted to the Publish Approval status. Only the primary or alternate approver can approve or reject an article, or put it on hold. Based on the permissions that have been set, an approver can approve articles of a specific company or all companies. An approver might also have to act on the articles with cancel approval and retire approval status. Such articles are handled in a similar manner as articles with publish approval status. An article can be assigned to more than one approver for review.
A knowledge approver in Smart IT must have permission to view the knowledge article. Otherwise, the article can be approved by using Approval Central or email-based approvals. For more information, see "Smart IT Permissions" and "Managing knowledge article approval requests" in Related topics.
An approver who is unavailable to review an article can assign one or more alternate approvers through the People form in BMC Remedy IT Service Management (BMC Remedy ITSM). For more information, see the Related topics section.
Authenticating knowledge article reviewer
In BMC Remedy IT Service Management on the Basic tab of the AP:ProcessDefinition form, if the system administrator has set Require Password? to Yes for authenticating the reviewer when reviewing knowledge articles that are moved to the following processes:
To reflect this update, you can either wait for a maximum 30 minutes, or you can manually clear the Smart IT cache. For more details, see Clearing the Smart IT cache.
Based on whether BMC Remedy Single Sign-On is integrated or not, you must do one of the following to authenticate yourself as the reviewer by using your Smart IT login credentials and submit your review:
- If BMC Remedy Single Sign-On is integrated with Smart IT, the system redirects you to the BMC Remedy Single Sign-On authentication page. You must login using your Smart IT login credentials.
- If BMC Remedy Single Sign-On is not integrated with Smart IT, you must enter your Smart IT password to authenticate yourself.
Smart IT supports only BMC Remedy Single Sign-On version 9.1 and later. You must uncomment the xml section in web.xml if BMC Remedy Single Sign-On version is 9.1 and later.
If you have already integrated Smart IT with BMC Remedy Single Sign-On, and you want to authenticate knowledge article approvers by using BMC Remedy Single Sign-On, your system administrator must uncomment the BMC Remedy Single Sign-On Web Agent filter and filter mapping elements. To do so, the system administrator must follow these steps:
- Stop SmartIT/MyIT Tomcat service.
- Edit the web.xml file in Smart_IT_MyIT/ux/WEB-INF.
(Windows) C:\Program Files\BMC Software\Smart_IT_MyIT\Smart_IT_MyIT\ux\WEB-INF
Uncomment the BMC Remedy Single Sign-On Web Agent <filter> and <filter-mapping> elements (by deleting <!-- and -->):Uncomment
<!-- Remedy SSO webagent filter. Uncomment when needed --> <!-- <filter> <filter-name>RSSOFilter</filter-name> <filter-class>com.bmc.rsso.agent.RSSOFilter</filter-class> </filter> <filter-mapping> <filter-name>RSSOFilter</filter-name> <url-pattern>/rest/sso/validate-reauth</url-pattern> </filter-mapping> -->
- Restart SmartIT/MyIT Tomcat service.
Scenario for reviewing a knowledge article
Consider a scenario in which Allen Allbrook is an approver at Calbro Services. Allen is a universal client user. He is a primary approver and is responsible for reviewing articles in publish approval status. Mary Mann is also a primary approver, with the same responsibilities as Allen. Mary is going on vacation for two weeks. Before her vacation starts, she assigns Allen as her alternate approver during her absence. To do so, she accesses the People form through the BMC Remedy ITSM application, and sets Allen as her alternate approver.
As a primary and alternate approver, Allen follows these steps to review articles:
- On the Console menu, he clicks Knowledge Console.
- In the Knowledge Console, he clicks Filter to search for articles assigned to him.
- From the list of search criteria, he selects To be approved by, and then selects the Me check box.
He then selects Status from the list, and selects the Publish Approval check box to search and display articles that require his approval.
Articles with cancel approval status can be reviewed only through the BMC Remedy ITSM application.
From the search result, he clicks an article.
The article is displayed with a banner containing options to approve it, reject it, or keep it on hold, and an option to view approver details.
- Click the Refresh icon to refresh the knowledge article.
Based on his review, he clicks the appropriate button.
- If BMC Remedy Single Sign-On is not integrated with Smart IT, Allen performs the following steps:
- To authenticate himself, Allen enters his Smart IT login password in the Login password field.
- In the rationale field, he provides a reason for his review.
- He submits his review.
If BMC Remedy Single Sign-On is integrated with Smart IT, Allen performs the following steps:
- In the rationale field, he provides a reason for his review.
- He submits his review. He is directed to BMC Remedy Single Sign-On login page.
- Allen enters his Smart IT login credentials to authenticate himself.
After authenticating the approver, the system accepts the review. Depending on the reviewer's action, the following three things can happen to an article in the publish approval state:
- If the article is approved, it is published.
- If the article is rejected, it is moved to the draft status. It will go through the lifecycle again for possible improvements.
- If the article is kept on hold, it remains in the publish approval state.
An article is visible to all available primary or alternate approvers. In BMC Remedy ITSM, if the BMC Knowledge Management approver level is set to ALL for publish, retire, or cancel, all approvers must approve the article in order to publish/retire/cancel it. If any reviewer rejects it, it is moved to its previous state; for example, from the retire approval state to the published state.
When the BMC Knowledge Management approver level is set to ONE for publish, retire, or cancel, then if anyone approver approves it, it is published. But if the first approver rejects it, the article is moved to the draft state.
Allen can view the approval list for the names of other approvers and the review they have provided for the article. To do so, he clicks Show approvers. The Open tab displays details of only the primary approver who has not reviewed the article, or has kept it on hold. The system also indicates mandatory and optional reviewers. The Closed tab displays details of the primary and alternate approvers who have approved or rejected the article.
The type of information displayed in the approval list remains same irrespective of whether the approver is a primary approver or an alternate approver. The Open tab remains empty when there are no pending reviews. The Closed tab remains empty when the article has not been reviewed.
|Open tab||Closed tab|
Adding alternate approver information (BMC Remedy IT Service Management documentation)
Managing knowledge article approval requests (BMC Knowledge Management documentation)