This documentation supports the 9.1 version of Knowledge Management.

To view the latest version, select the version from the Product version menu.

KCS forms and escalations in version 9.1.01

BMC Knowledge Management provides support for Knowledge-Centered Support (KCS) functions that are performed from BMC Remedy with Smart IT (Smart IT) and BMC Remedy Smart Reporting. Several back-end forms and escalations provide KCS support. 

This topic provides the following information:

Tip

Press  F to view the tables in full-screen mode. Press Esc to exit the full screen mode.

Forms in BMC Knowledge Management for KCS support

The back-end forms in BMC Knowledge Management contain transactional or computational data. This data serves as an input to Smart IT for performing KCS functions and to BMC Remedy Smart Reporting for viewing KCS reports. These forms are not visible from the BMC Knowledge Management application.

The following table lists the back-end forms for KCS support:

Form nameDescription
Transactional or data forms
RKM:KCS:PAQ_Answers

Contains the following information:

  • Answers for performance assessment questions from the Article Quality Index (AQI) assessment.
    A KCS Coach performs AQI assessment of articles to monitor and measure performance of knowledge authors.
  • Temporary fields that contain the login IDs of KCS Coaches and knowledge authors to help identify the relationship between them.

This form is used to compute the overall score for AQI assessment.

RKM:KCS:ArticleStatusHistory

Contains data about the time an article is in each status. When article status or assignment changes, a record is created in this form.

This form is used by BMC Remedy Smart Reporting to create a KCS report.

RKM:KCS:ArticleViewHistory

Contains data for identifying which article from the search result is already read by a user in the current session.

In Smart IT, after a user views an article from the search result, the color of the link changes to indicate that the user has already read the article.

RKM:KCS:TemplateContains data for KCS articles created from the KCS template. This new article template form for the KCS template works like all other article template forms.
Report data forms for creating KCS reports in BMC Remedy Smart Reporting
RKM:KCS:PAQ_AQI
_DailySummaryByAuthor

Contains AQI assessment data per user per day, for each question answered during an AQI assessment. A KCS Coach performs AQI assessment of articles to monitor and measure performance of knowledge authors. The data in this form is created or updated daily when escalations run.

RKM:KCS:PAQ_AQI
_DailySummaryByAuthorAndQuestion

Contains AQI assessment data per user per day. A KCS Coach performs AQI assessment of articles to monitor and measure performance of knowledge authors. The data in this form is created or updated daily when escalations run.

RKM:KCS:ParticipationRates

Contains participation rate data per user per day. Participation rate is the proportion of incidents that a user closes by using knowledge articles, compared to the total number of incidents that the user closes. The data in this form is created or updated daily when escalations run.

RKM:KCS:UserCitation

Contains citation count data, which is the number of times knowledge articles created by each knowledge author are attached to incident tickets. The data in this form is created or updated daily when escalations run.

RKM:KCS:RadarChart

Contains final radar chart metrics, which are computed by using the citation count, participation rate, average number of incidents handled, and AQI data. The form contains one record per user per month. The data in this form is created or updated daily when escalations run.

RKM:KCS:EscalationTrigger

A computational form that computes radar chart metrics. All computations are done on this form, and the final data is pushed to RKM:KCS:RadarChart form. This form contain the following information:

  • This form contains the following information:
    • An out-of-the-box entry with 'Article_Keywords' = "System"AND 'Status' = "<Value>", where <Value> is set as follows:
      • Offline—for fresh installation of BMC Knowledge Management 9.1.01 or when upgrading from version prior to 9.1.
      • Value specified in version 9.1—when upgrading from version 9.1.
      The value of the Status field is used to enable or disable the RKM:KCS:RadarData_Compute escalation. For more information about how the escalation is enabled, see Escalations for KCS Support.
      Important: Do not modify or delete the out-of-the-box entry in this form. Modifying or deleting the entry will result in errors in running associated escalations.
    • LastSuccessful_ModifiedDate — a field that contains the date on which the RKM:KCS:RadarData_Compute escalation last ran. For more information about how the escalation runs, see  Escalations for KCS Support.
    • A flag that identifies modified information about KCS Coaches and knowledge authors, when the relationship between them changes.
Configuration or template forms
RKM:KCS:PAQ_QuestionSet

Contains AQI question set data for performing AQI assessments. This form defines the company or support organization level to which a particular question set is applicable.

A KCS Coach creates a question set from the Smart IT interface.

RKM:KCS:PAQ_Questions

Contains the AQI questions and other data  such as desirable answers, weighting value for undesirable answers, and so on.

While some out-of-the-box questions are provided, a KCS Coach can add or update questions from the Smart IT interface.

RKM:KCS:PAQ_QuestionsLocalizedText

Contains localized descriptions and other data for AQI questions. This form contains one record for each locale per AQI question.

RKM:KCS:PAQ_QuestionSetMapping

Contains data about the mapping between an AQI question set and its questions.

RKM:KCS:CoachCoacheeRelationship

Contains the following information:

  • Data about the relationships between a KCS Coach and the knowledge authors whom the KCS Coach coaches.
  • A flag that suggests change in relationship between a KCS Coach and knowledge authors.

RKM:KCS:RadarGoals

Contains a predefined goal value for each metric in the radar chart report, for each company.

Only a KCS Coach can update and further define the goal values for each support company or organization by accessing this form from BMC Remedy Mid Tier.

Data management forms
RKM:LoadKCSTemplateEnables creation of knowledge article from KCS template using the Data Management tool.
RKM:LoadKCSTemplate_Join
Join forms and other miscellaneous forms

RKM:KCS:KAM_KAMExtension_Join

Contains combined data from the Knowledge Article Manager and its extension forms. The data serves as an input to Smart IT.

HPD:HelpDesk_HPDAssociations
_OuterJoin

Contains combined data from HelpDesk and HPDAssociations forms. The data serves as an input to Smart IT.

RKM:KCS:PAQ_QSetMapping
_Question_join

Contains combined data of an AQI question set and AQI questions.

RKM:KCS:PAQ_QSetMapping_Question
_LocalizedText_join

Contains combined data of an AQI questions set, AQI questions, and AQI localized question data.

RKM:KCS:KAM
_CoachCoacheeRelationship_Join

Contains combined data of a KCS Coach, knowledge authors whom the KCS Coach coaches, and additional data that serves as an input to Smart IT.


RKM:KCS:CoachCoachee
_PPL_SGA_SG_PermGrp_Join

RKM:KCS:CoachCoachee_PPL
_SGA_SG_PermGrp_PPL_Join_PPL_Join
RKM:KCS:Template_Manageable_JoinSupports creation of knowledge articles from the KCS template using the Data Management tool.

Escalations for KCS Support

The KCS reports analyze knowledge author performance based on the following performance metrics:

  • Participation Rate
  • Article Quality Index (AQI)
  • Citation Count
  • Average Incidents Handled

To compute the data required for these report, an escalation, RKM:KCS:RadarData_Compute, runs daily to compute the data for all metrics required for the KCS reports. Details of the escalation are as follows:

Escalation nameMetric nameDefault time when escalations run

RKM:KCS:RadarData_Compute

  • Citation Count
  • Participation Rate
  • AQI
  • Average Incidents Handled
02:00 a.m

The escalation has the following features:

  • The version-specific status of the escalation is listed in the following table:

    BMC Knowledge Management 9.1.01 installation or upgradeStatus of escalationHow to enable the escalation?
    Fresh installationOffline
    • When installing Smart IT 1.5 after BMC Knowledge Management, the escalation is enabled.
    • For any version prior to Smart IT 1.5, manually enable the escalation, if not already enabled.
    Upgrade from version 9.1The status from version 9.1 is retained
    Upgrade from pre-9.1 versionOffline

  • RKM:KCS:RadarData_Compute computes data as follows:

    • For the first time after installation, the escalation computes data from the previous day. It includes the data that was generated from the time the system was functional.

    • From the second time onwards, the escalation computes data from the last successful run date. So, if the escalation does not run on a particular day due to outage, the next time it runs, it includes the data generated during the outage.The following example explains how the escalation prevents data loss:

      Example

      The RKM:KCS:RadarData_Compute escalation runs daily at midnight. Consider that the sequence of events was as follows:

      • On March 01, 2016, the escalation ran at 02:00 a.m.
      • On March 02, 2016 and March 03, 2016, because of a system failure, the escalation did not run.
      • On March 04, 2016, the system failure was resolved, and the escalation ran at 02.00 a.m.

      When the escalation ran on March 04, 2016, it computed data from the previous timestamp, that is from 02:00 a.m. on March 01, 2016 to 01:59 on March 04, 2016. So, it included the data for March 02, 2016 and March 03, 2016, thereby ensuring no data was lost.

Existing forms updated for KCS support

The following table lists the existing BMC Knowledge Management forms that have been updated for KCS support, important new fields added to the forms, and corresponding permissions:

Form nameNew fieldsField-level permissions for new fieldsForm-level permissions
Transactional or data forms
RKM:ArticleHistory
  • Changed By Support Company (302308991)

  • Changed By Support Org (302309001)

  • Changed By Support Grp (302309011)

  • Changed By Department (302309021)

Public: ChangePublic: Hidden
RKM:KAMExtension
  • CreatedFromINC (302308691)
  • Use_Counter (302311190)
  • Public: View
  • KCS Candidate, KCS Contributor, KCS Publisher, KCS Coach: Change
  • Knowledge Admin, Knowledge Submitter, Knowledge User, Knowledge Viewer: Change
Public: Hidden
RKM:UpdateRequests
  • PPL_Company (302309151)
  • Organization (1000000010)
  • Department (200000006)
  • SupportCompany (302300585)
  • SupportOrganization (302300586)
  • SupportGroup (302300512)
  • ContributorName (302300513)
  • ArticleAssigneeLoginID (302308831)
  • Article_UnflagTime (302308961)
  • ArticleAssignee_Company (302308861)
  • ArticleAssignee_Group (302308851)
  • ArticleAssignee_Name (302308841)
  • ArticleAssignee_Department (302308951)
  • BusinessResponseTime(Sec (302308881)
  • BusinessTimeWarningMessage (302308891)
Public: ChangePublic: Hidden
RKM:Associations
  • ArticleStatus (302300529)
  • Submitter Name (302300513)
  • Public: View
  • KCS Candidate, KCS Contributor, KCS Publisher, KCS Coach: Change
  • Knowledge Admin, Knowledge Submitter, Knowledge User, Knowledge Viewer: Change
Public: Hidden
Join or miscellaneous forms
RKM:ArticleHistory_Join
  • Changed By Support Company (302308991)
  • Changed By Support Org (302309001)
  • Changed By Support Grp (302309011)
  • Changed By Department (302309021)
Public: ChangePublic: Hidden
RKM:AssociationKAM_Join
  • ArticleAuthor (302300527)
  • ArticleAuthorLoginID (302311139)
  • Submitter Name (302300513)
  • Public: View
  • KCS Candidate, KCS Contributor, KCS Publisher, KCS Coach: Change
  • Knowledge Admin, Knowledge Submitter, Knowledge User, Knowledge Viewer: Change
Public: Hidden
RKM:ConfigurationPAErrorWeightingFactor (302308821)
  • Public: View
  • Knowledge Config: Change
  • KCS Coach: Change
  • KCS Coach: Visible
  • Knowledge Admin, Knowledge Submitter, Knowledge User, Knowledge Viewer, Knowledge Config: Visible

Was this page helpful? Yes No Submitting... Thank you

Comments