Implementation Overview

This chapter covers the following topics:

About Implementation

This chapter provides an overview of how to access Oracle Knowledge Management, the associated job roles and process flows, and a summary of the implementation tasks.

Access Control

In Oracle Knowledge Management, function and menu security control user access to the agent pages. The following sections discuss the setup of these security features.

Roles and permission control customer pages. For a list of permission that control Oracle Knowledge Management page access, see Roles and Permission. For related information, see the Oracle iSupport Implementation and Administration Guide.

Topics in this section include:

Set Up Function Security and Menu Security

You can use function security to restrict user access to certain functions and actions in agent pages in Oracle Knowledge Management. An administrator also has the option of setting menu security. Menu security is a security setting that prevents user access to entire menus and submenus within Oracle Knowledge Management. You define both function security and menu security attributes at the Responsibility level.

For more information, see the Oracle Applications System Administrator's Guide - Security.

The following table shows responsibilities, menus, and tabs that pertain to internal, agent Oracle Knowledge Management users. For customer-facing users, see the Oracle iSupport Implementation and Administration Guide.

Responsibilities, Menus, and Tabs for Internal Users
Responsibility Functional Role Description Menus Tabs Subtabs
CS_KB_SYS_ADMIN Knowledge Administrator Sets up Oracle Knowledge Management system, such as knowledge base structure, security, and authoring flows for Oracle Knowledge Management users. CS_KB_TOP_MENU Knowledge, Authoring, and Setup Knowledge: Search, Statements.
Authoring: Solutions in Progress, Recommended Solutions, Subscriptions.
Setup: Categories, Security, Repositories, Authoring Flows, Types, Autolinks, Time Periods, Concurrent Requests.
CS_KB_KNOWLEDGE_WORKER Knowledge Worker Creates, edits, and reviews technical information in Oracle Knowledge Management. CS_KB_TOP_KW_MENU Knowledge, Authoring Knowledge: Search, Statements.
Authoring: Solutions in Progress, Recommended Solutions, Subscriptions.
CS_KB_AGENT Customer Service Agent Interacts with customers to record their problems and provides them existing solutions or creates new solutions. Note: The Responsibility for agent can be the Responsibility of the applications that integrate with Oracle Knowledge Management, such as Service Agent, or Depot Repair User. CS_KB_TOP_AG_MENU Knowledge: Search. Authoring: Solutions in Progress, Subscriptions

About Accessing Agent Pages

To access agent pages, use the Self-Service login (for example, PHP) instead of jtflogin.jsp.

Oracle Knowledge Management responsibilities must be of type Self-Service. Otherwise, jinitiator invokes when you start Oracle Knowledge Management.

Menus

Oracle Knowledge Management has the following types of menus:

The following table shows a list of menus for Oracle Knowledge Management.

Oracle Knowledge Management Menus
System Name Menu Description
CS_KB_TOP_MENU Knowledge Admin Root Menu Responsibility menu for Oracle Knowledge Management Admin Responsibility
CS_KB_TOP_KW_MENU Knowledge Worker Root Menu Responsibility menu for Oracle Knowledge Management Knowledge Worker Responsibility
CS_KB_TOP_AG_MENU Knowledge Agent Root Menu Responsibility menu for Oracle Knowledge Management Agent Responsibility
CS_KB_HOMEPAGE KM Home Page Navigation menu for Oracle Knowledge Management
CS_KB_KNOWLEDGE_TAB KM Knowledge Tab Navigation menu for Knowledge tab
CS_KB_AUTHORING_TAB KM Authoring Tab Navigation menu for Authoring tab
CS_KB_ADMIN_TAB KM Administration Tab Navigation menu for Setup tab
CS_KB_SECURITY_TAB KM Security Setup Tab Navigation menu for Security subtab
CS_KB_TYPES_TAB KM Type Setup Tab Navigation menu for Types subtab
CS_KB_AUTOLINK_TAB KM Autolink Setup Tab Navigation menu for Autolinks subtab
CS_KB_SMS_MENU KM Administrator Security Menu Security menu for Oracle Knowledge Management Admin
CS_KB_SMS_KW_MENU KM Knowledge Worker Security Menu Security menu for Oracle Knowledge Management Knowledge Worker
CS_KB_SMS_AG_MENU KM Agent Security Menu Security menu for Oracle Knowledge Management Agent
CS_KB_SMS_SEARCH_AG_MENU KM Knowledge Security Menu Security menu for Knowledge tab
CS_KB_UNISRCH_GRANT KM Unified Search Security Menu Security menu for Simple Search
CS_KB_VIEW_GRANT KM View Solution and Statement Security Menu Security menu for Solution and Statement Details
CS_KB_ADVSRCH_GRANT KM Advanced Search Security Menu Security menu for Advanced Solution Search
CS_KB_STMT_SRCH_GRANT KM Statement Search Security Menu Security menu for Statement Search
CS_KB_SMS_SOLUTION_KW_AG_MENU KM Authoring Security Menu Security menu for Authoring tab
CS_KB_WIP_GRANT KM In Progress Solution Security Menu Security menu for Solutions in Progress
CS_KB_SOLUTION_CREATE_GRANT KM Create or Update Solution Security Menu Security menu for Create/Update Solution
CS_KB_STMT_CREATE_GRANT KM Create or Update Statement Security Menu Security menu for Create/Update Statement
CS_KB_REC_SOLN_GRANT KM Recommended Solutions Security Menu Security menu for Recommended Solution Setup
CS_KB_SMS_SETUP_MENU KM Admin Setup Security Menu Security menu for Setup tab
CS_KB_CATEGORY_SETUP_GRANT KM Category Setup Security Menu Security menu for Category Setup
CS_KB_CAT_GRP_SETUP_GRANT KM Category Group Setup Security Menu Security menu for Category Security Group Setup
CS_KB_VIS_SETUP_GRANT KM Visibility Setup Security Menu Security menu for Visibility Setup
CS_KB_REPOSITORY_SETUP_GRANT KM Repository Setup Security Menu Security menu for search repository setup
CS_KB_AUTOLINK_SETUP_GRANT KM Autolink Setup Security Menu - Security menu for Autolink setup

Functions

For example, if you have defined your own menu for your own responsibility, and you would like to allow a user to access Oracle Knowledge Management, you can include KM Agent Security Menu as a submenu of your new menu such that users who have this new responsibility can perform activities that Oracle Knowledge Management agents can.

The following table shows the functions that you can use to establish function security in Oracle Knowledge Management.

Oracle Knowledge Management Functions
System Name Menu Description
CS_KB_SMS_SOLN_ASEARCH_FN CS_KB_SMS_SOLN_ASEARCH_FN Controls access to Advanced Solution Search.
CS_KB_SMS_SOLN_AUDITCREATE_FN CS_KB_SMS_SOLN_AUDITCREATE_FN Controls access to Create Solution button.
CS_KB_GET_LOCK_FN CS_KB_GET_LOCK_FN Controls access to Get Lock button.
CS_KB_GLOBAL_UPDATE_FN CS_KB_GLOBAL_UPDATE_FN Controls access to Update button from Statement Search.
CS_KB_REC_SOL_ADD_FN CS_KB_REC_SOL_ADD_FN Controls access to update Recommended Solutions.
CS_KB_CATEGORY_DETAIL_FN CS_KB_CATEGORY_DETAIL_FN Controls access to update Category.

If you do not want to grant certain functions to a particular responsibility, then you can exclude the functions from that responsibility. For more information, see Oracle Applications System Administrator's Guide.

Job Roles and Process Flows

Topics in this section include:

About Process Flows and Associated Job Roles

The process flows that this section describes provide you with a general, high-level understanding of the tasks that Knowledge Administrators, Knowledge Workers, and end users perform in Oracle Knowledge Management.

The following table provides a cross reference of the process flows and the associated job roles.

Note: Customer Service Agents perform many of the same tasks in Oracle Knowledge Management as Knowledge Workers, but typically have a more limited scope in the Solution Authoring process.

Job Roles and Process Flows Matrix
Process Flows Knowledge Administrator Flows Knowledge Worker Flows Customer Service Agent End User Flows
Create Authoring Flows YES NO NO NO
Manage the Knowledge Base Structure YES NO NO NO
Set Up Category Security Groups YES NO NO NO
Set Up Repositories YES NO NO NO
Set Up Autolinks YES NO NO NO
Create Top Solutions for Oracle YES YES NO NO
Author Solutions YES YES YES NO
Review Solutions in Progress YES YES NO NO
Update a Solution YES YES YES NO
Search the Knowledge Base - - - -
Conduct a Simple Search YES YES YES YES
Browse Solution Categories YES YES YES YES
Conduct an Advanced Solution Search YES YES YES YES
Search for Statements YES YES NO NO
View Top Solutions in Oracle iSupport NO NO NO YES

Knowledge Administrator Flows

The flows that appear in this section are primary responsibilities of the knowledge administrator. The primary functions that knowledge administrators perform in Oracle Knowledge Management include:

Manage the Knowledge Base Structure

The knowledge base structure provides the basis for partitioning information in the knowledge base. Its main components are solution types, statement types, and solution categories. The following flow diagrams show the tasks that you perform to set up the knowledge base structure.

Note: Designing the knowledge base structure is a very important aspect of implementing Oracle Knowledge Management. After adding solutions to the solution types, it is difficult to change the knowledge base structure.

Set Up solution types and Statement Types

solution types and statement types provide a structure for organizing the type of information that comprises solutions and statements in the knowledge base. The following figure is a flow diagram that shows the parallels in creating and maintaining solution types and statement types.

Setting Up the Solution Types and Statement Types

the picture is described in the document text

Although you create solution types and statement types separately, both are interrelated. You should design them in conjunction with the other:

When the knowledge administrator designs the solution types and statement types, he or she must create the actual structures:

To manage the knowledge base, the knowledge administrator must also know how to:

Set Up Solution Categories

Solution categories are folders that you use to sort solutions into logical groupings. The following figure shows a flow diagram of designing, creating, and deleting solution types.

Setting Up Solution Categories

the picture is described in the document text

Setting up and maintaining solution typeies involves:

Set Up Category Security Group

Category Security Groups are defined views of categories that determine whether or not a particular user can access a category, solution, and statement. Category Security Groups are subsets of the master category hierarchy and represent subject areas. After you define the master category hierarchy, you must also define the views--the Category Security Groups--of the master category hierarchy.

Create Authoring Flows

You use authoring flows to automate the review and publication of solutions in the knowledge base. Knowledge administrators create authoring flows. The following figure shows the process to create authoring flows:

Creating Authoring Flows

the picture is described in the document text

Creating an authoring flow includes:

Set Up Repositories

A repository resides on a file server or internal Web site and defines a collection of documents that can be searched.

Setting up repositories includes:

Set Up Autolinks

Whenever a knowledge worker views a solution that contains a reference to an autolink's specified keyword, the reference appears as a hyperlink.

Setting up autolinks includes:

Knowledge Worker Flows

The primary tasks that knowledge workers perform in Oracle Knowledge Management include:

Author Solutions

Solutions are the cornerstone of the knowledge base. knowledge workers are generally responsible for managing content in the knowledge base.

The following figure shows the tasks that you use to create a solution.

Authoring a Solution

the picture is described in the document text

The tasks to consider for authoring solutions include:

Review Solutions in Progress

A critical responsibility of a knowledge worker is authoring and reviewing solutions. The following figure shows that tasks that are associated with reviewing a solution.

Reviewing Solutions in Progress

the picture is described in the document text

The tasks to review a solution include:

Update a Solution

Knowledge Workers can also update an existing or published solution. The Updating an Existing Solution figure shows tasks that you perform to update an existing solution.

Updating an Existing Solution

the picture is described in the document text

Updating an existing solution includes:

Search the Knowledge Base

Knowledge Workers frequently must search the knowledge base to maintain its relevancy. As part of this process, the Knowledge Worker must determine the search criteria and subject matter and which type of search to conduct. Oracle Knowledge Management offers several ways to search the knowledge base.

Note: All users of Oracle Knowledge Management perform at least a subset of these search functions.

The following table shows the types of searches, the usage, and the objectives or results that are available in Oracle Knowledge Management.

Searches in the Knowledge Base
Search Type Usage Objectives or Results
Perform a Simple Search Knowledge Administrator
Knowledge Worker
Customer Service Agent
End User
Keyword Test
Published Solutions
Published Solutions
Multiple Repositories
Service Requests
Perform an Advanced Solution Search Knowledge Administrator
End User
Knowledge Worker
Customer Service Agent
Related Statements
Matching Statements
Ability to Add Filters
Published Solutions
Search Solutions in Progress Knowledge Worker Solutions in Progress
Search for Statements Knowledge Administrator
Knowledge Worker
Published Statements

You can search the knowledge base using different search criteria:

Create Top Solutions for Oracle iSupport Users

Knowledge workers can designate certain solutions as Recommended. Recommended solutions are a list of particularly worthy or desirable solutions for users to view. For example, solutions that are on this list may include fixes for a recently discovered product problem. Users who navigate to the Top Solutions tab in Oracle iSupport can view a listing of recommended solutions as well as a list of frequently used solutions. Frequently Used Solutions is a separate list of solutions based on usage counts.

Top Solutions: Recommended Solutions List

The Recommended Solutions list shows solutions that the knowledge worker chose to show in Oracle iSupport.

Note: A knowledge worker often adds recommended solutions.

The following figure and the following list show or describe the tasks that a knowledge worker performs to manage the lists on the Top Solutions tab.

Creating Recommended Solutions for Oracle iSupport Users

the picture is described in the document text

Top Solutions: Frequently Used Solutions List

The Frequently Used Solutions list is based on usage counts. You can change the view for these counts by specifying a new date range from a list. You specify and create these date ranges or definitions in Oracle Knowledge Management. In addition, you specify the default view or date range in Oracle Knowledge Management.

The following figure is a flow diagram that shows the sequence of creating definitions for Frequently Used Solutions for Oracle iSupport users.

Define Time Periods for Frequently Used Solutions for Oracle iSupport

the picture is described in the document text

Creating definitions for Frequently Used Solutions for Oracle iSupport Users includes:

Implementation Tasks

The following table shows the setup steps that you must complete to implement Oracle Knowledge Management. These steps are in addition to Installation and Dependency Verification.

Implementation Tasks
Task Reference Mandatory or Optional Setup
Prerequisites or Implement Mandatory Dependencies Before You Begin Mandatory Forms
Create Users and Resource Groups Create Users and Resource Groups Mandatory Forms
Set Up Repositories Set Up Repositories Optional Oracle Knowledge Management
Set Up Security Set Up Security Mandatory Oracle Knowledge Management
Set Up Knowledge Base Structure Set Up the Knowledge Base Structure Mandatory Oracle Knowledge Management
Set Up Authoring Flows Set Up Authoring Flows Mandatory Oracle Knowledge Management
Set Profile Options Set Profile Options Optional Forms
Set Up Autolinks Set Up Autolinks Optional Oracle Knowledge Management
Additional Steps Additional Integration Setups Optional Forms or Oracle Knowledge Management
Import Solutions Import Solutions Optional Forms
Set Up Top Solutions for Oracle iSupport Users Set Up Top Solutions for Oracle iSupport Users Optional
Note: You must have either added or imported solutions into the knowledge base to perform this setup.
Oracle Knowledge Management