This documentation supports the 23.3 version of BMC Helix ITSM: Knowledge Management.To view an earlier version, select the version from the Product version menu.

Data dictionary


BMC Helix ITSM: Knowledge Management requires that you use different forms to perform certain KCS actions.

Related topics

KCS forms and escalations

BMC Helix ITSM: Knowledge Managementprovides support for Knowledge-Centered Service (KCS) functions that are performed from BMC Helix ITSM: Smart IT and BMC Helix ITSM: Smart Reporting by using back-end forms and escalations. 

Forms in BMC Knowledge Management for KCS support

The back-end forms added to BMC Helix ITSM: Knowledge Managementcontain transactional or computational data. This data serves as input to BMC Helix ITSM: Smart ITfor performing KCS functions and to BMC Helix ITSM: Smart Reportingfor viewing KCS reports. These forms are not visible from the BMC Helix ITSM: Knowledge Managementapplication.

The following table lists the KCS forms:

Form name

Description

Transactional or data forms

RKM:KCS:PAQ_Answers

Contains the 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.

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 Smart Reporting to create a KCS report.

RKM:KCS:ArticleViewHistory

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

In BMC Helix ITSM: 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:Template

Contains data for KCS articles created from the KCS template. This article template form for the KCS template works like all other article template forms.

Report data forms for creating KCS reports in 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

Computes radar chart metrics. All computations are done on this form, and the final data is pushed to the RKM:KCS:RadarChart form. This form contains one out-of-the-box entry with 'Article_Keywords' = "ITSM_RKM_KCS" AND 'Status' = "offline", which is used by escalations. To use this feature, ensure that you enable the entry by modifying the entry to 'Status' = "Enabled".


Important: Do not modify values of other fields or delete the out-of-the-box entry in this form. Modifying the values of other fields or deleting the entry will result in errors in running associated escalations.

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 data about the relationships between a KCS coach and the knowledge authors whom the KCS coach mentors.

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 Mid Tier.

Data management forms

RKM:LoadKCSTemplate

Enables creation of a knowledge article from KCS template by 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 BMC Helix ITSM: Smart IT.

HPD:HelpDesk_HPDAssociations
_OuterJoin

Contains combined data from HelpDesk and HPDAssociations forms. The data serves as input to BMC Helix ITSM: 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 input to BMC Helix ITSM: 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_Join

Supports creation of knowledge articles from the KCS template by using the Data Management tool.


Escalations for KCS support

The RKM:KCS:RadarData_Compute escalation runs daily after midnight to compute the following metrics required for the KCS reports.

  • Citation Count
  • Participation Rate
  • Article Quality Index
  • Radar Chart

If required, you can change the time at which the escalation is run. The escalation uses the data for the previous 24 hours when it runs for the first time. For subsequent runs, the escalation uses the data since the last successful execution to compute different metrics.

Existing forms updated for KCS

The following table lists forms for KCS support, important fields, and corresponding permissions:

Form name

Fields

Field-level permissions for fields

Form-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: Change

Public: 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: Change

Public: 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: Change

Public: 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:Configuration

PAErrorWeightingFactor (302308821)

  • Public: View
  • Knowledge Config: Change
  • KCS coach: Change
  • KCS coach: Visible
  • Knowledge Admin, Knowledge Submitter, Knowledge User, Knowledge Viewer, Knowledge Config: Visible