Professional Documents
Culture Documents
04
User Guide
January 2011
www.bmc.com
Telephone
Fax
Fax
If you have comments or suggestions about this documentation, contact Information Design and Development by e-mail
at doc_feedback@bmc.com.
Customer Support
You can obtain technical support by using the Support page on the BMC Software website or by contacting Customer
Support by telephone or e-mail. To expedite your inquiry, please see Before Contacting BMC Software.
Support website
You can obtain technical support from BMC Software 24 hours a day, 7 days a week at
http://www.bmc.com/support. From this website, you can:
Read overviews about support services and programs that BMC Software offers.
Find the most current information about BMC Software products.
Search a database for problems similar to yours and possible solutions.
Order or download product documentation.
Report a problem or ask a question.
Subscribe to receive e-mail notices when new product versions are released.
Find worldwide BMC Software support center locations and contact information, including e-mail addresses, fax
numbers, and telephone numbers.
Product information
Product name
Product version (release number)
License number and password (trial or permanent)
Machine type
Operating system type, version, and service pack
System hardware configuration
Serial numbers
Related software (database, application, and communication) including type, version, and service pack or
maintenance level
Messages received (and the time and date that you received them)
In the United States and Canada, call 800 537 1813. Outside the United States and Canada, contact your local support
center for assistance.
Contents
Preface
Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Best practices and Calbro Services examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Online help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Related documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8
8
8
9
Chapter 1
11
IT Home page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
All Knowledge Articles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Knowledge Management Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Search Knowledge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Navigating consoles, forms, and modules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
A word about knowledge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Article life cycle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Before publishing an article . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
After publishing an article . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Status groups and types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Status groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Status types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Status transition workflows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
User permissions for changing statuses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Functional roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Visibility groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
12
13
13
13
13
17
18
18
20
21
21
22
24
25
25
30
Chapter 2
31
Functional areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Creating custom search filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Modifying your profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Receiving notifications about changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
32
37
38
38
Chapter 3
41
42
42
43
43
43
5
47
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Accessing the search page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Using knowledge search guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Performing simple searches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Performing advanced searches. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Best practice example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Advanced Search parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Search results. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Knowledge types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Search result relevance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Working with search results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Chapter 5
57
User Guide
81
Preface
The BMC Remedy Knowledge Management application provides a framework for
creating, publishing, reviewing, and searching knowledge articles. The application
provides service desk analysts with a knowledge base of easy-to-find solutions
and gives users self-service search options to help them resolve issues on their
own.
BMC Remedy Knowledge Management helps organizations maintain what their
employees, partners, and customers know and reuse this knowledge to gain value.
Knowledge, typically composed of different types and formats, is stored as
separate knowledge articles contained in a knowledge-based repository. Storing
knowledge articles in a repository allows control and life cycle management.
The authoring process enables authorized users to use rich HTML authoring and
extensive editing tools to create and maintain interactive, template-based
knowledge articles and manage the knowledge article life cycle within a defined
sequence of stages.
Powerful index and search capabilities across multiple sources, including
incidents, problems, and known errors, enable users to search the repository and
locate the requested knowledge. The robust search engine allows users to search
for solutions using natural language or Boolean searches.
BMC Remedy Knowledge Management shares a common foundation with BMC
Remedy IT Service Management (BMC Remedy ITSM) and BMC Service Request
Management. All applications are built on BMC Remedy Action Request System
(BMC Remedy AR System). BMC Remedy Knowledge Management leverages
foundational elements, such as notification and e-mail, of the integration platform
to simplify and reduce management costs.
BMC Remedy Knowledge Management runs on the (BMC Remedy AR System)
and consumes data from the BMC Atrium Configuration Management Database
(BMC Atrium CMDB).
Preface
Audience
This guide is intended for IT personnel who use BMC Remedy Knowledge
Management to create, publish, review, and search IT knowledge articles.
Application administrators who configure and administer the application will also
find this guide helpful.
Access permissions and viewing entitlements to knowledge articles and their
metadata, and the ability to perform certain tasks, are defined according to user
roles.
Online help
BMC Remedy Knowledge Management provides a set of localized HTML help
files that you access by clicking the Help link.
Context sensitive help is available in the following pages:
User Guide
Update Requests
Knowledge Article
Relationships
Feedback
Article History
Article Revisions
Related documentation
Create Knowledge
Knowledge Search
Watch List
Related documentation
The following table lists the documentation available for BMC Remedy
Knowledge Management.
Unless otherwise noted, online documentation in Adobe Acrobat (PDF) format is
available on product installation DVDs, on the Customer Support website (http://
www.bmc.com/support), or both. You can order printed documentation from the
Customer Support website.
NOTE
To access the Customer Support website, you need a support contract.
Title
Document provides
Audience
Administrators
Administrators
Preface
10
User Guide
Chapter
Chapter 1
11
IT Home page
The IT Home page is the BMC Remedy IT Service Management (BMC Remedy
ITSM) gateway to all applications to which you have permissions. The IT Home
page opens with a display of a links panel on the left side and a main Overview
Console panel on the right side. When you click the plus sign icon at the top right
of the IT Home page four smaller panels open. One of these panels is the originally
opened Overview Console. The content of the other three panels varies according
to the options that you choose from the Show list at the top of each panel. The
options available for BMC Remedy Knowledge Management are:
Search Knowledge
The following figure illustrates the functional areas of the IT Home page.
Figure 1-1: IT Home page and its functional areas
12
User Guide
IT Home page
Search Knowledge
You use the Search Knowledge panel to perform a simple search for all articles that
contain the words you enter. Clicking on one of the returned results opens the
article. See Chapter 4, Searching for knowledge.
NOTE
Not all of the consoles, forms, and modules open in the view area. For example, CI
records open in a new window. When a console, module, or form opens in a
window, it is not added to the breadcrumb bar.
The breadcrumb bar contains links to the records that you opened from the parent
record. When you open a record, the breadcrumb trail expands along the
breadcrumb bar to the right, with the new link. If there are more than six links in
the breadcrumb trail, arrows appear at one or both ends of the bar that let you
scroll back and forward on the bar to see links not currently in the view.
Chapter 1
13
The first link in the breadcrumb trail indicates the place from which you started. It
can be a console or a form. For example, if you open a change request record
directly from the IT Home page, the first link in the breadcrumb trail takes you to
the change request.
The last link corresponds to the record currently in the view. If you open a link to
the left of the record currently in view, the system truncates the breadcrumb trail
to that link. The history is retained, however, so you can use the back and forward
arrows in the navigation controls to move through the bar one record at a time.
There is also a history of your most recently viewed records, which you can use to
move directly to a record. Click the down arrow to open the history list.
NOTE
The Forward button is only visible after you move back down the breadcrumb bar
by opening a link to a record that you previously viewed.
Figure 1-2: The breadcrumb navigation buttons and bar
If you are viewing a record from the middle of the breadcrumb trail and then
branch off to another parent-type record, the system removes the forward
breadcrumb trail from the point where you branched off and starts a new history
from there, using the new parent-type record as the starting point. For example:
You open a problem investigation, then open a related incident request, and from
the incident request you open a related change request. If you go back to the
incident request record and then open a second problem investigation, the
breadcrumb bar no longer contains a link to the change request. The breadcrumb
trail now shows the original problem investigation, the incident request, and the
second problem investigation. It then shows any related records that you
subsequently open from the second problem investigation.
When you close the parent record, the system removes the breadcrumb history.
14
User Guide
IT Home page
NOTE
All of the records that you open from a form in Search mode are added to the
history list.
To return to the results table, click the name of the form in the breadcrumb trail.
NOTE
If there is a record in the history list that you want to open in a second window,
press the Shift key and then double-click the entry.
TIP
Before you open any of these consoles, forms, or modules, save the changes to the
IT Home page that you want to keep.
BMC Remedy Asset Management, except for the Asset Management console.
Application Administration
All Service Request Management entry points, except for Work Order
Chapter 1
15
16
User Guide
Analytics
Chapter 1
17
stage, the articles content might be visible to some users with Knowledge user
roles. However, the content has not been reviewed and approved for use. This
content might change, or the entire article might be deleted.
Step 3 A Subject Matter Expert (SME) reviews the article for content but cannot approve
Step 4 The author completes the required editing and resends the article to be reviewed
again by an SME who is a member of the same support group as the SME who
originally reviewed the content.
Step 5 The article passes the review this time and is assigned to another reviewer who
performs a review for technical accuracy. For example, if the article contains
procedural steps, this reviewer verifies that no steps are missing.
Step 6 After the content and accuracy have been reviewed, verified, and approved, the
article is proofread.
Step 7 The article has passed all the reviews and is ready to be published, but must first
Step 8 When approved, the article is published and becomes available to all users, even
those without Knowledge user roles. In some cases, the content might be
confidential so the article might be marked as not available to users without a
Knowledge user role.
18
User Guide
NOTE
Managing and tracking the life cycle through its different statuses depends on the
valid status transitions that have been configured by Knowledge Config user. The
list of available statuses for selection is sensitive to the environment (for example,
user role, current status, and company permissions). See Status transition
workflows on page 24 for more information.
Figure 1-3: Article life cycle and associated knowledge article review steps
Chapter 1
19
correct is set for the article. When the review date arrives, notification is sent as a
reminder.
Step 2 Users search for and open the article, indicating whether the content has been
Step 3 A Knowledge User reviews the article and needs to update some of the content. A
duplicate copy of the article is created. After the changes are made, the new version
replaces the older article.
Step 4 At some point, the article becomes obsolete and a Knowledge User retires it,
20
User Guide
Status groups
Table 1-1 presents a description of the status types and divides them into the
following groups:
Status bar groupGroup of similar statuses that is displayed on the status bar.
Status type
None
In Progress
In Progress
Not Published
Draft
Draft
In Review
SME Review
Optional Review 1
Optional Review 2
Publish Approval
Published
Published
Published
Retire Approval
None
Closed
Closed Version
Retired
Cancelled
Chapter 1
21
Status types
Table 1-2 provides a description of article status types.
Table 1-2: Status descriptions (Sheet 1 of 2)
Status type
Description
In Progress
Draft
SME Review
Typically the next step after Draft. The SME Reviewer reviews
and optionally edits the article, and can promote it to one of the
following statuses:
Optional Review 1
Optional Review 2
Note: The following information is relevant for all review status types:
22
User Guide
Only the assigned reviewer and Knowledge Admin can update the article.
Members from the reviewer's support group can assign the article to themselves.
Reviewers can add an update request and edit the article.
Description
Publish Approval
Published
Retire Approval
Retired
Closed Version
Cancelled
Cancelled status is displayed as an item on the Status dropdown list to Knowledge Admin users only.
Setting this status renders articles not usable or searchable;
however, they are not deleted from the database.
Administrators can filter for cancelled articles in the KM
Console. See Functional roles on page 25 for more
information.
This status can be set from any other status (for example,
Draft). The exception to this rule is that Published articles can
never be promoted directly to Cancelled status, and
Knowledge Users must first send a Cancellation Request for
approval. See the BMC Remedy Knowledge Management
Administration Guide for more information.
Chapter 1
23
In
Draft SME
Optional Optional Publish
PubProgress
Review Review Review Approval lished
1
2
In
Progress
Draft
Retire Retired
Approval
Can- Closed
celled Version
x
x
SME
Review
Optional
Review 1
Optional
Review 2
Publish
Approval
By
approval
Published
Retire
Approval
By
approval
Retired
Cancelled
Closed
Version
NOTE
24
User Guide
NOTE
See Functional roles on page 25 for more information.
Knowledge AdminCan access and update all articles, view articles that are
assigned to others, change Assignee, and cancel articles.
Move articles to one of the review statuses. In this case, the Support Group
value changes to the group to which the new assignee belongs.
Knowledge Users cannot change article status to Published or Retired, and
must submit the article for Publish Approval or Retire Approval, as
appropriate.
Knowledge SubmitterCan create articles and update them while they are in
the In Progress status.
Functional roles
In BMC Remedy Knowledge Management, each user has an assigned functional
role, which defines what tasks they can perform. In addition articles are assigned
with visibility groups that define what content users can see.
By default, BMC Remedy Knowledge Management provides the roles and the
permissions associated with them. Typically, a user with a Knowledge Admin role
determines and assigns roles for users in the application.
By default, BMC Remedy Knowledge Management installs AR permission groups
that are already mapped to knowledge roles in the application. BMC recommends
that you use these AR permission groups to assign roles.
Chapter 1
25
NOTE
When no Knowledge Management role is assigned, Self-Service permissions
enable end-users to search and view published knowledge articles that are flagged
for external use.
Table 1-4 shows the available default actions for the different roles.
Table 1-4: BMC Remedy Knowledge Management roles with their privileges (Sheet 1 of 4)
Privileges
Self
Knowledge Knowledge Knowledge Knowledge Knowledge Comments
Service Viewer
Submitter User
Admin
Config
Viewing
View articles in
simple view
View articles in
advanced view
View in-progress
articles
View in-review
articles
View published
external articles
View published
internal articles
26
User Guide
+
Internal articles are
approved but not
exposed to end
users.
Functional roles
Table 1-4: BMC Remedy Knowledge Management roles with their privileges (Sheet 2 of 4)
Privileges
Self
Knowledge Knowledge Knowledge Knowledge Knowledge Comments
Service Viewer
Submitter User
Admin
Config
View closed
version
View retired
articles
View cancelled
articles
Cancelled articles
can be viewed from
the console.
Articles waiting for
approval (both
publish and retire)
can be searched and
viewed.
View articles
waiting for
approval
View update
requests
View relationships +
View Categories
View Revisions
View History
View Usage
Edit In Progress
Knowledge
Submitters can edit
only their own
articles.
Edit draft
Edit in-review
Edit published
Edit retired
Editing
Chapter 1
27
Table 1-4: BMC Remedy Knowledge Management roles with their privileges (Sheet 3 of 4)
Privileges
Self
Knowledge Knowledge Knowledge Knowledge Knowledge Comments
Service Viewer
Submitter User
Admin
Config
Edit cancelled
Edit waiting-forapproval
The status is
changed to Draft
from In Progress.
Change status to
review
Change status to
publish/retire
approval
Workflow
Change status to
draft
Change status to
cancel
Knowledge users
can request to cancel
articles.
Take ownership
Assign ownership
Approve publish
28
User Guide
Configured in the
BMC Remedy
Knowledge
Management
configuration.
Requires support
group membership
and approval role.
Functional roles
Table 1-4: BMC Remedy Knowledge Management roles with their privileges (Sheet 4 of 4)
Privileges
Self
Knowledge Knowledge Knowledge Knowledge Knowledge Comments
Service Viewer
Submitter User
Admin
Config
Approve retire
Configured in the
BMC Remedy
Knowledge
Management
configuration.
Requires support
group membership
and approval role.
Set owner/ownergroup
KM Console
Open registration
console from
'Functions'
Quick Actions
+
+
Open
configuration for
KM
Open search form
Other
Submit update
requests
Submit feedback
Create reports
Remedy fixed
(write) license
Part of support
staff
Create
relationships
Chapter 1
Submitters can
create relationships
only for in- progress
articles.
29
Visibility groups
BMC Remedy Knowledge Management uses visibility groups to restrict access to
knowledge base content. Your system administrator assigns you to a visibility
group just as you are assigned to a functional role. When you create a knowledge
article, that knowledge article is assigned to your visibility group. When you
search for a knowledge article, you can view only those knowledge articles that are
in your visibility group. Your system administrator may assign you to more than
one group.
See Assigning visibility groups on page 63.
30
User Guide
Chapter
Chapter 2
31
Functional areas
The following figure illustrates the functional areas of the Knowledge
Management Console.
NOTE
Data is automatically refreshed each time you make a different selection of one or
more articles.
Figure 2-1: Knowledge Management Console and its functional areas
32
User Guide
Functional areas
Table presents the functional areas of the Knowledge Management Console and describes what you
can do in each area.
Knowledge Management Console functional areas (Sheet 1 of 3)
Functional area
Purpose
Select the articles you want to display in the articles table. Available options
are:
Filter By
Filters the displayed articles as you specified in the Show field according to
the selected filter. You can use predefined filters, under Defined Searches,
or you can create your own custom filters by clicking the
icon.
Manage My Searches
Enables you to define, edit, save, and delete custom filters. See Creating
custom search filters on page 37 for more information.
Navigation pane (left side)Displays key information and provides search filters.
Counts section
In ProgressAll articles that are In Progress status, for which you are the
owner or assignee.
Update RequestsAll Not Published and Published articles with new or
In Progress update requests that are pending for you.
In ReviewAll articles that have any of the review statuses.
Chapter 2
33
Table presents the functional areas of the Knowledge Management Console and describes what you
can do in each area.
Knowledge Management Console functional areas (Sheet 2 of 3)
Functional area
Purpose
Functions
Search KnowledgeOpens the Search page, from which you can search
the knowledge base for articles.
Watch List RulesOpens the Watch List Rules page. See Working with
Watch Lists on page 74.
My ProfileOpens your personal profile record for setting your profile.
See Modifying your profile on page 38 for more information.
Applications
Click to expand or collapse the list of BMC Remedy ITSM applications you
have permissions to use. Click the links to navigate to other BMC Remedy
ITSM application.
Consoles
Provides links to the IT Home page and the Approval Console. The
Approval Console opens the BMC Remedy AR System Approval Central
page, which enables you to track articles that are waiting for approval
within the approval server.
Create
Preferences
Quick Actions
34
User Guide
Functional areas
Table presents the functional areas of the Knowledge Management Console and describes what you
can do in each area.
Knowledge Management Console functional areas (Sheet 3 of 3)
Functional area
Purpose
Knowledge table
Lists articles based on your selection on the Show and Filter By fields. Click
an article to open it.
This table contains the following columns, by default:
Displays the update requests associated with the selected article. This table
contains the following columns, by default:
Chapter 2
35
Explanation
36
User Guide
2 In the Search Name field of the Manage my Searches dialog box, type a name for
4 From the Keywords or Fields selection boxes, select the keywords or record fields
To insert operators (+, =, >, <, and so on), click the appropriate operator button.
Place literal values between double quotation marks.
For example, to search for articles that meet the following criteria:
NOTE
Date formats can vary, depending on how your system is configured. The date
shown in this sample query is only an example.
5 Click Select to close the Advanced Qualification Builder, and then click Save.
6 Close the Manage My Searches dialog box.
The search appears in the Defined Searches list, under the My Searches node.
procedure.
2 Under My Searches, select the search filter that you want to modify or delete.
3 To modify the search filter, edit it as necessary and then click Save.
4 To delete the search filter, click Delete.
5 Click Close.
Chapter 2
37
View permissions.
For detailed information about the People form, see the BMC Remedy IT Service
Management Configuration Guide.
My Profile.
2 On the People form, update the information at the top of the form, or click the tab
3 Make your changes by selecting from the various lists that are available. When you
Article Owners receive notifications regarding certain events for articles that
they own.
Watch List subscribers receive notifications related to articles in their watch list.
38
User Guide
Notification
event
Description
Recipients
Knowledge
Assignment
Knowledge
Ownership
Assignment
Article Owner
Description
Recipients
Knowledge
Cancel Request
Article Assignee
Knowledge
Cancel
Rejection
Article Assignee
Knowledge
Retire Rejection
Request to retire a
Article Assignee
published article is rejected. Watch List subscriber
Knowledge
Publish
Rejection
Request to publish an
article is rejected.
Article Assignee
Knowledge
New Version
Knowledge
Update Request
Article Assignee
Knowledge
Expiration Date
Article Assignee
Knowledge
Feedback
Feedback is received.
Knowledge
New Article
Article is created.
Article Assignee
Knowledge
Review
Required
Article Assignee
Knowledge
Change
Article is changed.
Knowledge
Status Change
Article Assignee
Knowledge
Auto Cancel
Chapter 2
Article Assignee
Watch List subscriber
39
40
User Guide
Chapter
This section describes how to create and edit knowledge articles in the BMC
Remedy Knowledge Management application.
The following topics are provided:
Chapter 3
41
Console.
2 Click the Create icon or click New Article under the Functions section.
3 In the Create Knowledge dialog box, select the required template from the list and
click Create.
4 In the Content tab of the Knowledge article page, enter the appropriate
You can type directly into the field, or you can click the edit icon in the top right
corner of the text box to use an external text editor.
An editing toolbar provides rich-text editing capability, with the majority of
functionality available only in the external text editor. Also, some of the fields have
an internal mini editing toolbar available from within the window, which you can
open by double-clicking inside the box.
5 In the Details tab, enter metadata information. This information is useful for
6 Click Save.
The article is now available to be processed through the workflow until it is made
available to all users.
You can also link to other websites and other knowledge articles that reside in the
knowledge base. You can add image files as attachments or embed them directly
into your knowledge article so that they appear within the knowledge article.
42
User Guide
Inserting attachments
You can add attachments at the bottom of your knowledge article in a separate
attachments section. You can add up to three attachments per knowledge article.
X To attach files
1 In the knowledge article, select the Details tab.
2 Under the Article Attachments section, click Add.
Open.
4 Click OK.
Inserting links
You can insert links to other knowledge articles or external websites.
X To insert a link
1 Click inside a rich text field.
2 Select the knowledge article text to become the hyperlink.
3 Click the HTML Link icon.
4 In the Link Option panel, enter the URL to link to.
Select whether the URL will open in a new window and add a description to the
link
5 Click OK.
BMC Remedy Knowledge Management inserts the hyperlink in the text field.
Inserting images
You can insert an image into your knowledge article as a link or as an embedded
image.
X To insert an image
1 Click inside a rich text field.
Chapter 3
43
To insert your image as a link, select the knowledge article text to become the
hyperlink.
To embed the image directly into the knowledge article, move your cursor to the
start of a new line where you want to insert the image.
For embedded images, browse to the image location and select the file from the
file list.
5 Click OK.
BMC Remedy Knowledge Management uploads the file and displays the
hyperlink in the text field.
If you did not select text for the hyperlink, the image is embedded directly into the
knowledge article.
NOTE
Links to attachments and images are not active in the document editor. You must
view the knowledge article in the Document Viewer to use the hyperlink.
NOTE
You can integrate knowledge articles that were created in a decision tree format
with incidents or problems in BMC Remedy AR System.
To create a decision tree, you choose the Decision Tree template and enter
information in the knowledge article fieldsjust as you do when you create other
knowledge article types. You build your tree branches in the decision tree section
of the knowledge article.
Management Console.
44
User Guide
Create.
In the Description field, type the first question for the decision tree. For example:
NOTE
The decision tree title is different from the knowledge article title.
5 Add subdecisions (branches) to build the tree.
Shift + Right Arrow/Left ArrowMove the subdecision to the right or left. The
indents tell how to line up the tree branches, and are not just for readability but
for stepping through the branches.
6 To create a cycle or link in a tree, click the link icon in the decision tree description
7 To add a text box in which users can record their decisions when following the
When users view the knowledge article in the BMC Remedy Problem Management
or BMC Remedy Incident Management application, they can enter and store
values in the text box.
Management Console.
Chapter 3
45
46
User Guide
Chapter
This section describes how to define simple and advanced searches to search for
knowledge, and how to use search results. The following topics are provided:
Chapter 4
47
Overview
BMC Remedy Knowledge Management enables you to search for knowledge
contained in your knowledge database by using the following search types:
Simple searchPerform a search for knowledge that contains any of the search
words.
After you perform a search, the search result list opens on the Simple Search page
and displays results that match your most recent search criteria. You can open a
search result for viewing, editing, using, printing, and modifyingaccording to
your user permissions. Searches are deleted when you close the Search page.
In addition to procedural instructions, this section contains common use cases that
you might typically encounter when performing simple or advanced searches.
Although Calbro Services user personas illustrate the use cases, no references are
intended toward specific Calbro Services sample data or real-life users.
NOTE
Search results contain only those articles that you are permitted to view, and which
fulfill all of the search criteria.
Procedures and references to page elements provided in this section use default
settings and values, and do not reflect customized settings.
48
User Guide
Use the words that are most likely to appear in the knowledge article's title or
contents.
Check that the criteria is accurate when searching for specific knowledge article
titles or exact phrases.
Do not use identical search words in both the Include all of these words field
and the Exclude these words field.
Case-sensitivity settings
Stemming configuration
The following characters have special meaning in Full Text Search and may affect
the search results when used unintentionally.
Character
Description
word stems, such as "ed", "s", and "ing" because word stems are
automatically included.
()
For more information, see the BMC Remedy Action Request System: Configuration
Guide.
Chapter 4
49
NOTE
In Simple Search, you must enter search criteria in the Search field. Searching on a
blank field returns no search results.
Best practice
The following example depicts how Joe Unser might perform a simple search to
search for knowledge.
Joe Unser wants to search the knowledge database for information about a task he
is performingordering a new laptop. Joe can perform a simple search for this
information by entering a phrase or word in natural query language. He enters the
following search criteria: How do I order a new laptop?
This information could be contained in the database in various ways.
NOTE
If you have already defined search criteria in the Advanced Search page, the Use
Advanced Search Criteria check box is displayed next to the Advanced Search
link. Selecting this check box includes all search criteria that is currently defined on
the Advanced Search page.
3 Click Search.
4 (optional) Change the search criteria and perform a new search, as required.
50
User Guide
Enter more specific search criteria (for example, searching for an exact phrase
instead of separate keywords).
After you set advanced search parameters, the Use Advanced Search Criteria
check box appears in the Simple Search page. This enables you to change search
words and include advanced search parameters without having to go back to the
Advanced Search page.
NOTE
Use a space to separate search words that you enter as text.
4 (optional) Select sources in the Sources panel, using the information provided in
Action
5 (optional) Define one or more value combinations for use as search criteria in the
and Tier 3.
b Click Add Operational to add the search to the search criteria table.
c Select another value (for example, for Tiers 1 and 2 or for Tier 1 only).
d Click Add Operational. Two search values are defined for this section, and
e To delete a value, select the value and click the Delete button.
6 (optional) Click Clear All to clear all the Advanced Search criteria.
7 Click Search.
The Simple Search page opens and displays the search results.
After you have set advanced search parameters, you can select Use Advanced
Search Criteria in the Simple Search page to include advanced search parameters
without having to go back to the Advanced Search page.
Chapter 4
51
52
User Guide
You can search for articles across multiple companies by selecting several
companies in the Organization section.
Table 4-2: Advanced Search parameters (Sheet 1 of 3)
Section
Field
Description
Comments
Search Text
Search
Searches for results that contain This field and the Search field on the
any of the specified terms.
Simple Search page are the same field.
Note: You must provide search criteria in at least one of the Search Text fields. If all of these
General
Sources
Language
Article ID
Knowledge article ID of a
specific article to be searched
for.
Article Status
Source Name
Chapter 4
53
Field
Description
Organization
Company
Companies that are defined for To add companies to the search, select
the knowledge article search.
a company and click Add Company.
Organization/
Department
Region
Comments
Dates
54
User Guide
Site Group
Site
Created Date
Range
Created Date
From
Created Date To
Last Modified
Date Range
Last Modified
Date From
Last Modified
Date To
Search results
Field
Description
Comments
Operational
Categories
Operational
Category Tier 1
Operational
Category Tier 2
Operational
Category Tier 3
Product
Categorization
Product Name
Model/Version
Manufacturer
Business
Services
Business Service
Search results
Search results are displayed in order based on the relevance score, according to
your document viewing permissions. The most relevant result appears at the top
of your results list. The number of search results that match your search criteria is
displayed above the search results list. At the bottom of the list, you can click
Previous or Next to navigate among the result pages.
Chapter 4
55
Knowledge types
Search results are distinguishable by the icon that represents their knowledge type,
as follows:
Icon
Knowledge type
Knowledge base itemA knowledge source that is retrieved from an
existing BMC Remedy AR System form or from an external file system. If
required, BMC Remedy Knowledge Management can keep and manage the
metadata of this source.
For knowledge base items retrieved from an existing BMC Remedy
AR System form, BMC Remedy Knowledge Management can maintain
life-cycle management. See Article life cycle on page 18.
Searchable itemA knowledge source for which BMC Remedy
Knowledge Management does not keep or manage metadata or life cycle.
Search criteriaAccording to the number of times that the search criteria was
found in an article, the number of words in a searched phrase, and the order of
words in a searched phrase.
UseYou indicate that an article is useful to you by clicking the Use button
that is available for that article.
ViewYou open an article for viewing from the search result list.
NOTE
Use and View actions are calculated individually, according to configured settings.
When recalculated for a Published article, the boost parameter is also recalculated
for any Draft article that has been created from the Published article. Therefore, the
relevance of the Draft remains identical to that of the Published article.
56
User Guide
Chapter
Chapter 5
57
Display viewWhen you open articles from search results, the article and the
non-role related article metadata that can be viewed by all users is sown in readonly mode.
When you open the article, only the header and content are displayed. Clicking
the Details tab displays the article in read-only view, even when you have edit
permissions.
The Update Requests tab is never displayed in the Display view. While in the
Display view, you can switch to the Advanced view by clicking the Advanced
View button.
58
User Guide
Table 5-1 presents the functional areas of a knowledge article, and describes what
you can do in each area.
Table 5-1: Knowledge article functional areas (Sheet 1 of 2)
Functional area
Purpose
Note: This bar is displayed only for articles that have a life cycle. You can
also change the article status by using the Status field in the Article
Details tab
59
Purpose
Article ID
Displays the ID that the system generated for the article. The Article ID
prefix is always KBA.
Version
Displays the current version of the article. To see other versions, click the
Links > Revisions link on the Navigation pane.
Authoring Notes
Enables the author to add comments and explanations about the article.
Diary HistoryDisplays the history of all the notes that were written
for the article.
Diary EditorArea in which the author creates new notes.
Note: The Authoring Notes area is available only when the article is open
for editing. To access it, you click Links > Authoring Notes in the
Navigation pane.
Content tab
Displays the article in Display or Modify mode. Click the icon at the right
side of any text box to open a text editor and view the content.
Details tab
Metadata fields
Note: Click the right double arrow to toggle the following field display:
Company and Author and Keywords, or Region and Site Group and
Site. See the BMC Remedy Incident Management User Guide for more
information.
60
User Guide
Purpose
Details tab
Information tabs
Note: The Owner and Owner Group values are set with the user or author
name and group when the article created. Only RKM Admin users can
edit these fields after article creation.
Chapter 5
61
Purpose
Navigation pane (left side)Displays key information and provides search filters.
Links section
Functions section
Consoles section
Bottom of page
Click the appropriate button to perform the following tasks for an article:
62
User Guide
AR administrator
When you change an articles company and a visibility group or groups are
already assigned to the article, the group or groups remain assigned for the new
company. You can change the assignments as described in the following
procedure.
When you change the articles company and no visibility groups are assigned to it,
the article remains with no visibility group for the new company. By default, the
article is accessible to the support groups of the articles assignee and owner.
4 To remove visibility groups, select the visibility group in the table on the left and
click Delete.
Chapter 5
63
in Feedback Details.
6 Click Submit.
The new feedback is added. Notification of the new feedback is sent to the article
assignee and to all users who have the article on their watch list.
You can choose whether to view feedback for all versions of the article or just for
the current version. If you choose to view the feedback for all versions, click on the
version column header to sort the feedback by version.
User Guide
In addition to procedural instructions, this section contains common use cases that
you might typically use when creating relationships between articles. Although
Calbro Services user personas illustrate the use cases, no references are intended
toward specific Calbro Services sample data or real-life users.
In Navigation pane > Knowledge Counts> Update Requests, you can see the
number of update requests for the articles you are permitted to view.
In Navigation pane > Defined Searches> Has Update Requests, you can choose
to see articles with update requests, as follows:
The Knowledge table contains a column that indicates which articles contain
update requests.
The update request table contains all the update requests that are associated
with the selected article in the Knowledge table.
Chapter 5
65
Table 5-3 describes the fields in the New Update Request dialog box and the
Update Request Info dialog box, which you access from the Update Requests tab
when you choose to create or view an update request.
Table 5-3: Update Request dialog box fields
Field
Description
Value type
Drop-down list
Status
Comments
Technical update
Enhancement
Proofreading
Other
NewInitial status. When Drop-down list
a user creates a new
request, its status is New
and the article assignee is
notified.
In Progress
Completed
Rejected
Article Version
Request Summary
Free text
Request Details
Free text
Request Comments
New Comment
Free text
Submitter
Automatically
populated
Submit Date
Automatically
populated
66
User Guide
Ian opens the article and selects the Update Request table. He clicks Create, and the
New Update Request dialog box opens. He enters the extra steps needed for the
solution in the Request Details text field, fills in values for the other fields, and
clicks Save.
The Assignee gets a notification that this specific article has a new update request.
The Assignee logs into the system, opens the KM Console, and sees that the
relevant article has a Yes value in the Update Requests column of the Knowledge
table. The Assignee performs the following steps:
1 Selects the article and sees the update requests in the table field below.
2 Selects that update request and clicks the View icon that is located above the table.
The Update Request Info dialog box opens and displays the update request details.
The Assignee can also choose to select other update requests from the table and
view their details.
The Assignee performs one of the following actions:
The Assignee re-creates the solution steps and verifies that the extra steps are
needed. In the knowledge article, the Assignee accesses the update request and
changes the request status to Completed after adding comments in the New
Comments field.
The Assignee re-creates the solution steps but discovers that steps are not
needed. In the KM Console, the Assignee accesses the update request, changes
the update request status to Rejected, and adds comments in the New
Comments field.
In the KM Console, select the article in the Knowledge table, and then click
Create above the Update Requests table.
In an open knowledge article, click the Details tab, click the Update Requests
tab, and then click Create.
2 In the New Update Request dialog box, provide the appropriate information.
3 Click Save.
Chapter 5
67
In the KM Console, select the article in the Knowledge table, and then click
View above the Update Requests table.
In an open knowledge article, click the Details tab, click the Update Requests
tab, and then click View.
2 Add new comments in the Update Request Info dialog box as follows:
a Enter your comment in the New Comment field.
b Click Add Comments.
3 To enhance your comments, add attachments in the Update Request Info dialog
box as follows:
If you select an attachment in the Attachments table, new buttons are displayed
that enable you to perform additional tasks such as deleting, displaying, and
saving the attachment.
User Guide
NOTE
You need prior knowledge about building qualifiers in BMC Remedy AR System
before you use the Advanced Qualification Builder.
Creating relationships
Follow this procedure to create a relationship between two articles.
X To define a relationship
1 Open an article.
2 Under Quick Actions, click Create Relationship.
TIP
You can select the Details tab, select the Relationships tab, and click the click the
Create icon.
3 In the Search field of the dialog box that opens, type a search string. For example,
if you are creating a relationship to an article about a printer that regularly goes offline, you might type printer off line.
If no search criteria is entered, search results display all articles that you are
permitted to view.
4 Click Search.
5 In the Articles table, select the article to which you want to create the relationship.
The Current Article field displays the ID of the open article that forms the
relationship with the selected article.
6 Click Relate.
7 In the dialog box that displays the relationship, verify the information and click
If the user has a defined Knowledge user role, all related articles except In
Progress articles are displayed. The only location that relationships to In
Progress articles are displayed is in the Relationship tab of the In Progress
article.
Chapter 5
69
If the user does not have a defined Knowledge user role, relationships to only
Published articles are displayed.
When the status of one of the articles in a relationship becomes Cancelled, the
relationship automatically becomes Obsolete and ceases to exist.
Removing relationships
Perform this procedure to remove an existing relationship.
X To remove a relationship
1 Open an article.
2 Click the Details tab.
3 click the Relationships tab.
4 Click the Remove icon.
5 Click Yes to confirm.
6 Click OK.
70
User Guide
Assigning articles
Assigning articles
Articles in the workflow contain assignee information that is relevant for all stages
in the articles life cycle.
The assignee is the person who is responsible for the article at the current stage.
The exact meaning of assignee changes as the article progresses through the life
cycle.
Initial creation
When an article is created, it is automatically assigned to the articles creator.
Review Statuses
The assignee for articles in the various Review statuses is the person who should
review the article.
Knowledge articles can be in a status that requires a review process to promote
the article to the next status. For example, when an article is in the SME Review
status, it requires a subject matter expert to review it to move to the next status.
The next status might be another review (for example, an editorial review) or
Publish Approval status. In certain circumstances, changing the status of an
article automatically changes the assignee.
For more information about review statuses, see Chapter 1, Introducing BMC
Remedy Knowledge Management.
X To assign an article
1 Select the article to be assigned, and select the Update Requests tab.
Chapter 5
71
You select the Assigned Group by Company > Organization > Support Group.
3 From the list, select the new Assignee.
4 Click Save.
The new assignee is notified that the article has been assigned, using the
notification method defined in the email engine.
Automatic assignment
When an article is created, it is automatically assigned to the person who created
it. An article can also be automatically assigned when its status is changed. Auto
Assign is triggered manually when you click an assignment link in the Quick Links
section or change an articles status.
When you change an articles status (by selecting a new status from the list), the
Auto Assign function works as follows:
If the article is in review status, Auto Assign sets the Assigned Group according
to the Assignment Engine method for that status. If no default group has been
defined, the values for Assigned Group and Assignee are copied from the
article's Owner details.
If the article is in any other status, the values for Assigned Group and Assignee
are copied from the article's Owner details.
NOTE
If the article is in one of the review statuses, clicking Assign to me is valid only if
you belong to the current assigned group. If you do not belong to the current
assigned group and you click the link, you receive an error message.
In other statuses, clicking Assign to me sets the Assignee value to your name. The
Assigned Group value does not change if you are a member of that group. If you
are not a member of that group, the default group to which you belong is used.
72
User Guide
Viewing history
BMC Remedy Knowledge Management records the life cycle history of articles.
The recorded data is used by the reporting component to create historical and
statistical reports. Whenever a change is detected during the articles life cycle, a
record is written to the article history form.
Article history is written for the following events:
Article creation
Status change
Assignment change
Chapter 5
73
Update
For the status and assignee change events, an appropriate history record is created
in addition to the Save event record. For each history record, the following
information is shown:
Changed By
Time
Event
For change events, the From and To values of the changed information are also
shown.
User Guide
In the KM Console, select one or more articles and click Add To Watch List.
Open a knowledge article. In the Functions section of the Navigation pane, click
Add To Watch List.
NOTE
When you view the Watch List, the Company and View By fields are disabled.
Group Watch List RulesEnables Knowledge Admin users to add, edit, and
delete rules for any existing support group, including those of which they are
not members. These rules are displayed for and apply to all members of a
support group for which rules have been defined. However, only Knowledge
Admin users can edit and delete these rules.
Chapter 5
75
NOTE
Watch List rules remain until you delete them.
NOTE
A Draft version can also be created from a Closed version. Closed articles can only
be accessed from the Revisions link that is available through the Published
article.
You can modify the following information for Published articles without having to
create a new version:
76
User Guide
Internal use
Assigned group
Assignee
Update request
Article status
Article relationship
Owner group
Owner
Feedback
NOTE
To make a Published article the most recent version, cancel the Draft version of the
article. See Sending cancellation requests on page 77 for more information.
NOTE
The act of sending a request does not affect the current status of the article.
Chapter 5
77
Fill in at least one field in the People Search Criteria section and click Search.
When the search finishes, select the recipients name in the search results
table.
NOTE
If you need help determining the correct name in the list, you can see more
information about an individual by selecting their name from the list, and clicking
View. Doing this opens the People form, which contains detailed information
about the recipient.
Click Select Current Assignee. The current assignees name with contact
information appears in the table.
4 To add multiple recipients, separate the names with a semicolon (;) character. Do
NOTE
You can continue to scroll down the search result list to find additional email
addresses for insertion, or perform a new search. However, selecting a search
result replaces the current email addresses with the selection.
5 Complete the email information fields, as follows:
78
User Guide
Internet E-mailDisplays the recipients email address. When you select the
email recipient, as described in step 3, the Internet email address updates from
the people record.
Email Message BodyContains the URL of the article. You can also type a
message text here, or use the series of buttons to the right of the Email Message
Body field to automatically insert text from the article into the message text, as
follows:
NOTE
If one or more buttons are disabled, the corresponding field in the article contains
no information. The Resolution button is disabled for all articles; it is designated
for future releases.
6 (optional) Attach a single file to the email message, as follows:
a Right-click inside the Email Attachment table.
b Click Add.
c In the Add Attachment dialog box, browse to and select the file that you want
to attach.
For more information about these locations, see Table 5-1 on page 59.
Chapter 5
79
80
User Guide
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
Index
A
customer support 3
accessing search 48
adding attachments 43
adding images 43
adding links 43
Advanced Qualification Builder 37
advanced search 50
advanced search parameters 52
article boost parameter 56
article life cycle 18
article status group 21
assigning article 71
assigning article to myself 72
assigning visibility groups 63
attachments
inserting 43
section at end of solution 43
types 42
audience for this guide 8
auto assign 72
B
BMC Software, contacting 2
breadcrumb bar 13
build search qualification 37
C
cancel request 77
changing status 79
Company and View By fields 33
Counts section 33
creating articles 41
creating decision trees 44
creating feedback 64
creating relationship 68, 69
creating revisions 77
creating update requests 67
current assignee 71
decision trees
creating 44
decision trees, creating 44
Defined Searches 37
Documentation
online help 8
related 9
documentation 8
E
editing knowledge article 45
e-mail knowledge article 78
F
feedback
creating 64
viewing 64
filter by 33
filtering knowledge articles 37
functional areas 32
G
getting started
all knowledge articles 13
KM console 13
search knowledge 13
I
images
about 43
inserting 43
IT Home Page 12
Index
81
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
KM console 65
functional areas 32
working with 31
Knowledge admin 26
knowledge article
adding attachments 42
assigning 71
best practice 36
cancel 77
creating, editing 41
creating, viewing feedback 64
editing 45
filtering 37
functional areas table 59
overview 58
relationship 68
revising 76
searching 47
send by e-mail 78
knowledge articles
working with 57
Knowledge config 26
knowledge search
accessing 48
advanced 50
guidelines 49
overview 48
result 55
simple 50
Knowledge submitter 26
knowledge table 35
Knowledge user 26
Knowledge viewer 26
life cycle 18
links
about 43
inserting to an external URL 43
search
article boost parameter 56
best practice 50, 52
criteria 56
guidelines 49
knowledge articles 47
performing advanced 50
performing simple 50
results 55, 56
special characters 49
sensitivity
example 25
levels 25
using 25
M
manage my searches 33
managing Watch List rules 75
modify my profile 38
my profile 38
My Searches 37
82
User Guide
O
Online help 8
P
performing advanced search 51
performing simple search 50
permissions
changing status 25
user 25
preface 7
product support 3
profile, viewing 38
Q
quick action 34
R
receiving notifications 38
relevant search result 56
removing relationship 70
requesting article cancellation 77
review dates 73
revising knowledge article 76
roles 25
roles and privileges table 26
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
setting current assignee 71
setting review dates 73
show 33
simple search 50
solutions
creating decision trees 44
special search characters 49
status
bar group 21
changing 79
group 21
transition workflows 24
type 21, 22
support, customer 3
T
technical support 3
toolbar, editing 42
transition workflows 24
U
update requests
best practice 66
creating 67
update requests table 35
user
privileges 25
roles 25
V
view my profile 38
viewing feedback 64
viewing related articles 69
viewing review dates 73
viewing update requests 68
visibility groups 30
assigning 63
W
Watch List
best practice 74
rules 75
task 75
working with 74
working with knowledge article 57
Index
83
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
84
User Guide
*193766*
*193766*
*193766*
*193766*
*193766*