ServiceNow Knowledge Management
ServiceNow Knowledge Management
ServiceNow Knowledge Management
ServiceNow
PDF generated using the open source mwlib toolkit. See http://code.pediapress.com/ for more information.
PDF generated at: Sat, 01 Mar 2014 09:38:12 PST
Description
Create New
Opens the Knowledge form where you can create a new article. The article number is provided. Enter the content for the article.
Users with the admin role can set the article workflow state and assign roles if access is to be limited.
Published
Lists the articles whose workflow state is Published. These articles are accessible from the knowledge portal and search. Review or
update published articles, as needed.
Edit
Lists all knowledge articles, regardless of their workflow state. Review or update the articles, as needed.
Retired
Lists articles whose workflow state is Retired. These articles are not accessible from the knowledge portal or search. Review the
articles to determine whether any should be updated and republished, retained for historical reference, or deleted.
Feedback
Lists knowledge feedback records. Use the Work notes field on the Knowledge Feedback form to document any changes made as
a result of the feedback.
View
Displays the knowledge portal. Search and view articles or click and drag a topic header to temporarily change the arrangement of
topics in the portal.
Knowledge Management
2
Submissions
Assigned to
me
Lists all knowledge submissions assigned to the logged in user who has the admin, knowledge_admin, or knowledge role. Review
the submission to determine whether to create an article and submit it for approval or to reject the submission and note the reason.
Submissions are created only when the knowledge submission workflow is enabled.
Open
Submissions
Lists all knowledge submissions with Status set to Submitted or Assigned. Review the record to determine whether to assign the
submission to a knowledge worker, create an article and submit it for approval, or reject the submission and note the reason.
Submissions are created only when the [Knowledge Workflow#Enabling Knowledge Submission Workflowknowledge submission
workflow is enabled.
To list submissions that have been closed, create a filter by clicking the arrow beside the breadcrumbs..
KCS
Flagged
Articles
Lists articles that have been flagged as incomplete or inaccurate by users. Open the record to read the user's comment in the
Knowledge Feedback related list and to modify the article as needed.
This module is available only to users with admin or knowledge_admin role.
Ratings
Lists ratings from users. Click the Created date to open the rating record. Click the article number to open the article.
This module is available only to users with admin or knowledge_admin role.
Search Log
Lists records of knowledge searches showing the search term and the number of results returned. Use this information to determine
whether users are finding what they need in the knowledge base.
This module is available only to users with admin or knowledge_admin role.
Overview
Opens the Knowledge Management homepage. Use the links at the top of the page to add content to the page or change its layout.
This module is available only to users with admin or knowledge_admin role.
Administration
Navigation
Add-ons
Lets you add links on the knowledge portal to different search engines or related websites.
Properties
Lets you customize the text that appears in various knowledge base locations, such as button labels, category names, and feedback
options.
This module is available only to users with admin role.
Using Knowledge
All users of the ServiceNow application can access the knowledge portal to search, where they can search for and
view knowledge articles and provide feedback to help improve the knowledge base. For more information, see Using
the Knowledge Base and Searching Knowledge..
Creating Knowledge
You can provide knowledge content:
Knowledge Management
Administrators can enable the knowledge submission workflow to have new knowledge articles created as
submissions that are moderated by knowledge workers before they are published.
Translating Knowledge
Organizations with knowledge users who speak multiple languages can activate the optional knowledge
internationalization features. For more information, see Knowledge Internationalization.
Accessing Knowledge
View role-appropriate knowledge articles from these locations.
Knowledge portal: every ServiceNow user can access the knowledge portal through one of these paths:
Self-Service > Knowledge, Service Desk > Knowledge, or Knowledge Base > View. The portal lists the most
recent articles arranged by topic.
Knowledge base list: users who click a topic's View all items link on the knowledge portal see a list of all
articles in that topic that have not passed their valid to date. Unlike a record list, users cannot alter knowledge
base entries with the list editor.
Global text search: users whose roles permit access to global text search can find knowledge articles along with
tasks, policies, service catalog items, and other records. Administrators can tailor which tables are searched.
Homepages: each user has a homepage that appears by default, typically filled with reports, selected knowledge
topics, and other commonly used functions. Users can personalize and rearrange their homepage based on what
information is most useful to them.
Content pages: the knowledge management team can create content pages that serve as a customer interface for
the knowledge base.
Forms that contain the knowledge icon: users can click the knowledge icon ( ) that appears in some forms to
initiate a knowledge search for the text in the adjacent field. This icon appears by default beside the Short
description field on the Incident and Problem forms. Administrators can configure other forms to include the
knowledge icon, as well.
Reporting: users can easily generate role-appropriate reports on knowledge feedback, development, and usage in
a variety of formats. These reports can be scheduled for email distribution, or added to homepages or content
pages. Users click a report element for a list of related knowledge articles.
Known errors: problems can be marked as known errors which adds them under Problem > Known Errors,
providing quick reference. Although items in the Problem > Known Errors module are not part of the
knowledge base, this information is important to the knowledge centered support (KCS).
In addition to the article's content, the page may show these elements, depending on administrator settings:
[1]
Responding "'No"' to the same question displays a Thank You message and opens the feedback field. This selection
may also display a Create Incident link, depending on administrator settings.
Clicking the Create Incident link creates an incident record that contains the knowledge search that led to the
article.
In the five-star rating area, move the mouse over the stars to display a rating preview in the header. Click a rating to
select it.
Select the Flag article check box to call the article to the attention of the knowledge management team. Selecting
the Flag article check box makes the Feedback field mandatory. Enter comments to help the knowledge
management team update the article appropriately.
Enhancements
Dublin
Knowledge article searching and browsing is supported for mobile devices. See Using Knowledge on Mobile for
more details.
References
[1] http:/ / en. wikipedia. org/ wiki/ Stemming
[1]
Search Suggestions
Type-ahead suggestions
The knowledge base and global text searches provide suggestions as you type. Type-ahead suggestions appear under
the search box. Suggestions are based on similar searches that begin with the same characters.
9
Note: Administrators must enable the "Did you mean?" properties for users to see these suggestions.
The articles viewed most frequently over the past 30 days (default) appear at the beginning and the least viewed
articles appear at the end. Administrators can modify the time period considered when sorting by view count.
Select an option from the Sort by field to sort by relevancy or by date modified, rather than view count.
Note: The sort option selected for Sort by is the only sorting factor applied; the other factors are not considered for secondary
ranking. So, for example, if you select to sort by Relevancy, and the search returns several results with the same relevancy values, the
Number of Views or Last modified values are not considered when ordering these same-value results.
Advanced Search
10
After refining a search, you can either refine it further or return to search
all articles:
Click the icon to search the knowledge base for the text in the associated field. Search results appear in a pop-up
window, eliminating the need to navigate away from the current page. The pop-up results window offers the same
options for refining the search as the standard search results page.
When viewed from the pop-up window, the article view includes an Attach to Task button; the button name
changes to reflect the active form. Click this button to attach the article to the current incident, problem, or other
record. Other users who open the same record can refer to the attached knowledge articles, as needed.
Users with the admin or knowledge_admin role also see an Edit Article button. Click this button to open the article's
Knowledge form.
If more than one translation of an article is available, the Language box appears in article view. Click a language
link to display the article in the selected language.
11
12
13
Creating Knowledge
14
Input Value
Number
Do not modify. The record number is assigned by the system and should not be changed.
Topic
Select the topic in which the article should appear in the knowledge portal. To add options, right-click the field label and choose
Personalize Choices.
Category
Select a category to further organize articles in the knowledge portal. Available categories depend on the selected topic. To add
options, right-click the field label and select Personalize Choices.
Published
Enter the date the article was published. The current date is used by default.
Valid to
Enter the date when the article expires. Only Published articles within the valid date range are visible to most users. ServiceNow
supplies a default date. To change the default date, right-click the field label and choose Personalize Dictionary.
This field is available only to users with the admin role.
Creating Knowledge
Image
15
Article type
Workflow
HTML: the Text field offers a WYSIWYG interface with a toolbar to apply formatting and create links. Click the HTML
icon on the toolbar to display HTML mode, where you can view and format with HTML commands.
Wiki: the Text field offers Wikitext icon that toggles between a preview of the formatted text and an edit field where you can
enter text with Wiki markup language to define formatting.
Select the workflow state for the article: Draft, Review, or Published. Generally, only Published articles appear in the portal.
Users with role-based permissions might also see articles in the draft or review state in the portal and search results, depending on
administrator settings.
This field is available only to users with the admin role.
Source
Click the reference lookup icon to select the task that formed the basis for this article, if any.
This field is available only to users with the admin role.
Roles
Specify user roles to limit who can view the article. Otherwise, all users can view the article after it is published.
This field is available only to users with the admin role.
Attachment link Select this check box to have this article's link open a file attachment. To upload the attachment, click the paperclip icon in the
upper right corner. The link in the knowledge portal or search results opens the attachment instead of navigating to the text of the
article. You can link to one attachment per article.
This field is available only to users with the admin role.
Display
attachments
Select this check box to display a list of attachments below the article. Although you can link to only one attachment (see the
Attachment link field), you can attach multiple files and list them below the article in article view.
This field is available only to users with the admin role.
Short
Description
Enter text to appear as a title for the article in the knowledge portal and search results.
Text/Wiki
Enter the text of the article. This area accepts either HTML or Wiki Markup, according to the selected Article type. If Article
type is HTML, you can work in WYSIWYG mode, using the toolbar above the text field to apply formatting and create links.
Click the HTML icon on the toolbar to open HTML mode, where you can view and format the text with HTML commands. See
Using HTML Fields for information on using the HTML editor.
If Article type is Wiki, click the Wikitext icon to toggle between an edit field and the formatted text. See Knowledge
Management Wiki Support for information on using wiki tags.
Update
Click the Update button to save any changes made to the form and return to the article list. To save changes and stay on the form,
right-click the header bar and choose Save.
Mark Public /
Mark Internal
Click the Mark Public button to make the article accessible to everyone. This action sets public as the role for the article.
Search for
Duplicates
Click this button to search the knowledge base for existing articles that contain similar content.
Delete
Click this button to delete the knowledge article from the system. You must confirm the request before the record is deleted.
Click the Mark Internal button to make the article accessible only to the roles specified by the administrator. If no roles are
specified, the article is available to the public and there is no change.
Note: If you include a permalink URL to another knowledge article, do not include the <span id="permatext"> tag that is part of the
permalink CSS, otherwise the normal permalink at the bottom of the article does not render correctly.
Creating Knowledge
16
Creating Knowledge
17
Creating Knowledge
Communicating a Workaround
To update all incidents associated with a problem, go to the Problem form and click the Communicate
Workaround related link. This adds the problem number and the contents of the s Workaround field as a new
entry in the Activity field on all related incidents.
By default, any entries made in an incident Activity field generate an email notification to the Caller on the Incident
form. The Communicate Workaround option on the Problem form quickly and easily communicates workarounds
to multiple users from one place, eliminating the need to manually update each incident.
If group on-call rotation scheduling is in effect when you communicate a workaround, ServiceNow stops the
escalations on the associated incidents because the workaround has been communicated to the end users.
This effectively communicates knowledge to the appropriate audience, but does not create a knowledge article.
Posting Knowledge
To create a new knowledge article from a problem immediately, rather than when the problem closes, go to the
Problem form and click the Post Knowledge related link. The resulting knowledge article contains the following
information:
The problem number and Short description become the knowledge article Short description.
The problem Description and Work notes become the knowledge article Text.
The problem Configuration item becomes the knowledge article Configuration Item for the Affected Products
related list.
The article Topic is set to Known Error.
By default, ServiceNow creates a knowledge article in Draft workflow state. If the knowledge submission workflow
is enabled, the problem Short description and Work notes are placed into a knowledge submission instead of an
article. For more information, see Knowledge Workflow.
18
Creating Knowledge
Posting News
To quickly create and publish a knowledge article in the News topic, go to the Problem form and click the Post
News related link. The resulting knowledge article contains the following information:
The problem number and Short description become the knowledge article Short description.
The problem Description and Work notes become the knowledge article Text.
The problem Configuration Item becomes the knowledge article Configuration Item for the Affected Products
related list.
By default, the Post News related link creates an article in the Published workflow state. These articles appear in
the News topic of the knowledge portal immediately.
If the knowledge submission workflow is enabled, the problem Short description and Work notes are placed into a
knowledge submission instead of an article. For more information, see Knowledge Workflow.
19
20
Wiki Tag
Headers
Numbered step
#Step 1
Bullets (multi-level)
*Bullet 1, **Bullet 2
Indentation
:Level 1, ::Level 2
Line break
<br>
Tables
Full table support, including cell spacing, padding, borders, background shading, and width measurements. See Creating
[1]
wiki tables . NOTE:Sortable tables are not supported (class="sortable").
Code blocks
Bold
'''text'''
Italics
''text''
Placed images
[[Image:<image name>]] See Storing Images in the Database for details on uploading image files to the database.
HTML
21
References
[1] http:/ / en. wikipedia. org/ wiki/ Help:Wikitable
22
5.
6.
7.
8.
By default, only users with the admin, knowledge_admin, and knowledge roles can access submission records.
Administrators can grant access to users outside the knowledge management team by assigning them a
knowledge role or by giving another role access to the Knowledge Base application.
Knowledge worker accesses the assigned submissions through Knowledge Base > Assigned to me or Service
Desk > My Work.
Knowledge worker reviews the submission to determine whether it represents a needed article, duplicates an
existing article, or is invalid (no article needed).
Knowledge worker creates a new article, updates an existing article, or closes the record.
ServiceNow notifies the technician that the submission is in progress or has been closed.
Technician name must appear in the Submitted by field for notifications to occur.
9. Knowledge management team moves new articles through the standard stages: Draft, Review, Published.
Note: This process affects only those articles submitted from the Incident and Problem forms. New articles created directly in the
Knowledge form always use the standard workflow.
23
24
Input
Number
Do not change. The number of the submission record is automatically assigned by ServiceNow.
Assignment
group
Assigned to
Select an individual to work on this submission. If an Assignment group was selected, only users from that group can be assigned.
To work on knowledge submissions, a user must have both the itil role and either the admin or the knowledge_admin role.
Status
Attachment
link
Select this check box to have this article's link point to a file attachment. To upload the attachment, click the paperclip icon in the
upper right corner. The link in the knowledge portal or search results displays the attachment instead of the article text. You can
link to one attachment per article.
This field is available to users with the admin or knowledge_admin role only.
Display
attachments
Select this check box to display a list of attachments as links below the article. Although you can have only one Attachment link,
you can attach multiple files and list them all as links in article view.
This field is available to users with the admin or knowledge_admin role only.
Parent
Displays the task (incident, problem, or change) number from which the submission was created.
Submitted by
Topic
Select the topic in which the article should appear in the knowledge portal.
Category
Select a category to further organize articles in the knowledge portal. Available categories depend on the selected topic.
Valid to
Enter the date when this article expires. Only Published articles within the valid date range are visible in the knowledge portal and
search. Articles that are not published or whose Valid to date has passed are not visible.
This field is available to users with the admin or knowledge_admin role only.
Text
Enter or edit the text of the article. This area accepts HTML. You can work in WYSIWYG mode, using the toolbar above the text
field to apply formatting and create links. Click the HTML icon on the toolbar to open HTML mode, where you can view and
format the text with HTML commands. For more information, see Using HTML Fields.
Update
Create Article
Click this button to immediately publish the current content as a public article. Do not use this button if the information should be
limited to users in specific roles.
Delete
Click this button to delete the knowledge submission from the system. You must confirm the request before the record is deleted.
Generated
Articles
Click New in this related list to create a new article that is associated with this submission. Additionally, this related list identifies
all articles that contain this submission record number in the Source field.
Retiring Articles
Each knowledge article has a valid to date. After that date passes, the article is no longer accessible through the
knowledge portal or knowledge searches. .
Knowledge management team members (admin, knowledge_admin, or knowledge roles) can access retired articles
through Knowledge Base > Retired or Knowledge Base > Edit. Review retired articles to determine whether they
should be updated and republished, deleted, or retained for historical reference.
Articles that have passed the valid to date still show Published as their workflow state. Administrators can change
the workflow state:
Manually by opening the record for each article whose valid to date has passed and changing the Workflow field
to Retired.
Automatically by duplicating the Incident Autoclose business rule and modifying the script appropriately.
25
26
Knowledge portal
Article view
Knowledge search
Other related elements
In addition to the property settings, administrators can configure a variety of other knowledge search features. For
example, you can enable searching from additional forms and fields, add meta tags to enhance searching, and enable
search suggestions. For more information, see Administering Knowledge Search.
Knowledge Accessibility
The ServiceNow knowledge base can be public or private. The knowledge base is private by default.
A public knowledge base is accessible to everyone, no login required. When a user enters the URL <instance
name>.service-now.com/kb_home.do, the knowledge portal appears. This approach provides easy access to
published knowledge articles. Administrators can protect sensitive content by applying role-based access to those
articles.
A private knowledge base requires users to log in before they can access any articles. When a user enters the URL
<instance name>.service-now.com/kb_home.do, the login page appears. After logging in, users see the knowledge
portal. This approach provides secure access to all knowledge articles. Administrators can further protect sensitive
content by applying role-based access to those articles.
Administrators can make a public knowledge base private or make a private knowledge base public, depending on
organizational needs.
27
1. If it is not active, activate the System Definition > Public Pages module by editing the System Definition
application.
2. Navigate to System Definition > Public Pages.
3. Filter the list to view pages that start with kb_.
4. Open each page whose accessibility is to be changed and select the Active check box to make the page public.
Clear the Active check box to make the page private.
For a public knowledge base, both the kb_home and kb_list pages must be active. Login is required to view
articles for any pages that are not active.
These public pages affect the accessibility of the knowledge portal.
Page Name
Description
kb_comments Enables public users to see comments from other users, if active.
kb_find
kb_home
Displays the knowledge portal page, if both this page and kb_list are active.
kb_list
Displays the list of articles on the knowledge portal page, if both this page and kb_home are active.
kb_view
Knowledge Portal
Arranging Topics
Use the Knowledge Management Properties page to configure whether empty topics appear on the knowledge portal.
By default, topics display from left to right on the knowledge portal in the same sequence that they appear on the
Knowledge form's Topic choice list.
Any user can temporarily change the order of topics on their view of the knowledge portal:
1. Click and hold on the topic header bar.
2. Drag the topic box to the desired location.
Administrators can permanently change the portal's standard topic arrangement by reordering the choices in the
Topic field. See Adding or Removing Knowledge Topics.
28
29
Article View
Administrators can control the presence and appearance of various elements on knowledge article pages.
The Show "Link" URL in Knowledge articles property lets you control whether the permalink (direct link to
the article) appears below an article.
The kb_article_footer UI macro lets you control the look of the permalink and view count.
The kb_view UI page lets you control the look and feel of page layout features, article metadata (article number,
date published, and date last modified), and feedback options. This UI page also lets you control where and how
related information appears on the page: affected products, attachments, and tasks to which the article is attached.
<j:if test="${gs.hasRole('itil')}">
</j:jelly>
30
31
URL used for the "Create Incident" link after rating a Knowledge article not helpful: specifies the URL for
creating an incident. The default setting is:
incident.do?sys_id=-1&sysparm_query=active=true^comments=(Created
Knowledge search: [HTML:sysparm_search])&sysparm_stack=kb_home.do
after
Flag Article
When a user selects the Flag article check box, the Feedback field becomes mandatory. Control these options in
Knowledge Base > Properties.
Show "Flag Article" option to identify incomplete/inaccurate articles: controls whether this option appears in
article view.
List of roles (comma separated) that can flag incomplete/inaccurate articles: sets the roles permitted to see
this feedback option.
Navigation Add-ons
Knowledge base navigation add-ons let you:
Add new search engines to the advanced search function.
Add links at the top of knowledge pages.
32
4. Click Submit
Search Site
Sample Script
Microsoft
Support
self.location =
'http://www.support.microsoft.com/search/default.aspx?query=' + text;
Google
Search
window.open = 'http://www.google.com/search?sourceid=service-now&q=' +
text;
Adding Links
These links display at the top of knowledge pages by default: Knowledge Home, Create Incident, and Print.
To add a new link above knowledge pages:
1. Navigate to Knowledge Base > Navigation Add-ons.
2. Click New.
3. Fill in the fields as follows:
Name: enter text for the link.
Type: select Link.
Order: enter a number to indicate the sequence for displaying links (lowest to highest).
URL: enter or paste the full URL for the new link.
4. Click Submit.
The URL now appears in the top right corner of the knowledge pages, in the order specified.
[1]
for text searches, meaning that search terms may return similar words. See How search
To monitor the number of views for a search key word, use the Search Log.
Search rankings
By default the search results are sorted by number of views (see Sorting Search Results for more information).
Search results rankings are based on scoring "weights" (by default, base system knowledge articles have the highest
weight).
Administrators can set the relative weight for each field in a table being searched.
5. Click Update.
6. Create an onLoad() client script (System Definition > Client Scripts) for the table associated with the
customized form. Be sure the script contains the following:
33
34
35
Search Suggestions
"Did you mean?" search suggestions are disabled by default, but can be enabled by an administrator. For information
about using search suggestions, see Search Suggestions. For information about configuring search suggestions, see
Administering Zing Text Search.
36
37
Knowledge portal
Article view
Knowledge search
Other related elements
Description
Select the Yes check box to display topic sections only if there
are articles for the topic. Clear the check box to show all topic
sections, even those with no assigned articles.
Set the maximum number of articles per topic for the knowledge
portal. The specific articles shown depends on the Knowledge
section sort field property setting.
38
Select the default order for articles within each topic section on
the knowledge portal.
List of roles (comma separated) that can see articles in the Review workflow
state in the Knowledge portal and Topic list.
(glide.knowman.section.view_roles.review)
List of roles (comma separated) that can see articles in the Draft workflow state
in the Knowledge portal and Topic list.
(glide.knowman.section.view_roles.draft)
Show only Knowledge topic titles on portal page (no article links).
(glide.knowman.home_titlesonly)
Select the Yes check box to omit all article titles from the
knowledge portal and show only the topic names. Users can click
the topic title to see the list of related articles.
Number of days (integer, default 30) used when summing article views. Views
older than this are not considered when sorting articles based on view count. 0
means consider all views. (glide.knowman.view_age.days)
Select the Yes check box to have ServiceNow place the cursor in
the search field when a user opens the knowledge portal. Clear
the check box to have users click in the search field before
entering a search term.
39
Description
Show article rating section, which may optionally include yes/no rating, star rating, and
flagging options. (glide.knowman.show_rating_options)
Select the Yes check box to display the rating options for
users with specific roles. Clear this check box to omit the
rating section for all users, regardless of role.
The Feedback field is always displayed for all users.
List of roles (comma separated) that can see an article's rating section, which may
optionally include yes/no rating, star rating, and flagging option.
(glide.knowman.show_rating_options.roles)
Select the Yes check box to display the "Was this article
helpful?" rating to users with roles set in the associated
property. This appears only if the Show article rating
section... property is selected.
List of roles (comma separated) that can see yes/no "Was this article helpful?" rating
option. (glide.knowman.show_yn_rating.roles)
Show "Create Incident" link after a Knowledge article is rated not helpful.
(glide.knowman.create_incident_link.display)
URL used for the "Create Incident" link after rating a Knowledge article not helpful.
(glide.knowman.create_incident_link)
Enter the URL for the page where users can create an
incident only if the Show "Create Incident" link..."
property is selected.
To find the URL, open the appropriate page, then
right-click the header bar and choose Copy URL.
Highlight the URL that appears and use the browser's
copy and paste feature to place it into this property field.
40
List of roles (comma separated) that can see five-star rating option.
(glide.knowman.show_star_rating.roles)
Select the Yes check box to display the flag article option
to users with roles set in the associated property. This
appears only if the Show article rating section...
property is selected.
Select the Yes check box to have article view include the
Permalink URL that links directly to the article. Users can
easily copy the URL and share it with others.
List of roles (comma separated) that can see user comments on an article.
(glide.knowman.show_user_feedback.roles)
41
Property
Description
Select the Yes check box to have the search results page include
the area that lets users filter the results by topics and categories.
Search method used when searching Knowledge from a task or directly in the
Knowledge Base... (glide.knowman.search.operator)
Select the search approach to use when the search term includes
multiple words.
Description
When a user searches knowledge from a task form (incident, problem, change
request, or other) and clicks the article's Attach to Task button, the system
copies the article number and content into the field specified here. For more
information, see Customizing the "Attach to Task" Button.
Select the Yes check box to use the knowledge submission workflow instead of
the standard knowledge workflow. If this option is selected, each time a user
creates knowledge from an incident or problem, the content is placed into a
submission record instead of a draft article. Transforming knowledge
submissions into articles follows a specific workflow.
42
Translating Knowledge
Translating Knowledge
Overview
Organizations with knowledge users who speak multiple languages can activate the optional knowledge
internationalization features. When active, knowledge internationalization enables the knowledge management team
to create language-specific knowledge articles and keep translations of the same article related to each other so they
are easy to manage. Users can view and search within their own language while still being able to view articles in
other languages when necessary.
Installed Components
Activating the Knowledge Management Internationalization plugin installs these components:
A relationship named Translated Versions that creates a related list on the Knowledge form showing other
articles that have the same parent article.
A business rule named knowledge query that automatically filters the knowledge portal and search results based
on the user's selected language.
A UI macro named kb languages (see Using the Translated Knowledge Base).
Two fields, named Language and Parent, in the Knowledge [kb_knowledge] table and the Knowledge form.
Translating Knowledge
Translating Knowledge
To translate a knowledge article:
1.
2.
3.
4.
5.
For more information about fields on the Knowledge form, see Creating Knowledge.
6. Right-click the header bar and select Save.
The Translated Versions related list appears at the bottom of the page, listing the parent article and all other
articles assigned to the same parent article.
43
Translating Knowledge
Users can search in any available language through the Advanced search link in the knowledge search. The Zing
search engine supports search terms with international characters.
If more than one translation of an article is available, article view includes a Languages box. When the user clicks a
language link, ServiceNow loads the translated article title and text without reloading the page. The language links
44
Translating Knowledge
available are based on the relationships defined with the Parent field and the Translated Versions related list.
The language box is generated by the UI macro kb_languages. Administrators can restrict the language box to
particular roles by adding the property glide.knowman.show_language_options.roles with a
comma-separated list of roles. If the roles list is empty, the language box is available to all users, regardless of role.
To remove the language box for all users, add the property glide.knowman.show_language_options and
set it to false.
45
46
Knowledge use by Author: monthly trend chart of articles attached to tasks grouped by author.
Knowledge updated in past 30 days: pivot table showing the number of articles drafted and published.
Knowledge by Workflow state: pie chart of articles in each workflow state.
Knowledge Ratings for past 30 days: tabular representation of article ratings by topic.
Most of these reports appear as gauges on the default Knowledge Management homepage. Users with role-based
permission to access the Reports application can view all of the knowledge management reports with the Reports
application.
Reporting on Knowledge
Click an element in a report or chart to open a list filtered for that element. For example, in the Knowledge by
Workflow state pie chart, click the Published pie slice to open the list of published articles. In the Knowledge
views bar chart, click a bar to open the Knowledge Use list filtered for the selected topic.
Users can customize the Knowledge Management homepage, adding, moving, and removing items to meet their own
needs. These changes affect only their personal view of the homepage.
Administrators can modify the homepage to make it available for users with other roles, to change the reports
displayed and their arrangement, and to add other content. These changes affect all users who have not customized
their personal view of the Knowledge Management homepage.
47
Reporting on Knowledge
Click an element in a report or chart to open a list filtered for that element. For example, in the Knowledge by
Workflow state pie chart, click the Published pie slice to open the list of published articles. In the Knowledge
views bar chart, click a bar to open the Knowledge Use list filtered for the selected topic.
For more information about generating reports, see Creating Reports. For more information about using the report
header to define a report, see the description of the specific report type.
48
Posting a comment
Answering Was this helpful?
Rating the article
Flagging the article
All of these responses are tracked as fields on the Knowledge Feedback [kb_feedback] table. Knowledge
management team members (admin, knowledge_admin, and knowledge roles) can navigate to Knowledge Base >
49
Each type of feedback occupies its own field. (Personalize the list to add fields that do not appear by default). If a
single user responds to an article in multiple ways (for example, posting a comment and flagging an article), both
types of feedback appear in the same record. However, if different users respond to the same article, these responses
are stored in different records.
Click the Created date to view the feedback record.
Click the Article number to view the Knowledge record.
In addition to the Feedback module, team members with the admin or knowledge_admin role can view the list of
flagged articles in the Knowledge Base > Flagged Articles module. These users can view ratings in the Knowledge
Base > Ratings module.
50
Information on article use is kept in raw form on the Knowledge Use [kb_use] table. To view this table, enter
kb_use.list into the application navigator filter.
Administrators can personalize the Knowledge form to show information about article use.
Add the Use Count field to show the number of tasks to which the article is attached.
Add the Attached to Task related list to show tasks the article is attached to. For more information, see
Searching Knowledge from Forms.
Add the Knowledge Use->Article related list to show all of the knowledge use records created for this article.
These records indicate whether the article was viewed or attached to a task (form).
51
4. Create a business rule that calculates the Viewed but not used field. The business rule subtracts Times used
from Times viewed each time the record is updated.
52
Here is a copy of the script that you can copy and paste into the Business Rule form:
calculateNotUsed();
function calculateNotUsed() {
var vViewed = Number(current.sys_view_count);
var vUsed = Number(current.u_times_used);
current.u_viewed_but_not_used = vViewed - vUsed;
}
5. Navigate to System Policy > Script Actions and create a new script action that updates the Last viewed time
stamp when it identifies that a knowledge article has been viewed. The script should look like this:
Here is a copy of the script that you can copy and paste into the Script Action form:
var kbNum = event.parm1;
var rec = new GlideRecord('kb_knowledge');
rec.addQuery('number',kbNum);
rec.query();
while(rec.next()){
53
In the navigation filter, enter sys_properties.list to open the System Properties table.
Open the glide.knowman.order.search record.
in the Choices field, add Times used=u_times_used at the end.
Click Update.
Open the glide.knowman.section_sort record.
in the Choices field, add Times used=u_times_used at the end.
Click Update.
Navigate to Knowledge Base > Properties and find the Knowledge search result order property.
You can now select Times used for sorting search results.
Change the kb_find UI page so that it can identify these new sort parameters.
1.
2.
3.
4.
if (sortSequence != 'relevancy') {
if (sortSequence == 'views'){
kb.orderByDesc('sys_view_count');
}
else{
kb.orderByDesc('u_times_used');
}
}
54
The script returns a maximum of 20 results from the Task tables to avoid returning potentially thousands of results.
This number can be changed by modifying the var maxTasks = 20; line below.
To implement this script and other kb_find modifications in this article:
1.
2.
3.
4.
55
kb.addQuery('active', 'true');
kb.addQuery('workflow_state', 'published');
var orderField = 'relevancy';
var sortSequence = gs.getProperty('glide.knowman.order.search');
if (sortSequence != 'relevancy') {
if (sortSequence == 'views'){
kb.orderByDesc('sys_view_count');
orderField = 'view count';
}
else{
kb.orderByDesc('u_times_used');
orderField = 'times used';
}
}
kb.query();
<j2:if test="$[gs.hasRole('itil')]">
task.query();
</j2:if>
<tr>
<td class="title" nowrap="true" colspan="99">
56
<g2:inline template="kb_search_results.xml"/>
57
<g2:evaluate>
var ctr = 0;
var maxTasks = 20;
if (taskCount > maxTasks){
taskCount = maxTasks;
}
</g2:evaluate>
58
59
</table>
</j:jelly>
Here is a copy of the script that you can copy and paste into the Schedule form:
//
//
of
//
60
var pn = 6;
if (pn > 0) {
var gr = new GlideRecord('kb_knowledge');
gr.addQuery('workflow_state', 'published');
gr.addQuery('u_last_used', '<', gs.monthsAgo(pn));
gr.query();
while(gr.next()) {
gs.eventQueue("kb.unused.notify", gr, gs.getUserID(),
gs.getUserName());
}
}
To complete the implementation.
1. Create an event called kb.unused.notify.
2. Register the event.
3. Create an email notification to alert the Knowledge Manager of the rarely used articles.
The script triggers a kb.unused.notify event that you can then use to trigger an email notification. Make sure that
this event exists in the event registry before selecting it in the email notification. For more information, see Events
and Email Notification.
References
[1] http:/ / community. service-now. com/ forum
61
62
63