Overview of knowledge articles
By creating knowledge articles, you help create a knowledge base of easy-to-find solutions and give users self-service search options to help them resolve issues on their own.
As a Knowledge Author, you must have minimum permissions to access Remedy with Smart IT, as explained in Smart IT roles and permissions.
Click the following link to watch a short video on creating a knowledge article. The screens of the following video refer to the earlier versions of Smart IT, but the functionality is applicable for the latest version of Smart IT.
Knowledge article lifecycle in traditional knowledge management
The following diagram illustrates the process of creating and publishing knowledge articles:
Smart IT helps you manage knowledge through the following stages:
Draft a solution
A knowledge author identifies the need for new knowledge and creates an article. The knowledge author uses a template to start creating a knowledge article. Knowledge articles can include rich media, such as images and video, but this video cannot be viewed in Remedy IT Service Management suite The following video (5:01) shows how to create a knowledge article in Smart IT.
When the author completes the draft, the article's content might be visible to some users with Knowledge user roles. However, the content has not been reviewed and approved for use. This content might change, or the entire article might be deleted.
Review and promote
A Subject Matter Expert (SME) reviews the article for content. If the article needs additional work, the SME flags the article and indicates what update is needed.
The article can be promoted through multiple stages of review: content, proofreading, and final review. At each stage, the article can be approved, rejected, or placed on hold by a reviewer or by a user with Knowledge Admin permission.
Publish to knowledge base
When the article is approved, it is published and becomes available to all users, even those without Knowledge user roles. For example, when agents use Smart Recorder to log a ticket, the system automatically displays relevant knowledge articles. Business users can see knowledge articles in BMC Digital Workplace and BMC Chatbot.
In some cases, the content might be confidential so the article might be marked as not available to users without a Knowledge user role.
Review and retire
After articles are published, knowledge users periodically review the articles to ensure that the articles are still accurate and relevant. Users can provide feedback on knowledge articles. A knowledge user might review the article in response to feedback. If your organization uses KCS, KCS Coaches use Article Quality Index (AQI) assessment questions to assess their team's articles. An administrator can create AQI question sets to meet your organization's needs.
Enhanced editing experience
The Smart IT knowledge editor has the look and feel of commonly used documentation editors and allows you to format article content just as easily. You can maximize your view by clicking the maximize button to hide the side panes displayed and extent the editor to be displayed across the browser window. The editor automatically resizes itself if you resize your browser window avoiding display of multiple scroll bars. Sections on the article remain expanded, you cannot collapse them. You must note that due to security concerns the spell checker has been removed from the editor.
You can embed images (jpeg, gif, bmp jpg, png, bmp, tga, tif, tiff) and reference video links (embed tags) within articles. However, you cannot copy an image and text together from a Word or PDF file. To embed videos in articles, you can copy video URL from YouTube and Vimeo, and paste it in the Paste Video URL text box. You can also specify the width and height of the video. Else, if you have the embed code of the video, you can type or paste the embed code or an iframe code in the Paste Embed Code Here text box. Note that the code must not contain script tag to avoid XSS.
Activity feed of a knowledge article
Click the Activity tab of a knowledge article to view all updates made to the article.
In the Add a note text box, you can enter comments, attach files, and address a person by using the "at" symbol (@) sign followed by the person's name. To use this capability, the user must have access to the knowledge article.
If you follow an article or if you are the assignee of an article, the activity feed for that article is displayed in the Updates feed.
You can view select activity types by setting filters. On the Activity tab, click theicon. All activity filters are displayed.
Pre-defined BMC Knowledge Management templates
All existing BMC Knowledge Management templates are available in Smart IT, with the exception of the Decision Tree template. The following out of the box templates are provided:
- Known Error
- Problem Solution
- How to
- KCS Template
In Smart IT, users without KCS permissions are able to access and create knowledge articles using the KCS Template. However, through BMC Remedy IT Service Management they will not be able to view those articles and the KCS Template.
Once you select the template, you can create the content of the knowledge article, add metadata for the article and save the content.
Access to related and similar information
As you create the article, Smart IT provides a list of similar knowledge articles, allowing you view, and merge content from these similar articles to your one you are creating. You can also choose to directly edit an article from the list displayed. Retired articles will not be listed under suggested knowledge articles while creating a knowledge article. You can search for Retired articles only through the global search or advanced search using the Search for knowledge resources option.
You have the option to change the template in use when creating the knowledge article, if required. This will change the layout of the content and allow you to make changes to the content. You can also merge the already created content to the new format selected. Once saved, you can update the article, and create a new version or just update the existing version if its a minor update. As a Knowledge Author, you can view all saved versions of the article.
Creating a knowledge article on an iOS or Android OS phone is just as easy, with all options available on the device.
Articles created by using decision tree template
In BMC Remedy Knowledge Management, you can create and edit decision tree knowledge articles. In Smart IT, you can only access and view decision tree articles. They follow the same lifecycle and behavior as knowledge articles created by using other templates. You must have at least knowledge viewer permission to access the articles, which you can identify by theicon. Decision tree articles have the following important capabilities:
- Refer articles to resolve tickets
- Relate articles to tickets
- Flag and unflag articles
- Change article status
- Follow articles
- Add articles to your favorite list
- Review articles
- (Only Universal Client (UC)) Edit metadata and add attachments
- (Only UC) Share article link through email with external customers and internal team members
Decision tree articles have the following limitations:
- You cannot create or edit articles.
- You cannot share articles as PDF attachments when you send email from incident tickets. Even if a decision tree article is related (pinned) to incidents, it is not available for attachment.
- You cannot print articles.
- Decision tree articles can be created only in BMC Remedy Knowledge Management, and you must have knowledge user permission to create articles. By default, KCS users are not permitted to create articles in BMC Remedy Knowledge Management. They can only view knowledge articles in Smart IT. Considering these limitations, if your organization follows KCS principles for knowledge management, and wants to use decision tree articles, it is recommended that you give Knowledge permissions to one of the service desk agents to create and maintain decision tree articles in BMC Remedy Knowledge Management.
Navigation in decision tree articles
You can use options given in the following table to navigate through decision tree articles.
|Navigate through article||Select the Back and Forward buttons||Tap the Next and Previous options|
|Go back to the beginning of the article||Select the Reset All button||Tap the Start Over option|
|View article nodes and selected branches that led you to the latest selected answer||Select or tap the Show All option|
- When you copy content from various sources and paste it in the article, fonts that are copied get applied to the article content. In such cases, you might see article content in multiple fonts, and the color of the text might differ from the original color.
- BMC Digital Workplace does not support decision tree knowledge articles.
For more information on creating articles by using a decision tree template, seeCreating a decision tree.
Metadata information for articles
All required metadata information related to a knowledge article is now accessible on a single pane. The pane displayed when creating the knowledge article allows users to define necessary information and settings for the knowledge article. Article metadata allows you to define the visibility of the article, assign it, define the company to which the article is to be associated with and other properties from the same pane.
|Visibility||This option provides quick options for accessing articles from a single option instead of multiple places. It controls visibility of Knowledge article based on visibility groups.|
|Publish to External Audiences|
This option controls the accessibility and visibility of knowledge articles to the external users of Smart IT such as BMC Service Request Management and BMC My IT users. By default, the option is set to No. When a knowledge article is still not ready to be shared with external users, the option must be set to No. When the article is reviewed and finalized, you can change the selection to Yes. Internal users of Smart IT such as service desk agents can always view articles irrespective of the option set to Yes or No.
You can share articles through email with both the internal and external users. Both types of users must have permission to the appropriate Visibility Groups to view the articles.
|Assign to me|
When you create or edit a knowledge article, you can quickly assign it to yourself by using the Assign to me link. In the CTM:People form, users are associated with the support groups. The Assign to me link is based on the association between users and the support groups of which they are part.
On the Update Assignment pane, when you click the Delete option to clear your name from the search box, the Assign to me check box is automatically cleared, and the search result displays the result as per the search criteria that you specified. If you have not specified the search criteria, you can search for a specific person.
Now, if you click Change, in the Update Assignment panel, the options of Support Company, Support Organization and Support Group appear based on your selected primary company:
|Site||You can select a site from the list. After you select a site, if its corresponding company is primary, then that site is automatically marked as primary. If you have added multiple sites from the primary company, click on a site to make it primary.|
|Organization / Department||You can select an organization and department from the list. After you make a selection, if its corresponding company is primary, then that organization and department are automatically marked as primary. If you have added multiple organizations and departments from the primary company, click one to make it primary.|
|Business Service||You can select a business service from the list. After you select a service, if its corresponding company is primary, then that service is automatically marked as primary. If you have added multiple business services from the primary company, click on a business service to make it primary.|
|Operational Category and Product Category|
Start typing in these fields to view matching categories. After you select one or more categories, if its corresponding company is primary, then that category is automatically marked as primary. If you have added multiple categories from the primary company, click on a category to make it primary.
On iOS devices, the Add Attachment option, and on Android devices, the From files and Dropbox options enables you to attach files that are on cloud storage when you create or edit change requests, and when you add a comment.The administrator can configure the attachment criteria, and the supported file extensions in Remedy ITSM, in the Attachment Security tab of the Server Information form.
The following limitations apply for Smart IT:
- Following Knowledge Base Items are not supported:
- Source type File System Path
- Source type AR Form with no support for life cycle management
- Users can access only Attachment and Character fields, for custom templates created in BMC Knowledge Management.
- Service Pack 2 for BMC Knowledge Management version 8.1 provided configuration options to enable editing options for a Knowledge Submitter when the article is in Draft stage. This configuration setting is not available in Smart IT.
- Status transitions listed for a Knowledge article do not take into consideration any categorization settings defined for the article.
- Cognitive recommendations for Knowledge will work only for articles created with specific companies, not for all companies.
- In Smart IT, you can add work note in the Knowledge Articles that are in In Progress status.
While editing the title, keywords, metadata, company, site, organization, business service, product category, and setting visibility to all, if you save the article, you may get the following error message, but the article still displays the edited values:
entry does not exist in database