Knowledge Management Help Topics For Printing
Knowledge Management Help Topics For Printing
Legal Notices
Warranty
The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be
construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.
The information contained herein is subject to change without notice.
Copyright Notice
© Copyright 1994-2014 Hewlett-Packard Development Company, L.P.
Trademark Notices
Adobe® is a trademark of Adobe Systems Incorporated.
Java is a registered trademark of Oracle and/or its affiliates.
Microsoft® and Windows® are U.S. registered trademarks of Microsoft Corporation.
Oracle® is a registered US trademark of Oracle Corporation, Redwood City, California.
UNIX® is a registered trademark of The Open Group.
For a complete list of open source and third party acknowledgements, visit the HP Software Support Online web site and search for the product manual called HP Service
Manager Open Source and Third Party License Agreements.
Documentation Updates
The title page of this document contains the following identifying information:
l Software Version number, which indicates the software version.
l Document Release Date, which changes each time the document is updated.
l Software Release Date, which indicates the release date of this version of the software.
To check for recent updates or to verify that you are using the most recent edition of a document, go to: http://h20230.www2.hp.com/selfsolve/manuals
This site requires that you register for an HP Passport and sign in. To register for an HP Passport ID, go to: http://h20229.www2.hp.com/passport-registration.html
Or click the New users - please register link on the HP Passport login page.
You will also receive updated or new editions if you subscribe to the appropriate product support service. Contact your HP sales representative for details.
Support
Visit the HP Software Support Online web site at: http://www.hp.com/go/hpsoftwaresupport
This web site provides contact information and details about the products, services, and support that HP Software offers.
HP Software online support provides customer self-solve capabilities. It provides a fast and efficient way to access interactive technical support tools needed to manage your
business. As a valued support customer, you can benefit by using the support web site to:
l Search for knowledge documents of interest
l Submit and track support cases and enhancement requests
l Download software patches
l Manage support contracts
l Look up HP support contacts
l Review information about available services
l Enter into discussions with other software customers
l Research and register for software training
Most of the support areas require that you register as an HP Passport user and sign in. Many also require a support contract. To register for an HP Passport ID, go to:
http://h20229.www2.hp.com/passport-registration.html
Contents
Knowledge Management user roles 8
KCS I 8
KCS II 9
KCS III 11
Adaptive learning 92
Searching with adaptive learning 93
Viewing adaptive learning data 93
Edit adaptive learning data 94
Enable or disable adaptive learning 95
Searching the knowledgebases 95
Knowledge documents 96
Published knowledge documents 97
Reverting a working copy document 97
Retired knowledge documents 97
Using the Pending Documents queue 98
Tips for searching the knowledgebases 99
Search engine relevance ranks 99
Special characters in search queries 99
Knowledge Administrator role 100
Knowledge-Centered Support (KCS) 100
Knowledge Management statistics tracked in the kmusagehistory table 101
Knowledge Management sample data 102
KCS I
The KCS I user role has the following responsibility:
To execute this role, the KCS I has the following tasks available:
Note: For an overview of how these tasks fit in the Knowledge Management workflow, see
"Knowledge Management workflows and tasks" on page 13.
KCS II
The KCS II user role has the following responsibilities:
To execute this role, the KCS II has the following tasks available:
Note: For an overview of how these tasks fit in the Knowledge Management workflow, see
"Knowledge Management workflows and tasks" on page 13.
KCS III
The KCS III user role has the following responsibilities:
To execute this role, the KCS III has the following tasks available:
Note: For an overview of how these tasks fit in the Knowledge Management workflow, see
"Knowledge Management workflows and tasks" on page 13.
The Knowledge Management process consists of the following workflows and tasks.
l The process begins when a contributor creates a new submission or revising an existing knowledge
document. The contributor selects a documentation type, enters basic details, selects a category
type, and submits the draft for review by a Knowledge Analyst.
l The analyst can edit, accept, or reject the document. If necessary, the document can be passed to
a Knowledge Expert, who can also edit, accept, or reject it. The Knowledge Expert is typically a
subject-matter expert with more in-depth understanding of a given topic and the ability to determine
the accuracy and currency of the KM document.
l The Knowledge Manager makes the final decision about whether to accept the document or return it
for further revision. If the document meets all KM publication criteria, the Knowledge Manager
accepts and publishes the document.
You contribute a knowledge document by authoring knowledge articles or using external documents
that are uploaded into a knowledgebase. When you author a document, you will be asked to specify a
document type. Knowledge documents can be saved as drafts before they are complete. You can also
preview a document while you are creating it.
As part of the task to create a knowledge document, you need to assign it to a document category or
several document categories, depending upon the topic of the knowledge document. After you have
created the knowledge document, you need to either submit it for approval or publish it for either internal
or external viewing. In the out-of-box system, a user with a KCS II profile can immediately publish a
document for internal viewing and a user with a KCS III profile can immediately publish a document for
an internal or external audience.
l Font formatting
l Table creation
l Spell checker
Note: Tabbing is not available in the rich-text editor. Use the space bar to create indents. Using
the tab key will exit you from the editor. For additional information regarding the editor, see the
related topics links below.
The rich-text editor toolbar contains many of the common icons and editing functions available with
most word processors. For example, with the rich-text editor you can cut, paste, and copy text. You
can search for a text string within the text. You can select from a small group of font types and size to
stylize the text in the document you are authoring. There is a table wizard you can use to add a table to
your document.
In addition to the standard functions of a word processor, you can also use the rich-text editor to add
links in your document to other documents that are either document attachments for the document you
are authoring or links to other documents in the knowledgebase. There is also a Source button that
displays the HTML code used in the document. This is particularly useful when you are creating
particular document views for the document types.
Note: There is a Preview button on the rich-text editor toolbar that opens the document in another
browser window. It is best to use the Preview button on the Contribute Knowledge form toolbar
rather than the one on the rich-text editor toolbar to preview a document. The Preview button on
the Contribute Knowledge form displays the document in the document view associated with the
document you are authoring.
When knowledge document attachments need updates, users must send those knowledge documents
into the workflow. Editors can then view, edit, save, and re-upload updated attachments for knowledge
documents.
Attachments maybe indexed for searching on a per-knowledgebase basis. Consult your Knowledge
Management administrator to determine if attachments are indexed for the Knowledge Library
knowledgebase.
5. In the Locale list, choose the locale to be used by the search engine when searching and indexing
the document. By default, the language code matches the language you logged in as. Changing
this field overrides the Knowledgebase default locale setting.
Note: When you contribute a new document, a draft document does not require a document
category assignment, but any document that is going to be submitted for approval or
published immediately must be assigned to at least one document category or subcategory.
d. Double-click the subcategory or click Skip to end the category or subcategory selection.
Note: If you assign the document to the wrong category, you can remain in the edit mode,
select the category you want to delete, click Remove, and then click Add to assign the
document to a new category.
7. If needed, repeat the steps until you are finished adding all the categories for the document.
o For Web-tier clients: click Add File, type the full path of the file in the File location text
field or browse to the file, and then click OK.
o For Windows clients: right-click in the blank area of the attachments list, click Add,
browse to the file, and then click Open.
Note: If you are editing an attachment for an existing knowledge document, you must
send the document to the workflow. You can then save the attachment to your
desktop, make the necessary updates, save the changes, and then re-upload the
attachment to the knowledge document.
b. Type the name of the attached file in the Filter Text field, or leave the field blank so that all the
attachments are listed for selection.
c. In the Link Text field, specify the Alt Text for the link.
d. Click Next and then double-click the name of the attached file from the list of files.
b. Click the Insert a link toward another record icon on the rich-text editor toolbar. The
message "Document saved to allow attachment linking" appears.
c. Click Knowledge Document in the Select Link Type wizard and edit the Link Text label.
d. Click Next and then type the document ID. The document must be a published document in
the database, and you must have view access to at least one of the categories to which the
document belongs.
e. Click Finish and then click Preview to view your document and the new link.
Note: The link does not open until the document in which you are trying to add the link is
either published internally or externally.
Note: The html toolbar that allows you to insert an image is not visible if you select the
document type as External.
a. If your document does not yet have the image as an attached file, attach the image as
described above.
c. Type the name of the image file in the Filter Text field, or leave the field blank so that all of the
image files listed on the Attachments tab are included in the selection wizard.
Note: You can attach only .jpg and .gif format images.
d. In the Link Text field, specify the Alt Text for the image.
f. Click Next.
15. If you want to save the document as a draft, click Save Draft.
16. Click Save or click the applicable button to submit the document for approval or to publish the
document immediately if you are a KCS II or KCS III for the document category.
4. Click Delete.
You can also view a retired or published document. When you select the document from the list of
retired or published documents, the document appears in the document view.
When you search, use the hyperlink in the search results list to view a document.
Once you have created a draft knowledge document, you submit it for review and approval.
2. Open the draft document from Knowledge Management > Draft Documents.
3. Click Submit.
The document is submitted for approval and its status changes to triage. The document will
appear in the Pending Documents queue. Depending on the document quality, the approver
takes further actions. For example:
n Click Submit for Revision to send the document for further revision.
n Click Publish Internal or Publish External to publish the document internally or externally.
Hot news entries contain very recent information regarding server outages or other infrastructure
failures. Hot news can also include solutions to a new incident or problem.
4. Specify an expiration date for the hot news document. This is the date by which the document
content should be reviewed for accuracy and timeliness.+
5. Select a document category for the hot news on the Categorization/Flags tab.
7. Use the calendar to specify a Valid from and Valid to date range. These dates specify when the
document is marked as hot news so that a hot news search displays the document. You can
specify a date in the future for the document to become hot news and a date when the document is
no longer hot news.
8. Use the rich-text editor to enter text for the hot news.
10. Click the applicable button to submit the document for approval or to publish the document
immediately.
A working copy of a knowledge document becomes a working copy when a published document goes
into the document workflow to be updated. When the working copy of the document is published, it
replaces the original document. A working copy of a published document has an "R" appended to the
document ID. A new document submitted for review to be published is also considered a working copy
while it is in the workflow waiting to be published, but there is no "R" appended to the document ID.
To create a working copy of a knowledge document by using Published Documents, follow these
steps:
2. Click Search.
9. Select the knowledge document to be approved in the workflow. The title column in the list
contains the document ID with an R suffix for working copy and the title of the document.
10. Update the working copy of the document in the embedded rich text editor, and click Save.
For example, click Submit for Revision. The status of the working copy changes to revise.
To create a working copy of a knowledge document by using Search, follow these steps:
3. Click Search.
4. Click the hyperlink for the document in the search results list.
Note: It is useful to add feedback because the KCS II or III user who creates the working
copy might not be the one responsible for updating the content. By providing feedback, you
can explain what needs to be updated or the reason for creating a working copy of the
document.
10. Select the knowledge document to be approved in the workflow. The title column in the list
contains the document ID with an R suffix for working copy and the title of the document.
11. Update the working copy of the document in the embedded rich text editor, and click Save.
For example, click Submit for Revision. The status of the working copy changes to revise.
To create knowledge from an Interaction, Incident, Problem, or Known Error record, follow these steps:
1. While working with the record, click More or the More Actions icon to select Create Knowledge.
2. If a document type selection form opens, select a document type for the document.
3. As required, view and update the fields the system has completed with the mapped information
from the record you selected during your search. The data inserted in these fields depends on the
document type and the defined field mappings.
6. Use the rich-text editor to enter or edit text for the document.
8. Click the appropriate button to submit the document for approval or to approve the document
immediately.
Editing a document in place is an option that allows you to edit published documents and then re-
publish the document immediately for either internal or external use without sending the document to
workflow. This allows you to update documents quickly that for some reason need to be updated and
made available immediately.
The edit in place option is available for published documents only. It does not apply to knowledge
candidates, such as working copies of a document or draft documents.
Caution: Knowledge document attachments that are updated using the edit in place option will
result in a broken attachment link and a broken knowledge document link. When a knowledge
document attachment needs updates, then the document must be put into the workflow so that the
editor can save the attachment to the editor's desktop, make the necessary updates, save the
changes, and then re-upload the attachment to the knowledge document.
In the out-of-box system, the permission for edit in place is set for KCS II, KCS III and KM ADMIN
Knowledge Management profiles. A user with a KM ADMIN profile manages assigning the edit in place
permission to KM profiles.
You contribute a knowledge document by authoring knowledge articles or using external documents
that are uploaded into a knowledgebase. You can use the rich-text editor to create or edit documents,
and you can add documents as attachments that can include images, text files, Word files, or PDFs.
1. Click Knowledge Management > Published Documents, or use Search to find the published
document.
3. Click Edit.
4. Make the changes to the document in the editable view of the document.
n For Web-tier clients: click Add File, type the full path of the file in the File location text field or
browse to the file, and then click OK.
n For Windows clients: right-click in the blank area of the attachments list, click Add, browse to
the file, and then click Open.
Note: If you are editing an attachment for an existing knowledge document, you need to
save the attachment to your desktop, make the necessary updates, save the changes, and
then re-upload the attachment to the knowledge document.
10. Click the appropriate button to publish the document immediately for the document category or
click Cancel to revert the document to the published version.
A default Knowledge Management security profile allows users to search and view externally published
knowledge documents for those documents in categories to which the profile has access. Users can
also submit feedback on these documents.
6. Click OK.
3. Click the hyperlink for the document in the search results list.
7. Click OK.
4. Click Add.
7. Click OK.
Once the contributor has submitted a document for approval, if needed you can send it for further
revision.
The document is submitted for further revision and its status changes to revise. You or somebody
else can further revise the document and then submit it for review.
Once you have made revisions to a document in revise status, you can submit the document for
review.
1. From Knowledge Management > Pending Documents, open a document in revise status.
The document is submitted for review and its status changes to review. The document will appear
in the Documents for Review queue. The reviewer can then accept the document or if needed
return it for revision.
Accept a document
User roles: KCS II, KCS III
Once you have completed your review of a document and believe all necessary revisions have been
made to the document, you can accept the document.
1. Open the document from Knowledge Management > Documents for Review.
You can still return the document for revision or review by clicking the Return for Revision or
Return to Review button, or you can then directly publish it internally or externally.
1. Open the record to which you want to add an attachment. To do this, select a record from the
queue or search for a specific record.
Note: You can also add an attachment when you create a new record.
3. Click Add files, and then browse to the file or files that you want to attach to the record.
After you confirm your selection, a progress bar in the File Name column displays the progress of
the file upload process.
Note: The multiple file upload and progress bar functionality is only available in browsers that
support the HTML5 File API (for example, Mozilla Firefox, Google Chrome, or Windows
Internet Explorer 10).
The file is now uploaded. However, the file is not attached to the record until you click Save. To
remove a file that is uploaded in error, click the X icon in the Remove column before you click
Save.
Note:
n The size limit for individual attachments and the space that is available for storing
attachments are displayed in the upper-right corner of the Attachments section.
n If you try to attach a file that exceeds the size limit for individual attachments or the total
available space, you receive an error message, and the attachment is not uploaded.
n If you try to attach a type of file that is not permitted (for example, an .exe file), you receive
a message that prompts you to remove the attachment. If you do not remove the
attachment, it is removed automatically when you click Save.
n There is no limit to the number of files that you can attach to a record, provided that they do
not exceed the size limit. However, we recommend that you do not attach more than 20
files to a single record.
n If you refresh the browser or click certain comfill buttons that refresh the browser before
the file upload process is complete, the file is not uploaded.
4. Click Save.
1. Open the record to which the file that you want to open is attached. To do this, select a record from
the queue or search for a specific record.
3. To open a single file, click the file name or the download icon in the Download column.
To open multiple files, select the files that you want to open by using the check-boxes next to the
file names, and then click Download.
4. Click Save.
Note: The number of attached files is displayed on the Attachments section heading. This
enables you to identify whether a record has attachments quickly without having to expand the
Attachments section.
However, the number of attached files is not displayed if a custom dynamic view dependency is
configured for the section or tab title. This is because the custom dynamic view dependency may
include file count information.
If a file is attached to the record, the following information is displayed in the table in "Attachments"
section:
Attached files are displayed in the order in which they were uploaded.
1. Open the record from which you want to delete an attachment. To do this, select a record from the
queue or search for a specific record.
To delete multiple files, select the files that you want to delete by using the check-boxes next to
the file names, and then click Remove.
5. Click Save.
Each type of knowledgebases has different fields that are indexed for searching, so specific search
parameters that match the fields in the knowledgebase must be provided. For example, the knowledge
articles have a title and author field. When you view an Incident record, the out-of-box system displays
the Incident number, description, and solution for closed incident records.
User
You can search knowledgebases to determine if your current issue matches any existing incidents or
problems with known solutions or workarounds. Using an existing solution or workaround reduces your
organization's costs and ensures that you are following approved policies and procedures.
3. Select the knowledgebase libraries in the Search In section to narrow your search.
4. Click Search.
HP Service Manager returns a list of documents matching your search request. If there are no
results, type a new search string for your search or use Advanced Search to specify additional
search criteria.
You can use advanced search to narrow the results of a simple search or to restrict your search to
certain conditions. In the advanced search, you can specify what knowledgebases and document
categories HP Service Manager searches. You can also specify a set of filtering parameters such as
exact phrase and creation date.
Tip: Select specific criteria if you can. For example, you can use the date fields to specify a
particular date and time range.
6. Click Search.
HP Service Manager returns a list of documents matching your search request. If there are no
results, type a new search string for your search or specify additional search criteria.
User
Sometimes a knowledgebase search query results in more matches than you can quickly and easily
review. In such cases, you may want to search within your search results to find documents that
address your particular issue. You can use both the simple and advanced search options to search
within your search results.
3. Click Search. HP Service Manager returns a list of documents matching your search request.
4. Select the Search within results check box to continue searching within the search results.
Tip: Make your second search as specific as possible to reduce the number of search results
the query returns. For example, rather than searching for a generic term such as "server," use
specific terms such as the server model number or name. You can also use the Advanced
Search options to limit your search to particular knowledgebases.
6. Click Search. Service Manager returns a list of documents matching your search request.
You can continue revising your search string to make the search more efficient; however, the
search only searches the search results list.
Caution: Clear the Search within results check box to start a new search.
All users
By default, knowledgebase search results are sorted only by Relevancy in descending order. Once you
have completed a knowledgebase search and a list of search results already displays, you can specify
your preferences to sort the results.
2. Perform a search.
Note: The sort options are not available until you have completed a search and a list of search
results already displays.
n Sort by multiple fields: If selected (default), sorts the current search results by a combination
of these fields in the following order: Modified Date, Status, and Relevancy; If not selected,
sorts the current search results by one of the these three fields.
n Modified Date: When clicked, sorts the current search results by modification date in
ascending or descending order. The name of the actual sort field is "sysmodtime" for all out-of-
box knowledgebases.
n Status: When clicked, sorts the current search results by status in ascending or descending
order. The actual sort field being used varies with the knowledgebases: "problem.status" for
Incident_Library, "open" for Interaction_Library, "status" for Knowledge_Library, and
"rcStatus" for both KnownError_Library and Problem_Library.
n Relevancy: When clicked, sorts the current search results by relevancy in ascending or
descending order.
Published knowledge documents are documents that are available for searching and viewing. Some
documents may only be viewed by internal users, while others can be viewed by internal and external
users. Published documents can be edited by users with applicable privileges. Users can also provide
feedback to published documents.
2. Type as much information available in the search form. For example, you can type a portion of the
title of the document or a phrase from the summary of the document in the appropriate field.
3. Click Search.
4. Select and click the document in the list to view the document.
5. Depending upon your profile, you can edit the document, view and update the adaptive learning
data, or retire the document.
User
KCS I
KCS II
KCS III
KMAdmin
You can search hot news for information about system conditions, outages, or system bulletins
effecting groups of users. Service Desk Agents and Service Desk Managers typically post hot news to
inform users about the current conditions of the system.
When adaptive learning is enabled, data about the queries that returned documents that were used for
solving issues is stored and integrated into the documents when they are indexed.
Note: You must have a KM ADMIN profile to use the Adaptive Learning search function on the
Knowledge Management Administration menu.
2. Type the document ID if you are looking for the adaptive learning data for a specific document.
3. Select the knowledgebase if you are looking for the adaptive learning data for a specific
knowledgebase.
4. Type the phrase if you are looking for the adaptive learning data for a specific phrase.
5. Click Search.
Note: You can provide the search parameters for adaptive learning in various combinations to
narrow or enlarge your search for adaptive data.
While creating or updating an Interaction, Incident, or Problem record, you can search for a solution to
assist in solving your problem.
1. While creating or updating a record, click More or the More Actions icon, and then select Search
Knowledge.
The search uses the mapped fields to display a search results list of possible similar records or
other knowledge documents.
3. Use the results from your search to determine how to proceed. For example, you can view another
record from the search results or use the data from the search to update the record you are working
on.
1. While you are processing a record, perform a knowledgebase search to find a solution.
2. In the knowledgebase search results, click the hyperlink to view a solution document.
3. When you find a document with the correct solution, click Use Solution to add the solution to the
resolution or workaround field of the record. The Use Solution button only appears if the selected
document contains a resolution or workaround.
Note: If the knowledge document is a working copy of an approved published document, the
display option, Show Approved Version, appears, which enables you to view the published
document and then select it as a solution.
4. After you select Use Solution, the system redisplays the record with the resolution or workaround
field updated. You can continue processing the Interaction, Incident, or Problem record that
prompted your knowledgebase search.
When adaptive learning is enabled, data about the queries that returned documents that were used for
solving issues is stored and integrated into the documents when they are indexed.
Note: You must have a KCS II or KCS III profile to view adaptive learning data, and a KM ADMIN
profile to view or edit adaptive learning data.
To view adaptive learning data for published documents by searching for a phrase, follow these steps:
2. Type a word or phrase related to the information you are searching for.
3. Click Search.
4. Click the hyper-linked field to open a specific document when a list of search results appears. The
hyper-linked field is usually the title or other document identifier.
Note: The Adaptive Learning button only appears if the document is from an sclib-type
knowledgebase.
6. You can now view or edit the adaptive learning data for the document you selected, depending
upon your profile.
To view adaptive learning data for published documents by using the Published Documents list,
follow these steps:
4. You can now view or edit the adaptive learning data for the document you selected, depending
upon your profile.
You can search knowledgebases to determine if your current issue matches any existing incidents or
problems with known solutions or workarounds. When located, you can print out those documents.
To print a knowledge document using the Windows client, follow these steps:
1. Display the document you want to print in the Knowledge Management Document Viewer.
3. Click Detail.
4. Click OK.
6. If you selected Print Preview, you can print the document from the Print Preview window. Click
the Print icon, select a printer, and then click Print.
You can search knowledgebases to determine if your current issue matches any existing incidents or
problems with known solutions or workarounds. When located, you can print out those documents.
To print a knowledge document using the web client, follow these steps:
1. Display the document you want to print in the Knowledge Management Document Viewer.
The process is performed by the Knowledge Contributor, Knowledge Analyst, Knowledge Expert, or
Knowledge Manager.
Before you can retire a document, the system verifies that there are no published documents that link to
the document you want to retire. If the system finds documents with links to the document you want to
retire, it alerts you to this situation and gives you the option of putting these documents into the
document workflow to review and update.
1. Before retiring a document, make sure to update any documents that link to the document you
wish to retire.
3. Click Search.
4. Select the document that you wish to retire from the list of documents.
5. Click Retire.
Before you can retire a document, the system verifies that there are no published documents that link to
the document you want to retire. If the system finds documents with links to the document you want to
retire, it alerts you to this situation and gives you the option of putting these documents into the
document workflow to review and update.
Note: The alert message includes the document IDs of the documents that need to be updated
and placed in the Pending Documents queue. If you click OK, it then places those documents in
the Pending Documents queue.
To retire a knowledge document when other documents link to it, follow these steps:
1. Review the Pending Documents queue and select the documents for editing. You can identify
the documents by the document ID, which appears in the title column of the list of document
changes in the Pending Documents queue. These documents also have a standard feedback
message: "This document links to another document (KMnnn) that was attempted to be retired.
Please review now." added by the system.
2. From the Pending Documents queue, you can edit each document to remove any links to
documents you want to retire, and then publish the edited document.
3. Return to the Published Documents list and select the document you want to retire.
4. Click Retire.
A user with a KM ADMIN profile can view and unretire a document that does not have a category
associated with it. If the KM ADMIN unretires a retired document without a category, the document is
put in the workflow as a draft document.
3. Click Unretire.
l Environment
l Knowledge groups
l Profiles
Rights to the Knowledge Management administration functions are controlled by the Knowledge
Administration security area. To perform these functions, users must belong to a security role that has
rights in this area.
Knowledge Management administrators can also use the security profiles to provide users different
capabilities in the knowledge document workflow. You can use the security profile to set which users
can edit, approve, and author knowledge documents.
Document types are templates for documents in Knowledge Management. Knowledge Management
includes several default document types. These include Question/Answer, Problem-Solution,
Reference, Error Message/Cause, and External. These default document types provide the basic
structure for new document types that you can create. If you later delete your customized document
types, the default document types retain their basic features.
For example, you can use Forms Designer to create a document type called Payroll Error based on
the out-of-box document type, Error Message/Cause. When there is an error in processing payroll, the
staff uses this Payroll Error form to write up the problem.
l Change the Error Message tab to Error and the error message field to Error. Users describe the
error in this field.
l Change the Cause tab to Problem and the cause field to Problem. Users describe the underlying
problem that caused the error in this field.
l Change the Workaround / Fix tab to Solution and the fix field to Solution. Users provide a
solution to the problem.
l Use the default document view for Error Message/Cause to create at least one document view for
this document type.
Document views have two purposes. Document views provide users a way to customize how the
information displays in each form and to limit users to see only information that their group permission
allows them to see. This way, users with different permissions view the same document records, but
only those users with certain permissions can view sensitive information in certain fields of the record.
You can manage the documents in your knowledgebase by effectively using document types and
groups. You can add new views to existing document types and then control the access to these views
by selecting only certain document groups. You can also add new document types to the standard
document types provided by the system.
Tip: You can add document types and document views for users by copying the out-of-box
templates for document types and views.
To add document types, you must log in with a user profile that has either the System Administrator or
Knowledge Administrator role.
If you add a new rich-text field to the kmdocument table, add it to the dbdict and to the document views
that will display the new field.
In order for three of the buttons on the rich-text editor for this new field to work properly, also create
three displayoption records for the kmdocument.open displayscreen and three for the
kmdocument.view displayscreen.
l Insert Image
For more information, see the existing displayoption records in the kmdocument.open displayscreen.
For example, 555, 556, and 557. Note that:
l the Condition is
$L.preview="false"
l on the Rad tab and Pre Rad Expressions tab in all three displayoption records, the field name is
set as follows:
$kminsertlinkfieldname="error"
Also,if your new field name was comments, for example, then you would create the three
displayoption records and set the following on the Rad tab and Pre Rad Expressions tab in the three
new displayoption records:
$kminsertlinkfieldname="comments"
Users with a KM ADM profile can add, delete, and modify document views. Use the document view
editor to add a new view or modify an existing document view. When you add a new document view or
modify an existing view, you should select the user profiles that you want to have access to the
document view.
With good planning in combination with well-defined user profiles and document views, you can
manage access to knowledge documents so that users are able to view the knowledge documents or
portions of the knowledge documents they need to perform their job. At the same time you can maintain
control over which users are able to access knowledge documents or sensitive information in a
knowledge document.
Typically, you create a new document view by modifying an existing document view and then
assigning it a new name when you save the new document view.
use rich text formatting to distinguish the label from the contents of the field. When the system displays
a document in a particular document view, it applies the formatting you specified for each rich text field.
In addition, document views also include a marker (*SCKM*) that a document parser uses when
rendering a document to replace the field name marked by *SCKM* with data from the file for the
specified field.
A group permission is formed by the association of a document view with a knowledge group. Each
document view has a security level and one or more groups associated with it. Zero (0) is the lowest
security level. Each document view for a document type must have a unique security level. You should
assign a higher number to the security level for those document views with higher security
requirements. Assign security level values relative to the other security level values of the other
document views for a document type.
A document view determines how the document displays to a user. Document views are associated
with document types. Each document type has a default document view, and each document type
must have at least one document view associated with it.
Note: In some cases, before creating a new document view you will need to add a field or fields to
the database and use Forms Designer to create new forms or to update existing forms. Before
beginning these procedures, you should be familiar with the information in the Database
Administration and Tailoring online help modules.
2. Click the document type for the document view you want to create.
3. Click a document view from the list of Associated Document Views that is similar to the
document view you want to create.
4. Click Modify.
8. Click Cancel.
9. Click New for the document views of the document type for which you want to create a new view.
12. Click the Source button to see the view as it will display.
For example, if you added a field called notes to the kmdocument table in dbdict and added a
Notes tab to the Error Message Cause form (kmdocument.errormsg), you can copy and paste
the last two lines in the document view:
<div class="formSectionHeading">Workaround/Fix</div>
*SCKM*fix*SCKM*
to make a new section Heading "Notes" that contains the new "Notes" field:
<div class="formSectionHeading">Notes</div>
*SCKM*notes*SCKM*
15. To insert a field in the view, position your cursor in the rich text editor window at the location where
you want the field to appear on the form or select the field you are replacing and click the Insert a
Field Reference icon.
18. You can use the formatting features of the editing tool to format the appearance of the field label
and its position in the form.
19. Repeat adding or modifying the fields on the document view as required.
20. Click the Groups tab and select the document groups that can use this document view.
Knowledge groups enable you to collect users into groups that have access to work with the same set
of documents. A knowledge group might be the user for a department, a group of document authors, or
a special group of users within your organization, such as subject matter experts.
3. Select the document view from the list of Associated Document Views.
4. Click Modify.
6. Click in the next blank line of the Specify the knowledge user groups that can access this
view section.
8. Click OK.
9. Click Save.
System Administrator
In addition to creating new document views, administrators can configure the labels for the document
view to display in languages other than English. The labels contain heading delimiters which the
systems uses to determine the label title. A label delimiter is in the form: *SCMSG*123*SCMSG*
where the number between the replacement tokens identifies the message string in knowledge
management scmessage table. When the document displays, the system replaces the message
number token (123) and the delimiters with the appropriate string from the scmessage table.
A document view must be multilingual enabled before you can create multilingual labels. A document
view is multilingual enabled when you place the delimiter *SCMSG*123*SCMSG* in the label of the
document view form using the document view editor. The default view is multilingual capable for all
document types.
To configure the document views to display in languages other than English, you need to add additional
message strings in the scmessage table. In doing this you provide the class km message identifier (a
unique message number), the actual message string you want to display and a language code. For
each language, create a new record with the same message number but the language code will be
different and the message text will be the same word(s) in the appropriate language. Repeat the
process for each label that needs to be multilingual. Ensure each set that represents a single label
value has a unique message identifier.
Once new records exist in the scmessage table, replace the tokens in the label heading delimiter with
the message number created in the scmessage table for the appropriate message text string.
Note: The default view for all out-of-box document types is multilingual capable.
This procedure is for a document view that is not multilingual enabled. Before you begin, make sure that
you create a message number ID for each multilingual label on the document view form and that there
are message numbers defined to display the labels in multiple languages.
4. Click Modify.
5. Select the item to update and then select the label delimiter (*SCKM*Title*SCKM*) and replace it
with the label delimiter (*SCMSG*123*SCMSG*) for the label you are making multilingual. The 123
should be the message number ID from the scmessage table for the unique message number ID
for this label.
6. Continue updating the other labels with delimiters for multilingual labels.
You must also create at least one document view for the new document type. You can do this after you
have created the new document type, but the document type will not be usable until you create at least
one document view for the document type.
The Manage Shared Content function helps you to manage your system-managed shared content by
providing a search function, an add function, delete function, and a save function. Shared content
cannot be updated. If you need to modify a file being used as shared content, you should rename the
file, make the changes and then add it as a new file. You can then delete the original file.
All shared content is assigned an ID by the system. You can assign it a name and description when
you are adding it to the system. Each shared content item must have a unique ID, which means that
you can only add one item of shared content for each ID.
In Knowledge Management, shared content can be a file that is shared by many document views. This
type of content is referred to as system-managed shared content. Examples of this type of shared
content are an image file used as a logo on the document view or a text file, such as a copyright notice
or license agreement.
n For Windows clients: Right-click in the Select a single attachment below to add to system-
managed shared content field, click Add, browse to the file, and then click Open.
5. Click Save.
6. Click OK.
Knowledge groups
Knowledge groups enable you to collect users into groups that have access to work with the same set
of documents. A knowledge group might be the user for a department, or a group of document authors,
or a special group of users within your organization such as subject matter experts. All knowledge
groups have a unique name, an assigned manager, and a group of operators.
You associate a knowledge group with at least one document category or subcategory to give the
members of a knowledge group access to documents in the category or subcategory and all
subcategories below it. Access privileges can range from search and view to publishing privileges
depending upon what knowledge profile(s) you assign to the category. You assign a knowledge group
access to a document category by associating a knowledge profile and its associated knowledge group
with a document category.
You should assign a new user to the appropriate knowledge groups when you create an operator record
for the user. You can use the Find Related Information icon on the Login Profiles tab of the Operator
record form under Knowledge Groups to display a list of defined knowledge groups.
The Default Knowledge View Group is a convenient way to associate all the users in the system
with a uniform set of permissions on a document category. For example, if you wanted all the externally
published documents under the Human Resources category to be viewable by all users, you could
associate the Default Knowledge View Group and the DEFAULT profile with that category.
In the out-of-box system, each document type has a default document view and this default document
view has the Default Knowledge View Group assigned to it. This means that if a user has access to
the category the document is in, that user can view the document with the default view if there are no
other document views available to that user to view the document. However, because the default view
has the lowest security level, if another view is available to the user then the higher security view is the
view the system uses. By associating the Default Knowledge View Group with each of the
document types, there can never be a case where there is a document in that system that cannot be
viewed.
The Default Knowledge View Group has a unique ID in the system, so that if the name is changed,
the capabilities of the group persists. This means that if you choose to rename this group, the
capabilities of the group do not change. All of the users in the system can still view all of the documents
in those categories to which this group has access.
Knowledge groups enable you to collect users into groups that have access to work with the same set
of documents. A knowledge group might be the user for a department, a group of document authors, or
a special group of users within your organization, such as subject matter experts.
2. Click Search.
Only a user with a KM ADMIN profile or the System Administrator can add users to knowledge groups.
There are two methods for adding a user to a knowledge group.
l In the operator record, on the Login Profiles tab there is a Knowledge Group section for the
system administrator to specify the knowledge groups for the user.
l The Knowledge Management > Administration > Knowledge Groups function allows a user
with a KM ADMIN profile to add users to a knowledge group.
To add a user to a knowledge group in the operator record, follow these steps:
2. Click Search.
3. Select an operator.
5. In the Knowledge Groups section use the Fill icon to display a list of the knowledge groups.
7. Click Save.
8. Click OK.
To use the Knowledge Group function to add a user to a knowledge group, follow these steps:
4. Type the name of the user in the Operators section, or use the Find or Fill button to locate the user.
5. Click Save.
6. Click OK.
7. Repeat steps 2 to 6 until you have added the user to all of the appropriate knowledge groups.
Knowledge groups enable you to collect users into groups that have access to work with the same set
of documents. A knowledge group might be the user for a department, a group of document authors, or
a special group of users within your organization, such as subject matter experts.
3. Type the name of the manager of the knowledge group in Manager Name.
4. Type the names of the members of the knowledge group in the Operators area.
5. Click Add.
2. Click Search.
4. Click Copy/Rename.
7. Click Finish.
8. Type a new name of the manager of the knowledge group or keep the current manager.
9. Type the names of the members of the knowledge group or keep the current members in the
Operators area.
All documents in the knowledgebase are assigned to a document category. Categories for knowledge
documents are ordered hierarchies. The document categories order documents into top-level
categories and subcategories. You can assign a knowledge group access to a specific category.
2. When you have a large number of top-level categories, use the category filter to display only those
top-level categories you are interested in viewing. Type the name of the top-level category in the
Category filter text box.
3. Use the Category Search tab to search a list of all occurrences of a category or subcategory
name. You can type the complete name of the category or subcategory you are searching for, or
you can type a portion of the name in the Search box. For example, if you are searching for all test
categories, you might type tes to see test, test1, and testall.
7. Select the user profile for the knowledge group to which you want to assign access to the category
you selected.
9. Select the knowledge group you want to assign to the document category.
To view which knowledge groups have access to a document category, follow these steps:
2. When you have a large number of top-level categories, use the category filter to display only those
top-level categories you are interested in viewing. Type the name of the top-level category in the
Category filter text box.
3. Use the Category Search tab to search a list of all occurrences of a category or subcategory
name. You can type the complete name of the category or subcategory you are searching for, or
you can type a portion of the name in the Search text box. For example, if you were searching for
all test categories you might type tes to see test, test1, and testall.
System Administrator
To assign rights for publishing a document for a document category, follow these steps:
1. Identify the document category or categories to which you want to assign the document.
2. Identify the knowledge management profile and document group that have publishing privileges for
the category or categories.
3. Make sure that the users who will have the document publishing rights are members of the
appropriate document group.
For example, to give a user the ability to publish documents for external users in HR category for the
out-of-box system, you would make the user a member of the HR KCS III document group.
Animal > Dog > Retriever or Category > subcategory > subcategory
For a top-level category, the level in the hierarchy is always zero (0).
A category and subcategory has associated with it a set of permissions. These permissions specify
the profiles and knowledge groups that have access to the category or subcategory. When a profile and
knowledge group is given access to a category or subcategory that profile and knowledge group also
has access to all of the subcategories below that point in the hierarchy.
If there are any published documents assigned to the category, they cannot be deleted. You cannot
delete a document category before deleting a category. Assign any of the published documents to
another document category. You can delete a document category if there are only retired documents
assigned to the category. If you decide to unretire those documents, a KM Admin will provide a new
document category for the document as part of the unretire process.
Documents cannot be managed in the knowledge management system without an assigned category
because the Knowledge Management uses document categories to control access to the knowledge
documents. All published documents and pending documents must have a category associated with
them. Draft and retired documents do not require an assigned category.
A user with a KM ADMIN profile can view and unretire a document that does not have a category
associated with it. If the KM ADMIN unretires a retired document without a category, the document is
put in the workflow as a draft document.
When you unretire a document that has at least one category associated with it, the system puts the
document into the workflow as a pending document.
All documents in the knowledgebase are assigned to a document category. Categories for knowledge
documents are ordered into hierarchies. The document categories order documents into top-level
categories and subcategories. A top-level category is a parent category of the subcategory immediately
below it in the ordered list of categories.
2. Click New.
4. Click Add.
5. Click Save.
All documents in the knowledgebase are assigned to a document category. The document categories
order documents into top-level categories and subcategories. Each subcategory has a parent category
that is the category immediately above it in the ordered list of categories.
5. Click Add.
6. You can continue adding subcategories by clicking New Subcategory, or you can begin to
specify permissions for the subcategories.
8. Click OK.
2. Double-click a top-level category or search for a subcategory to display the category for which you
are adding permissions.
4. Click Add.
5. Select a knowledge group from the list, and then double-click the knowledge group you select.
6. Select a profile from the list, and then double-click the profile you select.
8. When you are finished adding permissions, click the Permissions tab to verify your selections.
9. Click Save.
System Administrator
You can make all externally published documents associated with a single document category (such
as Human Resources) to be viewable by all users.
5. Double-click HR.
9. Select and then double-click the DEFAULT profile. In the out-of-box system, the DEFAULT
profile is set to search external access.
Note: If you want all users to be automatically included in the Default Knowledge View Group,
make sure to select the Assign the Default Knowledge Group to all operators check box in
the Knowledge Management Application Environment form.
You can use this form to view and update the environment settings, including assigning default
knowledge to all operators who have permission to search knowledge and use adaptive learning to
weight search results based on usage.
Note: Whenever you make changes to the Knowledge Management environment, all users must
log out of HP Service Manager and then log back in for the changes to be visible and in effect.
Before you can use Knowledge Management and the search engine, you must configure settings. The
Knowledge Management Environment record allows you to set up connectivity and define options,
such as enabling adaptive learning and setting the number of documents to be returned from a search.
This record contains default settings. However, you can configure these settings to meet your
business needs.
To configure the Knowledge Management application environment settings, follow these steps:
n System Administration > Ongoing Maintenance > Environment Records > Knowledge
Management Environment
2. Select new options or clear default options. Your changes redefine the Knowledge Management
The Assign the Default Knowledge View Group to all operators option ensures that all
operators who will have permission to search knowledge are able to view any documents in those
document categories to which the default knowledge view group has access.
The Use Adaptive Learning to enhance search results option enables Service Manager to
weight search results based on usage. You can artificially weight documents using Adaptive
Learning by adding a phrase and adding a number of occurrences with the phrase to specify that
the term or phrase occurs in the document a specified number of times. If the phrase is not literally
present, this can have the effect of putting the phrase, or word, in the document. It also simulates
the number of times the phrase is added to the document index, based on the quantity you choose
to apply.
n When you disable Adaptive Learning, you need to go to the "Manage Knowledgebases"
screen and reindex all knowledgebases of type sclib.
4. Specify the Default expiration period of time a document should be stored in the document
queue before it expires.
Note: The time period specified here will be over-ridden if an expiration date was specified
when the document was created using the Contribute Knowledge function.
6. When you have finished making your changes, click Save and OK.
7. Log out of Service Manager and then log back in again for your changes to take effect.
Caution: When these fields are not set correctly and a user attempts to access a
knowledgebase, the Manage Knowledgebase form displays an error, stating that the search
engine is incorrect or not found, and asks you to check the environment settings.
Knowledgebase configuration
Knowledgebase configuration includes the following tasks:
l Reindexing a knowledgebase
Note: To configure the KM Solr Search Engine and Nutch Web Crawler, you should be an
experienced System Administrator who is familiar with your installation.
For detailed information, see the Service Manager Knowledge Management Search Engine Guide,
which is available in both PDF and online help formats.
Hitlist configuration
As part of knowledgebase configuration, you can configure a hitlist to display search results of a
particular format, and selected fields in knowledge documents. When formatting a hitlist, you can
specify the labels for the fields you want to display and the style class of the each label.
Note: A hitlist only displays search results for knowledge documents in categories to which the
user has access.
The Fields text box on the Configure Hitlist form lists the available out-of-box fields. The fields
available for use in a hitlist are defined by the field definitions specified for the knowledgebase. These
definitions are specified as part of the knowledgebase management and maintenance function. If you
want the field available for the hitlist, you must specify true for the hitlist parameter of the field
definition.
Note: Currently, Knowledge Management supports two hitlist templates, Default and Hotnews.
You can rename these out-of-box templates reconfigure them based on the fields available. To add
a new hitlist template, you must also add supporting code in the kmsearch script to make the new
hitlist template active.
l $DOCUMENT_RANK - This is the order of the search results, based on the score the item received
by the search engine. The item with the highest score has a rank of 1.
Multilingual hitlists
A hitlist must be multilingual-enabled before you can create multilingual labels. A hitlist is multilingual-
enabled when you place the label delimiter *SCMSG*123*SCMSG* in the heading text box on the
Configure hitlist form. The default hitlist is multilingual-capable in the out-of-box system.
Labels
In addition to modifying the default hitlist to display different fields, administrators can configure labels
for a hitlist to display in languages other than English. For the default hitlist, each label contains a label
delimiter, which the system uses to determine the label to display. A label delimiter is in the form:
*SCMSG*123*SCMSG* where the number between the replacement tokens identifies the message
string in Knowledge Management scmessages table. When the hitlist displays, the system replaces
the token (123) and the delimiters with the applicable string from the scmessage table.
scmessage table
To configure the hitlist to display in languages other than English, you need to add additional message
strings in the scmessage table. This provides a message identifier (unique message number), the
actual message string you want to display, and a language code. For each language, create a new
record with the same message number. The language code will be different, but the message text will
be the same in the applicable language. Repeat the process for each label that needs to be multilingual.
Ensure each set that represents a single label value has a unique message identifier.
Once new records exist in the scmessage table, replace the tokens in the label delimiter with the
message number created in the scmessage table for the applicable message text string.
System Administrator
Note: After you create a new message, use the Message ID to update the
label field for the hitlist you want to be multilingual.
Use this procedure to add a new message (token), which makes a label multilingual:
3. Click Search.
5. Add a new record where the class is km, the language code is the language of the string being
added, the Message ID is unique within the class, and the text string is the text you want to
display in the label of the hitlist.
6. Make a note of the Message ID number. You will need it to update the label field and when you
add the text strings for the other languages you want to use for this hitlist label.
Use this procedure to add message text in an additional language for an existing message ID:
3. Click Search.
4. Review the list of existing km-related system messages to find the message number of the
message for which you want to add the new language text.
5. Add a new record where the class is km, the language code is the language of the string being
added, the Message ID matches the Message ID of the label token for this language, and the text
string is the text in the language you want to display in the label of the hitlist.
System Administrator
In addition to creating new document views, administrators can configure the labels for the document
view to display in languages other than English.
Note: This procedure is for a hitlist that is not multilingual-enabled. Before you
begin, make sure you create a message number ID for each multilingual label
and that the message number is defined to display labels in multiple
languages.
2. Click Search.
4. Type the label delimiter (*SCMSG*123*SCMSG*) in the Label field for the label you are making
multilingual. The 123 should be the message number ID from the scmessage table for the unique
message number ID for this label.
5. Continue adding additional label delimiters for each of the multilingual labels in the hitlist.
6. Click Save.
l Draft
l Triage
l Revise
l Review
l Publish
l Published Internal
l Published External
l Retired
When a user submits a document for approval, the document enters the workflow in the Triage phase.
In a typical document workflow, the document is routed to the Revise, Review, and Publish phases
before it is actually published internally or externally. In some cases, users with applicable access
rights can publish a document immediately after creating it, without going through the formal Revise
and Review phases.
Note: When you need to update a knowledge document attachment, you must save the
attachment to your desktop, make the necessary updates, save the changes, and then re-upload
the attachment to the knowledge document.
Knowledge Management uses knowledge groups and document categories to control access to
knowledge documents along with document view and Knowledge Management profiles. Individual
users are able to view, contribute, edit, and publish documents based on the knowledge groups in
which they are members and the security mappings between the knowledge groups, knowledge
profiles, and knowledge categories.
KM Document records are created with an applicable status, based on the current phase of the Change
Management records. The mapping is described in the following table.
KM 1 Triage Triage
KM 2 Revise Revise
KM 4 Conclude Conclude
Two fields are also mapped from a Change Management record to a Knowledge Management
document, as described in the following table.
assigned.to assignedEditor
Coordinator documentOwner
Another functionality is included in the upgrade script. Operators with the capability word “SysAdmin” or
“KMAdmin” will have a security role in their operator record as System Administrator and Knowledge
Administrator.
Note: When using the new Process Designer workflow, the following applies:
l All open change records of category ‘KM Document’ close with the completion code
‘1’ – Successful.
l The corresponding KM document status changes from working copy to the status based on the
current phase of the change record.
The KMMigrate script imports the data exported from Get-Answers into Service Manager. The script
wsdl2java.bat or wsdl2java.sh imports documents into the Knowledge Management tables in Service
Manager. The script library file KMSCCoreImport imports data from the core table in Service Manager
to the kmdocument table in the Knowledge Management application. This import migrates the
IRExpert knowledge documents from previous versions of HP ServiceCenter.
To run the Knowledge Management migration utilities, you need a working knowledge of Service
Manager. To modify these utilities you need a working knowledge of Get-Answers, Service Manager
applications, and JavaScript.
1. Review the information described in "General considerations for importing documents" on page 70
and ensure that all listed considerations are being adhered to.
2. Ensure that the XML source document file conforms to the requirements described in "XML source
Note: The data in the Rich Text fields must be XHTML formatted.
There is no DTD for the XML data being imported because the elements can be any column name in
any Service Manager table. This XML file specification is important if you edit the XML files to include
any customized fields that you might have added and you want to import to the Knowledge
Management application in Service Manager.
All required fields must be defined for a table element, or the imported records cannot be inserted into
the Service Manager database. The records can all be in the same file or in separate files. For example,
the multiple usersAndContactsN.xml files can each hold 1000 users.
The root document element is <migrationdoc> and it must be the parent element of all table elements
and record elements.
<migrationdoc>
.
.
.
</migrationdoc>
Each element tag within the <migrationdoc> tag must be the name of a Service Management table.
<migrationdoc>
<contacts>
<contact.name _type="Text"><![CDATA[owner,otto]]></contact.name>
<user.id _type="Text"><![CDATA[1296]]></user.id>
<full.name _type="Text"><![CDATA[owner,otto]]></full.name>
<email _type="Text"><![CDATA[[email protected]]]></email>
<contact.phone _type="Text"><![CDATA[858.792.3416]]></contact.phone>
<operator.id _type="Text"><![CDATA[oowner]]></operator.id>
</contacts>
.
.
.
</migrationdoc>
Each element within the table element must be the name of a text, boolean, or decimal data field or the
name of an Array or ArrayStructure in the record. A data field has an attribute of _type="Text", _
type="Boolean", or _type="Decimal".
The actual data value can be enclosed in a CDATA tag.
<email _type="Text"><![CDATA[[email protected]]]></email>
<login.revoked_type="Boolean"><![CDATA[false]]></login.revoked>
<msglog.lvl _type="Decimal"><![CDATA[1]]></msglog.lvl>
The actual data value can also appear as plain text, if it has no special characters in it.
<email _type="Text">[email protected]</email>
<login.revoked _type="Boolean">false</login.revoked>
<msglog.lvl _type="Decimal">1</msglog.lvl>
An element within a table that is an Array is imported into the kmgroup table as follows:
<operators _type="Array">
<operators _type="Text"><![CDATA[jowens]]></operators>
<operators _type="Text"><![CDATA[rtillman]]></operators>
<operators _type="Text"><![CDATA[ssmith]]></operators>
</operators>
An element within a table that is an ArrayStructure is imported into the kmcategory table as follows:
<permission _type="ArrayStructure">
<kmprofile _type="Text"><![CDATA[KMP005]]></kmprofile>
<kmgroup _type="Text"><![CDATA[KMG02]]></kmgroup>
</permission>
// This script imports the XML files created by the Get-Answers ExportData utility.
// For every usersAndContactsN.xml file that was exported, add a line for that
file. system.library.KMMigrate.migrate("C:/exportdata/usersAndContacts1.xml",
system.library.KMMigrate.migrate("C:/exportdata/groups.xml", "kmFile =
system.library.KMMigrate.preprocessScript( node, kmFile );");
system.library.KMMigrate.migrate("C:/exportdata/categories.xml", "kmFile =
system.library.KMMigrate.preprocessScript( node, kmFile );");
system.library.KMMigrate.migrate("C:/exportdata/doctypes.xml", "kmFile =
system.library.KMMigrate.preprocessScript( node, kmFile );");
l usersAndContactsN.xml
l groups.xml
l categories.xml
l doctypes.xml
The usersAndContactsN.xml file contains contact and operator records similar to the following.
<migrationdoc>
<contacts>
<contact.name _type="Text"><![CDATA[owner,otto]]>
</contact.name>
<user.id _type="Text"><![CDATA[1296]]></user.id>
<full.name _type="Text"><![CDATA[owner, otto]]></full.name>
<email _type="Text"><![CDATA[[email protected]]]></email>
<contact.phone _type="Text">
<![CDATA[858792.3416]]></contact.phone>
<operator.id _type="Text"><![CDATA[oowner]]></operator.id>
</contacts>
<operator>
<application.name_type="Text">
<![CDATA[menu.manager]]></application.name>
<command _type="Boolean"><![CDATA[true]]></command>
<company _type="Text"><![CDATA[PRGN]]></company>
<contact.name _type="Text">
<![CDATA[Tremain, Johnny]]></contact.name>
<email _type="Text"><![CDATA[[email protected]]]></email>
<ess.access.only _type="Boolean">
<![CDATA[false]]></ess.access.only>
<expire.password _type="Boolean">
<![CDATA[false]]></expire.password>
<full.name _type="Text"><![CDATA[Tremain, Johnny]]>
</full.name>
<locked.reason _type="Decimal"><![CDATA[0]]>
</locked.reason>
<login.revoked _type="Boolean"><![CDATA[false]]>
</login.revoked>
<msglog.lvl _type="Decimal"><![CDATA[1]]></msglog.lvl>
<name _type="Text"><![CDATA[johnny]]></name>
<names _type="Array">
<names _type="Text"><![CDATA[name]]></names>
<names _type="Text"><![CDATA[string1]]></names>
</names>
<no.lock.user _type="Boolean"><![CDATA[true]]>
</no.lock.user>
<password _type="Text"><![CDATA[johnny]]></password>
<profile.change _type="Array">
<profile.change _type="Text">
<![CDATA[KM COORDINATOR]]></profile.change>
</profile.change>
<values _type="Array">
<values _type="Text"><![CDATA[MAIN MENU]]></values>
<values _type="Text"><![CDATA[HOME]]></values>
</values>
</operator>
.
.
.
</migrationdoc>
<migrationdoc>
<kmgroup>
<id _type="Text"><![CDATA[KMGM01311]]></id>
<name _type="Text"><![CDATA[HR Owner Group]]></name>
<operators _type="Array">
<operators _type="Text"><![CDATA[jowens]]></operators>
<operators _type="Text"><![CDATA[rtillman]]>
</operators>
<operators _type="Text"><![CDATA[ssmith]]></operators>
</operators>
</kmgroup>
.
.
.
</migrationdoc>
The categories.xml file contains kmcategory records similar to the following record. Note that the id in
this sample record is KM42T and ends with a "T". Each id in the kmcategory table must end with a
unique character such as "T" because the search engine logic depends on having a category id with a
unique delimiter to determine where one category id ends and the next category id begins.
<migrationdoc>
<kmcategory>
<level.in.hierarchy _type="Decimal">0</level.in.hierarchy>
<name _type="Text">HR Employment FAQs</name>
<id _type="Text">KM42T</id>
<permission _type="ArrayStructure">
<kmprofile _type="Text">KMP005</kmprofile>
<kmgroup _type="Text">KMG02</kmgroup>
</permission>
<permission _type="ArrayStructure">
<kmprofile _type="Text">KMP002</kmprofile>
<kmgroup _type="Text">KMG011</kmgroup>
</permission>
<permission _type="ArrayStructure">
<kmprofile _type="Text">KMP001</kmprofile>
<kmgroup _type="Text">KMG012</kmgroup>
</permission>
</kmcategory>
.
.
.
</migrationdoc>
<migrationdoc>
<kmdoctype>
<name _type="Text"><![CDATA[errormsg]]></name>
<description _type="Text"><![CDATA[Description of an error
message</description>
<display.name _type="Text"><![CDATA[Error Message/
Cause]]></display.name>
<format.edit _type="Text"><![CDATA[kmdocument.errormsg]]>
</format.edit>
<format.new _type="Text"><![CDATA[kmdocument.errormsg]]>
</format.new>
<format.view _type="Array">
<format.view _type="ArrayStructure">
<view.data _type="Text"><![CDATA[<table style=]>
</view.data>
<view.description _type="Text"><![CDATA[This is the
Default ]]></view.description>
<view.seclevel _type="Decimal"><![CDATA[60]]>
</view.seclevel>
<view.name _type="Text"><!
[CDATA[Default ErrMsgCauseView]]></view.name>
<view.roles _type="Array">
<view.roles _type="Text"><![CDATA[KMGM010]]>
</view.roles>
</view.roles>
</format.view>
</format.view>
</kmdoctype>
.
.
.
</migrationdoc>
l If the Service Manager license does not include SOAP API license, the sm.ini file needs to include
the following parameter: allowwsdlretrieval:1.
l Set refresh interval in the Knowledge_Library to -1 to turn off incremental updates during a large
import.
l HP recommends using a <Legacyid> element. The value of this element should be unique across
ALL documents. If <Legacyid> is specified, the import queries the kmdocument table for the
legacyid. If an existing record in kmdocument contains a legacyid matching the value in the
<Legacyid> element of the source xml, the kmdocument record is updated with the information in
the source xml. If no existing record in kmdocument is found with a legacyid matching the value in
the <Legacyid> element, the xml source is inserted as a new kmdocument.
l Elements in the source xml files must have corresponding fields in the kmdocument table in Service
Manager (the kmdocument record in the dbdict table), and they must be included in the Web
services API.
l Fields that are in a document xml file that are not in the dbdict are omitted on import, but the
documents are imported.
l Elements with data containing HTML markup or any special characters that are illegal in XML
should be CDATA wrapped to prevent the XML parser from throwing an exception.
l The source document may contain elements only at one level under the root element. Elements
containing child elements cause the import to fail.
l Source documents must contain a valid <DocType> element. Valid means the DocType value
must match an existing DocType (name field) in HP Service Manager.
l Source documents must contain a <Categories> element with a semicolon delimited string of
published (approved) categories. Categories to publish to are specified using XPATH format. For
example a document to be published to the "Incident Management" subcategory of the "Service
Manager" category would appear as follows:
<Categories> Service Manager/Incident Management</Categories>
Additional categories are appended and preceded by a semicolon;.
<Categories> Service Manager/Incident Management ;anothercategory;</Categories>
l When migrating from Get-Answers, import the categories.xml and doctypes.xml files first. If you
import document first, categories, whether in a <Categories> field or by sub-folder name, that do not
exist will be created. The created category ID will not match the ID of categories imported (with
categories.xml) AFTER the documents are imported, and the category security will not be
migrated if you import document first. Likewise, a document type will not match the migrated types
if doctypes.xml is not imported before documents.
l Elements with data containing HTML markup or any special characters that are illegal in XML
should be CDATA wrapped to prevent the XML parser from throwing an exception.
l XML source documents that contain meta data for an "external" DocType must also contain a
<ExternalDocumentName> element that contains the file name of the external document used as
the document body. This file must reside in the same directory as the XML file that references it.
l When using the kmimport utility to reimport an external document, the external document name
must remain the same as the original. Also, any attachments must keep the same name.
l If you have tailored the kmdocument dbdict, be sure to not include your tailored Array fields,
Structure fields, and Arrayed Structures fields in the source XML documents; otherwise the import
will fail.
l All attachments should be in an attachments folder under the XML source directory.
l Shared Content attachments should have the file name prefixed with "shared_" followed by a
unique string used as the legacyid for attachments followed by an underscore and the file name.
shared_<legacyId>_<filename>
Example:
shared_1234567890_Logo.jpg.
l Attachment links (shared or owned) in the source XML should have the format
href=/https/www.scribd.com/answers/attachments/1234567890 where 1234567890 is the legacyid of the attachment.
Embedded attachments should use src= instead of href=.
l Document owned attachments (that is, documents not shared) should have the file name prefixed
with a unique string used as the legacyid for attachments followed by an underscore and the file
name.
<legacyId>_<filename>
Example:
1234567890_Logo.jpg
System Administrator
To use the wsdl2java.bat file to import documents into HP Service Manager, you must first configure
the file as follows:
1. Set JAVA_HOME to your jdk directory. The jdk version must be listed in the support matrix.
See HP Support matrices on the Software Support Online site.
JAVA_HOME=C:/jdk1.5.0_01
SET SC_SERVER=localhost
SET SC_PORT=13080
SET CLASS_PATH=./lib/axis-1.2.jar;./lib/saaj-1.2.jar;./lib
/commons-logging-1.0.3.jar;./lib/jaxrpc-1.1.jar;./lib
/mail-1.3.2.jar;./lib/activation-1.0.2.jar;./lib
/commons-discovery-0.2.jar;./lib/wsdl4j-1.5.1.jar
System Administrator
To use the wsdl2java.sh file to import documents into HP Service Manager, you must first configure
the file as follows:
1. Set JAVA_HOME to your jdk directory. The jdk version must be listed in the support matrix. See
HP Support matrices on the Software Support Online site.
JAVA_HOME=/jdk1.5.0_01
SC_SERVER=localhost
SC_PORT=13080
SET CLASS_PATH=./lib/axis-1.2.jar;./lib/saaj-1.2.jar;./lib
/commons-logging-1.0.3.jar;./lib/jaxrpc-1.1.jar;./lib
/mail-1.3.2.jar;./lib/activation-1.0.2.jar;./lib
/commons-discovery-0.2.jar;./lib/wsdl4j-1.5.1.jar
l Compiles and jars the classes into libcenterpws.jar with the command, md classes
rd com /s /q
rd classes /s /q
l Compiles and jars the classes into lib/servicecenterpws.jar with the command, mkdr classes
rd -R com
rd -R classes
The runDocumentImport command file is run to import documents into HP Service Manager.
Documents successfully imported remain in the migration root directory and rejected documents are
placed in _rejects.
1. Set JAVA_HOME to your jdk directory. The version must be on the support matrix.
See HP Support matrices on the Software Support Online site.
SET JAVA_HOME=C:/jdk1.5.0_01
SET SC_SERVER=localhost
SET SC_PORT=13080
SET SC_USER=%1
SET SC_PASSWORD=%2
Note: Setting the user name and password to the batch file parameters means that you do not
need to store sensitive information in the batch file. The user must have the KMAdmin or
SysAdmin execute capability in order to import the documents.
For example, if SC_USER is rmorgan and SC_PASSWORD is pa$$w0rd, you can call
runDocumentImport.bat like this:
C:\> runDocumentImport.bat rmorgan pa$$w0rd
If no SC_USER or SC_PASSWORD is defined, the default user is falcon with a blank
password.
SET CLASS_PATH=./lib/activation-1.0.2.jar;./lib
/axis-1.2.jar;./lib/commons-discovery-0.2.jar;./lib
/commons-logging-1.0.3.jar;./lib
/jaxrpc-1.1.jar;./lib/kmimport.jar;./lib/log4j-1.2.8.jar;.
/lib/mail-1.3.2.jar;./lib/saaj-1.2.jar;./lib
/wsdl4j-1.5.1.jar;./lib/servicecenterpws.jar;
The runDocumentImport command file is run to import documents into HP Service Manager.
Documents successfully imported remain in the migration root directory and rejected documents are
placed in _rejects.
1. Set JAVA_HOME to your jdk directory. The version must be on the support matrix.
See HP Support matrices on the Software Support Online site.
SET JAVA_HOME=/jdk1.5.0_01
SET SC_SERVER=localhost
SET SC_PORT=13080
SET SC_USER=$1
SET SC_PASSWORD=$2
Note: Setting the user name and password to the batch file parameters means that you do not
need to store sensitive information in the batch file. The user must have the KMAdmin or
SysAdmin execute capability in order to import the documents.
For example, if SC_USER is rmorgan and SC_PASSWORD is pa$$w0rd, you can call
runDocumentImport.sh like this:
$runDocumentImport.sh rmorgan pa$$w0rd
If no SC_USER or SC_PASSWORD is defined, the default user is falcon with a blank
password.
MIGRATION_DOCS_DIR=/MigrationDocs
DOC_STATUS=internal
CLASS_PATH=./lib/activation-1.0.2.jar:./lib/axis-1.2.jar:.
/lib/commons-discovery-0.2.jar:./lib
/commons-logging-1.0.3.jar:./lib/jaxrpc-1.1.jar:./lib
/kmimport.jar:./lib/log4j-1.2.8.jar:./lib/mail-1.3.2.jar:.
/lib/saaj-1.2.jar:./lib/wsdl4j-1.5.1.jar:.
/lib/servicecenterpws.jar:
For Windows, unDocumentImport.bat executes the following statement to import the documents.
For UNIX, unDocumentImport.sh executes the following statement to import the documents.
Skipped files include any non-xml files that are left in the import folder. For example, an error such as
"org.xml.sax.SAXParseException: The content of elements must consist of well-formed
character data or markup." indicates that the XML probably contains special characters that could
not be parsed.
You can edit and correct the files that were skipped and re-run the import.
If the meta data for any imported file contains a field that was not defined in the kmdocument data
dictionary (dbdict), then this field's value was not imported. The log file lists any undefined fields. You
can add the field to the kmdocument dbdict and re-run the import to populate the field's value.
KMSCCoreImport utility
The utility KMSCCoreImport imports data from the core table in HP Service Manager to the kmdocument
table in the Knowledge Management application. This import migrates the IRExpert knowledge
documents from previous versions of HP ServiceCenter. By importing data from the core table used by
IRExpert, you make the data available to the Knowledge Management application.
The KMSCCoreImport utility is for a one-time transfer of all files from the core table into the Knowledge
Management application. If you run this code more than once, it imports duplicate data into the
Knowledge Management application.
You can edit KMSCCoreImport utility script to take into account any customizations of either the core
table or the data contained in the core table. The areas in the KMSCCoreImport script where changes
are allowed and expected are clearly marked. Also, those sections of the code that cannot be changed
are also commented accordingly.
l Back up the database before you run the script against the database.
l Rename the script to create a copy and then add the copy to the ScriptLibrary before you begin
modifying the script.
l Run the modified script against a copy of your database to verify that the script works correctly.
l Run the complete script in a test environment to verify the script and the resulting records.
To modify the KMSCCoreImport script, find the section of the script file that begins with the comment
"this is the section of the customized code where additional code should be added
..." then follow the instructions provided by these comments. Essentially, you need to map any fields
added to the out-of-box core table and update the field names.
//????????????????????????????????????????????????????????????????
//@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
//this is the section of the customized code where additional code
//should be added if the user so desires...the following are a few
//example lines of code
//NOTE: if a field name has a dot delimiter such as in entry.id, in
//javascript it has to be changed to an underscore as in
1. Locate the importCoreToKMNow function in the script. It is the single line of code at the bottom of
the script that calls the single function in the script file.
2. If the import is based on the out–of–box core table data then the parameter value for this call
should be true. This creates records of the Problem / Solution type.
importCoreToKMNow(true);
3. If the import is based on customized core table data then the parameter value should be false.
importCoreToKMNow(false);
4. With this parameter change, you can modify the document type to match a customized document
type. In the script, find the second occurrence of the line:
newKMDoc.doctype = "howto".
Change the doctype to match the name of your customized document type.
5. If you change the value of the parameter and update the doctype, save the file before continuing.
6. Click Execute. The script runs. You are notified when the process completes with the message,
"The import from the core table is complete".
l Starting at Service Desk, users responding to an Interaction record can search for similar
interaction records with solutions.
l Users updating Incident records can search for similar issues with solutions in the
knowledgebases.
l When working on Problem records, users can perform the following tasks:
n search for similar problems, incidents, known errors, or knowledge documents
n use the resolution from an existing resolved issue in a knowledgebase as a solution for the
problem
n use the information from a problem resolution to create a new knowledge document
The search results display a list of relevant documents. The user can view each document and then
has the option of using the text from one the documents as a resolution for the original Interaction
record. If the user chooses to use a solution, the system automatically populates the resolution field in
the Interaction record with data from the field mapped to the resolution field. The Use Solution option
is available from knowledge documents and knowledge candidates with a workaround or resolution.
Note: If the knowledge document is a working copy of a published document, the Use Solution
button does not appear because the system views it as a temporary document. However, you can
usually find the published version in the hitlist and use that as a solution.
In addition to searching for knowledge, the out-of-box mapping allows those users with appropriate
privileges to create solutions and author knowledge documents from resolved Interaction records. For
example, if in your search you find a knowledge document that includes in the description a resolution
for the call, you can select the Create Knowledge option to begin authoring a new knowledge
document. The field mappings for the knowledgebase determine which fields in the knowledge
document are populated with data from the record.
The search results display a list of relevant documents. The user can view each document and then
has the option of displaying and then using the text in one of the documents as a resolution to the
Incident record. If the user chooses to use a resolved record, the system automatically populates the
solution in the record based on the record mapping being reviewed for the knowledgebase. For
example, if in a search you find an Incident record that includes a resolution, you can use Use Solution
to copy the data from the resolution or workaround field to insert it into the solution (resolution field) of
the open Incident record.
You can use Create Knowledge to contribute a new knowledge document from a resolved Incident
record so that the data in the mapped fields is used in the knowledge document. The field mappings and
the document type determine which fields in the knowledge document are populated with data from the
resolved record.
Note: The Use Solution option is available from knowledge documents, Incident and Interaction
knowledge candidates with resolutions, and Known Error and Problem knowledge candidates with
workarounds.
l Use the resolution from an existing resolved issue in a knowledgebase as a solution for the problem
l Use the information from a problem resolution to create a new knowledge document
When searching for knowledge, Knowledge Management uses the fields mapped in the Integration
Mapping function for searches. This mapping specifies the fields and tables to search in the
knowledgebases to which a user has access. The user can view each document and then has the
option of using one of the resolutions as a resolution to the problem. If the user chooses to use a
solution or workaround, the system automatically populates the resolution field in the Problem record.
For example, if in your search you find a Problem record that includes a workaround for the Incident
record you are working with, use Use Solution to copy the data from the mapped fields of the
rootcause table to insert it into the mapped fields of the Incident record.
Users can also create knowledge to contribute a new knowledge document from a resolved record so
that the data in the mapped fields is used in the knowledge document. The field mappings and the
document type determine which fields in the knowledge document are populated with data from the
resolved record.
Note: The Use Solution option is available from knowledge documents, Incident and Interaction
knowledge candidates with resolutions, and Known Error and Problem knowledge candidates with
workarounds.
In the out-of-box system, there are record maps predefined for the incidents, knownerror,
probsummary, and rootcause tables. The Integration Mapping function provides a form for mapping
fields, searching, retrieval, and authoring.
The Map Name field is the name of the mapping. By default the out-of-box mappings are named
according to the Service Manager file name they provide a mapping for. If a Map Name other than the
Service Manager file name is used, the thread variable $gamapname must be set to the value of the
Map Name from the Display Option that is used to call the mapping.
The Source Field in Current Record column specifies the field in Service Manager that is sent to the
Knowledge Management Target Search Field. A literal string value can be specified in quotation
marks. Any string of characters specified within quotation marks is copied literally (without the
quotations) into the Target Search Field.
The Target Search Field column specifies the field in Knowledge Management that receives the data
sent from the source field. If a field is specified as a target for more than one source field, the data from
the source field is appended (in the order specified in the mapping) into the target field. A value of
"QueryString" specified in this column indicates that the data from the source field is sent as part of the
non-fielded search string (such as if a user typed into the "Enter your question" box in the Knowledge
Management search interface). A value of "contextTag" is used to indicate that the source field value
will be used to track all search activity in the kmsearchhistory and kmusagehistory tables.
Note: The viewed statistic in kmusagehistory is intended to track documents that were viewed
as the result of a search. This indicates if a knowledge document can be found and used in its
existing state. If a document is viewed from a URL linked directly to the kmdocument record, the
viewed statistic in kmusagehistory is not incremented. You can change this default behavior by
specifying a parameter with the URL request. When the parameter is specified, the usage history
and view count will be logged and incremented.
Tip: The additional parameter to add at the end of the URL query is as follows:
&relatedSystem=URLQuery
Note: These descriptions are based on the out-of-box field mappings between the knownerror
table and kmdocument table. If these field mappings have been modified on your system, the
data for the fields on your Contribute New Knowledge form may be different than what this topic
describes.
You can create a knowledge document for a known error. When you do this, the out-of-box system
provides the following information on the Contribute New Knowledge form for the known error. This
information is only available for the knowledge document if it is present in the knownerror table record.
Field Description
Title This entry comes from the brief description in the knownerror record.
Error This entry comes from the description field in the knownerror record.
Message
Cause This entry comes from the root cause description in the knownerror record.
Workaround This entry comes from the workaround and resolution description in the knownerror
record.
You can use Knowledge Management to meet your business needs in the following ways:
l Knowledge Management integrates with Service Desk Interaction so that users responding to an
Interaction record can search for similar interaction records with solutions. In addition to searching
for knowledge, the out-of-box mapping allows users with applicable privileges to create solutions
and author knowledge documents from resolved interaction records.
l Knowledge Management integrates with Incident Management so that users updating incident
records can search for similar issues with solutions in the knowledgebases. Users can also create
knowledge to contribute a new knowledge document from a resolved Incident record, so that data in
the mapped fields are used in the knowledge document.
l Knowledge Management integrates with Problem Management so that users can perform the
following tasks:
n Search for similar Problem records, Incident records, Known Error records, or knowledge
documents
n Use the resolution from an existing resolved issue in a knowledgebase as a solution for the
problem record
n Use the information from a problem resolution to create a new knowledge document
l Publish documents, retire documents, and delete documents from the knowledgebases
l Track knowledge documents at various stages with statistics generated in the kmusagehistory
table
Users have a KM security profile and an operator record which determine what privileges the users has.
The knowledge document categories that a user can access are determined by the knowledge groups
the user is assigned.
Within each security profile, there is a direct association between a defined (named) profile and the
categories and sub-categories for which the selected capabilities apply. Each security profile maps to a
document category or sub-category. A user with that profile has access to the documents specified by
the profile-to-category mapping and all subcategories in that branch of the category tree.
Profiles can be modified to select only some of the available capabilities for a profile, effectively
creating sub-profiles. For example, some users may not be allowed to publish knowledge documents
externally as well as internally.
The out-of-box KM security profiles are briefly described in the following table.
KM profile Privilege
DEFAULT With this profile, you can search and view externally published knowledge documents
for those documents in categories to which this profile has access. You can also
submit feedback on these documents.
INTERNAL With this profile, you can search and view externally published knowledge documents
USER for those documents in categories to which this profile has access. You can also
search and view internally approved knowledge documents for those documents in
categories to which this profile has access. You can also submit feedback on these
documents.
KCS I With this profile, you can author and contribute knowledge documents.
KCS I With this profile, you can author knowledge documents and edit working copy
Editor documents in the workflow for those categories to which this profile has access.
KCS II With this profile, you can author knowledge documents, contribute knowledge
documents, edit published documents without placing them in the workflow (edit in
place), and publish documents internally only. Also, you can view adaptive learning
data when adaptive learning is enabled in the system.
KCS III With this profile, you can author knowledge documents, contribute knowledge
documents, edit published documents without placing them in the workflow (edit in
place), and publish documents internally and externally. Also, you can view adaptive
learning data when adaptive learning is enabled in the system.
KM ADMIN With this profile, you can administer KM document security profiles, document types,
document views, and document categories. You can also author knowledge
documents, contribute knowledge documents, edit published documents without
placing them in the workflow (edit in place), and publish documents internally and
externally. Also, you can edit adaptive learning data when adaptive learning is enabled
in the system.
KCS I profile
The KCS I profile in the out-of-box system allows you to perform the following tasks:
A user with a KCS I profile is sometimes known as a document submitter or contributor. A KCS I can
view documents approved for internal and external use.
The KCS I capabilities apply to the knowledge document categories associated with the KCS I profile
and knowledge group in which the user is a member. The three-way profile-to-group-to-category
mapping is defined under the Permissions tab of the Category Details form.
The Knowledge Management administrator creates a KCS I contributor knowledge group and then
associates the knowledge group with a KCS I profile and document category. The users in the
knowledge group can contribute documents to that category and to the subcategories below that
category.
For example, in the out-of-box sample data, the KM 1 operator has a KCS I profile and is a member of
the KCS I KM Group. The profile-to-group-to-category mapping is KCS I (profile)-to-KCS I for KM
Group (group)-to-Knowledge Management (category).
Service Manager
The KM 1 operator, as a member of the KCS I for KM Group, can contribute knowledge documents to
the Knowledge Management category and to the sub-categories below it. Those are Knowledge-
Centered Support (KCS) and Document Maintenance and Lifecycle. The KM 1 operator cannot
contribute documents to the Service Manager category. Also, the KM 1 operator cannot view
documents in the Service Manager category.
l Edit working copy knowledge documents that are assigned to the KCS I editor in the Pending
Documents queue
A KCS I editor can view documents published for internal and external use.
The KCS I editor capabilities apply to the knowledge document categories associated with the KCS I
editor profile and knowledge group in which the user is a member. The three-way profile-to-group-to-
category mapping is defined under the Permissions tab of the Category Details form.
The Knowledge Management administrator creates a KCS I editor knowledge group and then
associates the knowledge group with a KCS I editor profile and document category. The users in the
knowledge group can contribute documents to that category and to the sub-categories below that
category.
KCS II profile
The KCS II profile in the out-of-box system allows you to do all of tasks a KCS I profile can do and also
the following tasks:
l View adaptive learning data when adaptive learning is enabled in the system
A user with a KCS II profile may also be assigned as a document owner or editor of a document in the
document workflow.
The KCS II capabilities apply to the knowledge document categories associated with the KCS II profile
and knowledge group in which the user is a member. The three-way profile-to-group-to-category
mapping is defined under the Permissions tab of the Category Details form.
Similar to the KCS I profile, the Knowledge Management administrator creates a KCS II knowledge
group and then associates the knowledge group with a KCS II profile and document category. The
users in the knowledge group can contribute, review, and edit documents to that category and to the
sub-categories below that category. With a KCS II profile, you can also publish documents for internal
access for that category and the sub-categories below that category.
Like a KCS II user, a user with a KCS III profile may also be assigned as a document owner or editor of
a document in the workflow. Also, like a KCS II user, a user with a KCS III profile can view adaptive
learning data when adaptive learning is enabled in the system.
KCS III capabilities apply to the knowledge document categories associated with the KCS III profile
and knowledge group in which the user is a member. The three-way profile-to-group-to-category
mapping is defined under the Permissions tab of the Category Details form.
Similar to the KCS I profile, the Knowledge Management administrator creates a KCS III knowledge
group and then associates the knowledge group with a KCS III profile and document category. The
users in the knowledge group can contribute, review, and edit assigned documents for that category
and the sub-categories below that category. With a KCS III profile, you can also publish documents for
external access for that category and the sub-categories below that category.
KM ADMIN profile
The KM ADMIN profile in the out-of-box system allows you to do all the tasks that a KCS I, KCS II, or
KCS III profile can do. With the KM ADMIN profile, you can also perform these tasks without specific
permissions in the document categories. A KM ADMIN user can perform the following tasks:
l Search, view, retire, unretire, and delete documents in any document category
l Author knowledge documents, contribute knowledge documents, edit published documents without
placing them in workflow, and publish documents internally and externally
l Assign documents for editing and reviewing when adaptive learning is enabled in the system
Note: The KM ADMIN profile is unlike all other out-of-box Knowledge Management profiles,
because the KM ADMIN profile is not assigned in the Category Details form.
The Knowledge Administrator security role is assigned to a user in the operator record. Users in this
role can maintain knowledge groups and Knowledge Management profiles, and update Knowledge
Management profiles as user duties change.
As part of the integration of Knowledge Management with Incident Management, Service Desk
Interactions, and Problem Management, the Knowledge Administrator can modify the default field
mappings. These mappings can change which fields are searched, from which fields data is retrieved,
and which fields can be used by users when creating knowledge from solutions and workarounds. The
out-of-box tables for these field mappings are incidents, kmdocument, knownerror, rootcause, and
probsummary.
l Published Documents
l Draft Documents
l Retired Documents
l Pending Documents
Note: A user with SysAdmin or KMAdmin capabilities is able to view all the knowledge
documents that appear in any of these lists.
Published KCS II or III in the out-of-box (OOB) system or a user in a knowledge group
Documents associated with the document category and a profile with the publish internal
capability can view all published documents. A KCS II or III user can only perform
other actions such as create pending or retire documents if the user's privileges
include the combination of profile, knowledge group and category privileges to
allow these actions.
Draft Displays a list of knowledge documents with the status "draft" for the user who
Documents authored the draft document. All draft documents in the system display for users
with SysAdmin or KMAdmin capabilities.
Retired Users with KCS II or III in the OOB system or for a user in a knowledge group
Documents associated with a category and a profile with the retire documents capability, KM
displays all retired knowledge documents in the categories associated with a
profile. Also, users can create working copies of these documents based on the
capabilities provided by the combination of profile - knowledge group - category
privileges.
Pending Documents display in this list based on the user's access to the document
Documents category and a profile that allows viewing unapproved working copy documents.
The documents displayed are currently in the approval workflow (Triage > Revise >
Review > Publish phases). Also, users with the proper permissions, based on their
profile, can move documents through the workflow, publish documents, revert
documents, or retire documents in this list.
Documents for Documents display in this list based on the user's access to the document
Review category and a profile that allows viewing unapproved working copy documents.
The documents displayed are currently in the Review phase of the approval
workflow. Users with capabilities based on profile permissions are able to forward
the Publish phase, or return it to the Revise phase for further revision.approve
internal. Also, users with capabilities based on profile - knowledge group - category
can approve, revert or retire documents in this list.
Published documents are documents that are available for searching and viewing. Some documents
may only be viewed by internal users, while others can be viewed by internal and external users.
Published documents can be edited by users with the Edit in place a published document option
selected for their KM security profile.
3. Select the applicable check boxes on each of the security profile tabs. For example, go to the KCS
II tab to select the Edit in place a published document option.
4. Click Add.
5. Click Save.
6. Click OK.
Knowledge Management (KM) uses knowledge groups, document categories, and the KM security
profiles to determine which documents to display in the lists of knowledge documents available from
the KM menus. The KM security profile and operator record together determine what KM privileges are
granted to users.
2. Click Search.
Adaptive learning
Adaptive learning is a feature of Knowledge Management where the system collects words or specific
phrases used to search a knowledgebase for those documents that are considered useful or can be
used as solutions for incidents, problems, or interactions.
Note: System Administrators can turn on or ff adaptive learning with a setting on the Knowledge
Management Environment form.
Knowledge Management maintains a count which specifies the number of times search words or
phrases resulted in finding a useful document (whether marked as useful or used as a solution). Each
time a user performs a search using the same words or phrases, the count is incremented or a new
entry is created when the search returns useful results. Also, each time an operator clicks the Use
Solution button, the phrase used by the operator to search for the solution is saved or the count is
incremented for the phrase for the adaptive learning record associated with the solution.
Note: For a working copy of a document that has no published version, the system collects the
words and phrases for adaptive learning. For a working copy of a document that already has a
published version, the system does not collect the words and phrases for adaptive learning.
When a user performs a search using advanced search and then marks a document as useful, the
system creates or increments the associated adaptive learning record as follows:
l When the search results are filtered by "Any of these words," the system adds separate entries for
each word in the search phrase.
l When the search results are filtered by "All of these words" or "This exact phrase," the system
creates a single entry for all the words in the search phrase.
The useful count becomes a weighted value so that when another user performs a different search
using the same words or phrase, documents containing the same words or phrase are returned higher
on the hit list in the next set of search results.
Example: If words like "monitor" or "blue monitor" are used in a document and it resolves an incident
and is used as a solution, the phrase blue monitor or the word monitor are appended to the adaptive
learning terms for that document and the count is incremented. For additional searches, a document
with one blue monitor in it will come up with a reasonable relevancy. You can also change the count of
monitor to 15, for example, to make this document appear higher on the search results list than another
document with the word monitor in it.
l Adding additional words from the saved queries to the content of the document means that
additional hits on the document occur when these words are supplied in a new query.
l The words and phrases collected by adaptive learning can be further weighted to increase the
relevancy value of a particular document, which means some documents are found more frequently
and appear higher on the hitlist.
Note: You must have a KCS II or KCS III profile to view adaptive learning data, and a KM ADMIN
l Search using a word or phrase and then from the hit list select one of the documents to view. There
is an Adaptive Learning button available from the document view if the document is an sclib-type
document. Click this button to view a list of phrases and counts for the document.
l View a document from the list of published documents. The view includes an Adaptive Learning
button. Click this button to view a list of phrases and counts for the document.
l The Knowledge Management > Configuration menu includes an Adaptive Learning selection.
When you click Adaptive Learning, a form appears, from which you can search for adaptive
learning data using knowledgebase, document ID, or phrase.
l For knowledge candidates such as Incident or Interaction records found when doing a search, the
Adaptive Learning button is available for KM ADMIN users when viewing a specific document.
l The Adaptive Learning button appears for users with a KCS II, KCS III,or KM ADMIN profile when
viewing or editing documents from the Pending Documents queue that are new working copy
documents (that is, documents without a previously-published version).
Note: You must have a KM ADMIN profile to edit adaptive learning data.
When adaptive learning is enabled, data about the queries that returned documents that were used for
solving issues is stored and integrated into the documents when they are indexed. If you want to edit
the actual content of a document, you can edit data that will be used as adaptive learning data.
2. Type the document ID if you are looking for the adaptive learning data for a specific document.
3. Select the knowledgebase if you are looking for the adaptive learning data for a specific
knowledgebase.
4. Type the phrase if you are looking for the adaptive learning data for a specific phrase.
5. Click Search.
7. Click the phrase or count for the document you want to update and then type the new value for the
count.
9. Click Delete Phrase after you select the phrase you want to delete.
You can also edit adaptive learning data by viewing a published document or by viewing a working copy
of a document that also has a published version of the document.
System Administrator
When adaptive learning is enabled, data about the queries that returned documents that were used for
solving issues is stored and integrated into the documents when they are indexed.
1. Click System Administration > Ongoing Maintenance > Environment Records >
Knowledge Management Environment .
2. Select the Use Adaptive Learning to enhance search results field to enable adaptive learning.
Note: Clear the Use Adaptive Learning to enhance search results field if you want to
disable adaptive learning.
Note: This step is needed whenever you enable or disable adaptive learning.
Each of the knowledgebases has different fields that are indexed for searching, so when you search a
knowledgebase, provide search parameters that match the fields in the knowledgebase. For example,
the knowledge articles have a title and author field. When you view an Incident record, the out-of-box
system displays the Incident record number, description, and solution for closed incidents.
The out-of-box system includes five separate knowledgebases that can be searched collectively or
separately, depending upon what information you are searching for. In addition to making your search
more efficient by specifying a knowledgebase, it is also best to search with a limited number of
document categories. When you search, your log-in profile determines what information you can search
and view.
You can use the Knowledgebase Maintenance feature to add additional knowledgebases for searching.
These knowledgebases are created from a table in HP Service Manager(sclib) or by using web
crawling to browse and index an external web site (weblib).
Knowledge documents
In the Knowledge Management (KM) system, a knowledge document typically consists of information
about a particular topic. The amount of detail and length depends on the complexity of the topic and the
audience for the document. Knowledge documents can include attachments that can be images, text
files, PDF files, or Word files for example. In the out-of-box system, the types of knowledge documents
are error messages, external documents, question/answer documents, problem/solution documents,
and reference documents. All knowledge documents are assigned to at least one document category
and may be placed in multiple categories. A typical document category might be technical documents
or HR procedures.
l Draft documents - These are documents that are being created, but have not yet been submitted to
be published..
l Published documents - These are documents that are available for searching and viewing. Some
documents may only be viewed by internal users, while others can be viewed by internal and
external users. Published documents can be edited by users with the Edit in place a published
document option selected for their KM security profile. Users can add feedback to published
documents. Users with appropriate privileges can create a working copy of the document and then
make revisions.
l Working copy - A document becomes a working copy when a published document goes into the
workflow to be updated. When the working copy of the document is published, it replaces the
original document. A working copy of a published document has an "R" appended to the document
ID. A new document submitted to be published is also considered a working copy while it is in the
workflow waiting to be published, but there is no "R" appended to the document ID.
l Retired documents - These are documents that become out-of-date and have been archived for
some reasons. Retired documents are not searched when users perform a knowledgebase search.
KM ADMIN users can delete retired documents.
Knowledge documents typically have a life cycle that includes draft, triage, pending documents in the
approval workflow, published, and retired.
The system displays a search screen instead of a list of published documents so that users can quickly
find a published document or a group of published documents.
In the out-of-box system, a Knowledge-Centered Support (KCS) II user profile can publish internal
documents and a KCS III user profile can publish internal and external documents.
Working copies of published documents can be reverted to the original version of the published
document while the document is in the document workflow. There is a Revert button available for a
working copy of a published document. If changes have been made to the working copy of the
document, it can still be reverted. In the out-of-box system, users with a KCS II or KCS III profile can
revert working copy documents in those categories to which they have access. A KM ADMIN profile
allows the user to revert any working copy document.
Before you retire a document, you should update any documents that link to the document you are
retiring. When you attempt to retire a document that other documents link to, the system will not allow
you to retire it. The system alerts you to the situation and then allows you to send these linked
documents to workflow for review. You can then update the links or remove the links in these
documents because Knowledge Management will not allow you retire a document that links to other
documents in the knowledgebase.
The alert message includes the document IDs of the documents that need to be updated and
placed in the Pending Documents queue. If you click OK, it then places those documents in the
Pending Documents queue.
In the out-of-box system, users with KCS II or KCS III profiles can retire any of the published
documents that are assigned to the document categories and subcategories to which they have
access. A user with a KCS ADMIN profile can retire any draft or published document in any document
category.
Users with a KCSII or KCS III profile are primarily responsible for coordinating the Knowledge
Management documents in the workflow. They are able to view and act on documents in the categories
or subcategories to which they have access. A user with a KM ADMIN profile or a System
Administrator can access all the Knowledge Management documents for all categories and
subcategories.
If the resolution of an Incident or Interaction record is used frequently, the KCS Coach or System
Administrator may want to manually create a knowledge document by locating the Incident or
Interaction record and clicking the Create Knowledge link.
Note: If you are editing an attachment for an existing knowledge document, you must send the
document to the workflow. You can then save the attachment to your desktop, make the
necessary updates, save the changes, and then re-upload the attachment to the knowledge
document.
l Assign the document to a member of the document group for the document category or subcategory
and move the document to the next phase in the workflow
For each document, a user will select a document owner and an assigned editor from a list of users with
edit privileges.
Note: Documents do not need to progress through every phase and end in the final phase. A user
with the correct permissions in the document categories may publish or retire a document before it
reaches the final phase. Additionally, the owner or editor may decide to revert back to the original
version of a published document.
Here are some suggestions for using the Search for text box.
l To search for an exact phrase, surround it with a pair of double quotation marks ("").
l When a search returns a large number of hits, limit your search by searching within the search
results (search within results).
l If you have performed an advanced search, terms entered in the advanced search screen are still
active even if the advanced search screen is not visible. The advanced query terms are added to
the simple search query unless you go to the advanced search screen and remove them.
/,\, #, $, %,^, &, (, ), _,- (em These special characters will be filtered out (ignored).
dash or en dash), +, =, |
(pipe),<,>,comma (,), and
period (.), etc.
The Knowledge Administrator security role is assigned to a user in the operator record. Users in this
role can maintain knowledge groups and Knowledge Management profiles, updating Knowledge
Management profiles as user duties change.
As part of the integration of Knowledge Management with Incident Management, Service Desk
Interactions, and Problem Management, the Knowledge Administrator can modify the default field
mappings. These mappings can change which fields are searched, from which fields data is retrieved,
and which fields can be used by users when creating knowledge from solutions and workarounds. The
out-of-box tables for these field mappings are incidents, kmdocument, knownerror, rootcause, and
probsummary.
KCS practices involve collaborating, sharing, using and improving knowledge. KCS practices
encourage knowledge creation and improvement by all members of the support team and promote
effective knowledge searches by maintaining up-to-date knowledgebases. The out-of-box Knowledge
Management system enables all internal and external users to provide user feedback on the knowledge
documents. This helps to identify useful articles and to mark other articles for revision, which
contributes to the overall quality and value of the information in the knowledgebase.
The goal of KCS is to solve a problem once and use the solution often. KCS-based systems take
advantage of the knowledge available in all phases of the service desk operations by making the
knowledge captured by the customer support process available for reuse throughout the support
organization.
Statistic Description
Viewed Tracks documents viewed as the result of a search. This indicates if a knowledge
document can be found and used in its existing state. If a document is viewed from a
URL linked directly to the kmdocument record, the viewed statistic in kmusagehistory
is not incremented. You can change this default behavior by specifying a parameter
with the URL request. When the parameter is specified, the usage history and view
count will be logged and incremented.
Submitted Tracks new and updated knowledge documents submitted for content verification and
for approval.
approval:
Revert Tracks knowledge documents reverted to their original state after modifications have
already been made.
Retired Tracks knowledge documents taken out of the knowledgebase and retired either
because the knowledge documents reached their expiration date or the content was no
longer applicable.
Unretired Tracks knowledge documents put back into circulation and made available in the
knowledgebase after having been earlier retired and pulled out of the documentation
queue.
Used Tracks the number of times a knowledge document was used as a solution for
Solution Interaction, Incident, and Problem records.
KM
User Group KM Profile Document Categories
all operators with user role: incident manager, KCS III for KCS III Service Manager
incident coordinator, problem manager, Service
problem coordinator, change manager, Manager
change coordinator, and change approver group
all operators with userrole: incident analyst, KCS II for KCS II Service Manager
problem analyst, change analyst Service
Manager
group
all operators with userrole: service desk agent KCS I for KCS I Service Manager
Service
Manager
Group
all operators with userrole: self service Service DEFAULT Service Manager
Manager
External
Viewers
Service Manager
Knowledge Managemen
Support
Change Management
HR
Benefits
Policy
Feedback on Knowledge Management help topics for printing (Service Manager 9.34)
If no email client is available, copy the information above to a new message in a web mail client, and
send your feedback to [email protected].