This documentation supports the 18.05 version of Knowledge Management.

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

Creating a configuration file for conversions

If you need to convert knowledge articles from a third-party application to a format that can be used by BMC Knowledge Management, you can create a configuration file. For more information, see Converting articles from external file formats.

Using a text editor, such as Notepad, create a config.properties file. Depending upon your requirements, you can provide parameters to configure the Article Conversion Tool. This topic describes the various parameters that you can use:

Terms used in this topic

This topic uses the following terms to explain the format of parameter values that you must use in the config.properties file:

  • dataLocation—Location of the required information in the original knowledge articles. The location can be mapped to specific fields in BMC Knowledge Management. Depending on the file format, its value can change:
  • Custom XML files—Specify the name of the custom XML tag that contains the required information. Alternatively, you a tag attribute might contain the required data.
    For more information, see Custom XML tag attributes.
  • HTML files—Specify the tag address within the HTML file that contains the required information
    For more information, see HTML tag addresses.
  • (fixedValue)—Fixed text value. If the parameter value format includes both the data location and the fixed text value, then the fixed text value is used only if the specified dataLocation does not exist in a particular source knowledge article, or if it does not contain a value.

    Note

    Fixed text values must be enclosed in parentheses, as shown in the Value format column of the tables in this topic.

Custom XML tag attributes

For Custom XML files, you can set parameter values to tag attributes. The following rules apply when you define tag attributes in the configuration file:

  • Enclose the attributes in square brackets.
  • Add the attributes after the tag name.
  • Specify the values of the attributes using the equal ( =) sign
  • Separate the attributes with semicolons ( ).

Example

CTI.category = (tier one),category[id=Tier1;type=operation]

In this example,

  • tier one is the fixed value.
  • category is the name of the Custom XML tag that contains the information.
  • id and type are the names of the Custom XML tag attributes.
  • Tier 1 and operation are the values of the respective tag attributes.

Note

You can convert multiple articles at a time however, the Conversion Utility tool supports converting one article per Custom XML file. If there are multiple articles in a single Custom XML file, you must first split each article into a single Custom XML file, and then proceed with the conversion.

HTML tag addresses

The tag address refers to the exact location of a tag in an HTML file.

Example

Title=/HTML/BODY/P[2]/,/HTML/HEAD/TITLE

In this example, the topic title is located in the second paragraph (second <P> tag), which is enclosed within the <BODY> tag, which is enclosed within the <HTML> tag in the HTML source file. 

An alternative tag address is provided after a comma, wherein the topic title is located within the <TITLE> tag, which is enclosed within the <HEAD> tag, which is enclosed within the <HTML> tag in the HTML source file.

Login and common parameters

The parameters in the following table are used to provide basic information about the knowledge articles source files.

Parameter

Description

Value format

Mandatory

ARUser

User name for the BMC Remedy AR System Server administrator.

(tick)

ARPassword

Password for the ARUser.

(tick)

inputPathLocation of the article to be converted. 

(tick)

imageIdentifier

Prefix that is used in the original knowledge articles to identify image file paths. The prefix be followed by a forward slash ( / ).

When the Article Conversion Tool encounters an image identifier it uses the information that follows the forward slash to scan the directory for the referenced file.

imageIdentifier/

(error)

imagesPath

Location of the image files that are used by the original knowledge articles.

(error)

attachmentsPath

Location of the attachments in the original knowledge articles

(error)

attachmentIdentifier

Prefix that is used in the original knowledge articles to identify attachment file paths. The prefix must be followed by a forward slash ( / ).

When the Article Conversion Tool encounters an attachment identifier it uses the information that follows the forward slash to scan the directory for the referenced file.

attachmentIdentifier/

(error)

ARServer

Host name of the BMC Remedy AR System Server.

(tick)

webServer

Host name of the BMC Remedy Mid Tier.

(tick)

webPort

Port number used to communicate with the BMC Remedy Mid Tier.

(tick)

apiPort

Port number used by APIs to communicate with the BMC Remedy AR System Server.

(error)

httpProtocol

Indicates whether the hyperlinks in the original knowledge articles use HTTP or the HTTPS.

(tick)

KBurlIdentifier

Prefix that is used in the original knowledge articles to identify hyperlinks to other knowledge articles. The prefix be followed by a forward slash ( / ).

When the Article Conversion Tool encounters a knowledge article URL identifier it uses the information that follows the forward slash to scan the directory for the referenced knowledge article source file.

KBurlIdentifier/

(error)

Metadata parameters

Identify this section of the configuration file by adding the [metadata] tag. These parameters predefine metadata field values that will be mapped to the converted knowledge articles.

Tip

For a better reading experience, press F to view the following table in full screen mode. Press Esc to exit full screen mode.

The following table lists the metadata parameters that you can add to the configuration file.

Parameter

Description

Value format

Mandatory

ownerGroup

Name of the support group to which the knowledge article's owner belongs. The group must already be registered in the BMC Remedy AR System database.

(fixedValue),dataLocation

(tick)

ownerGroupId

Group ID of the support group to which the knowledge article's owner belongs.

(fixedValue),dataLocation

(tick)

owner

Full name of the BMC Remedy AR System user who owns the knowledge article; can be the author or another user.

Specify First Name and Last Name, separated by a space. For example, Allen Allbrook.

(fixedValue),dataLocation

(tick)

ownerId

Login name of the BMC Remedy AR System user who owns the knowledge article; can be the author or another user.

For example, Allen.

(fixedValue),dataLocation

(tick)

KMS_author

Full name of the BMC Remedy AR System user who created the knowledge articles.

Specify First Name and Last Name, separated by a space. For example, Bob Baxter.

(fixedValue),dataLocation

(tick)

authorId

Login name of the BMC Remedy AR System user who created the knowledge article.

For example, Bob.

(fixedValue),dataLocation

(tick)

KMS_assigned

Login name of the BMC Remedy AR System user to whom the knowledge article is currently assigned.  

For example, Bob.

(fixedValue),dataLocation

(tick)

KMS_prevAssigned

Login name of the BMC Remedy AR System user to whom the knowledge article was previously assigned.

For example, Mary.

(fixedValue),dataLocation

KMS_companies

Name of the company for which the original knowledge article was created. The company must already be registered in the BMC Remedy AR System database.

(fixedValue),dataLocation

(tick)

KMS_title

Title of the knowledge article.

dataLocation

(error)

attachments

Comma-separated list of attachment file names.

dataLocation

(error)

CTI2.sub1

Name of the product to which the knowledge article is relevant.

dataLocation

(error)

CTI2.sub2

Name of the manufacturer of the product to which the knowledge article is relevant.

dataLocation

(error)

CTI2.sub3

Model or version of the product to which the knowledge article is relevant.

dataLocation

(error)

CTI3.category

Name of the Business Service (CI) that is relevant to the knowledge article. The CI must already exist in the BMC Atrium CMDB.

dataLocation

(error)

CTI.category

Operational categorization Tier 1. For more information, see  Categorization

(fixedValue),dataLocation

(error)

CTI.type

Operational categorization Tier 2.

(fixedValue),dataLocation

(error)

CTI.item

Operational categorization Tier 3.

(fixedValue),dataLocation

(error)

CTI2.category

Product categorization Tier 1.

(fixedValue),dataLocation

(error)

CTI2.type 

Product categorization Tier 2.

(fixedValue),dataLocation

(error)

CTI2.item 

Product categorization Tier 3.

(fixedValue),dataLocation

(error)

CTI4.category

Geographic region of the site of the company to which the knowledge article is relevant. This region could be a continent or a country.

(fixedValue),dataLocation

(error)

CTI4.type 

Further narrows down the location of the site, by indicating a smaller area in which a group of sites is located. This location could be a state or a city.

(fixedValue),dataLocation

(error)

CTI4.item 

Pinpoints a single site to which the knowledge article is relevant. This site could be a city or an office building.

(fixedValue),dataLocation

(error)

KMS_visibility_groups

Names of the visibility groups to whom the knowledge articles will be visible, sorted by company. For more information, see Managing knowledge article visibility.

Enter values for this parameter in the following format:

Company1~!~Group1~!~Group1|Company2~!~Group1~!~Group2|Company3...

The following variables are used in the parameter:

  • Company–The company that owns the visibility groups that follow it.
  • Group–The name of each visibility group that belongs to a particular company.
  • The characters ~!~ represent the separators between the name of the company and each of the visibility groups that belong to it.
  • The vertical bar ( |) represents the start of a different company's data

Refer to the Description column for this parameter

(tick)

KMS_creationDate

Date on which the knowledge article was created.

(fixedValue),dataLocation

(error)

KMS_lastModifiedDate

Most recent date on which the knowledge article was modified.

(fixedValue),dataLocation

(error)

KMS_reviewDate

Date on which the knowledge article is scheduled for review.

(fixedValue)

(error)

KMS_documentId

Document ID of the knowledge article.

dataLocation

(tick)

KMS_keyWords

Search keywords that users can enter to locate the knowledge article.

dataLocation

(error)

KMS_status

Current status of the knowledge article in its lifecycle.

(fixedValue),dataLocation

(tick)

KMS_prevStatus

Previous status of the knowledge article.

(fixedValue)

(error)

language

Language in which the knowledge article is written.

(fixedValue),dataLocation

(tick)

KMS_kblinks_prefix 

Prefix used in hyperlinks to other knowledge articles. This prefix includes the KBurlIdentifier value.

KMS_kblinks_prefix

(error)

KMS_kblinks_suffix 

Suffix used in hyperlinks to other knowledge articles. This suffix can be used to specify URL attributes.

KMS_kblinks_suffix

(error)

Source parameters

Identify this section of the configuration file by adding the [src] tag. These parameters are used to map knowledge article content fields in the original articles to fields on the desired knowledge article template in BMC Knowledge Management.

Parameter

Description

Value format

Mandatory

formName

The knowledge article template that you want the converted knowledge articles to use; the following options are available:

  • HowToTemplate
  • ProblemsSolutionTemplate
  • ReferenceTemplate
  • KnownErrorTemplate

AR form name, including the prefix

(tick)

How to template parameters  
RKMTemplateQuestionMaps the Question field in BMC Knowledge Management, where you can capture the details of the question that is being addressed by the knowledge article.

dataLocation

(tick)

RKMTemplateAnswerMaps the Answer field in BMC Knowledge Management, where you can capture the solution details of the question that is being addressed by the knowledge article.

dataLocation

(tick)

RKMTemplateTechnicianNotesMaps the Technical Notes field in BMC Knowledge Management, where you can capture miscellaneous technical information that is relevant to the knowledge article.

(fixedValue),dataLocation

(tick)

Problem Solution template parameters  

RKMTemplateProblem

Maps the Problem field in BMC Knowledge Management, where you can describe the problem or question that the knowledge article addresses.

dataLocation

(tick)

RKMTemplateSolution

Maps the Solution field in BMC Knowledge Management, where you can describe the answer to the problem or question that the knowledge article addresses.

dataLocation

(tick)

RKMTemplateTechnicianNotes

Maps the Technical Notes field in BMC Knowledge Management, where you can capture miscellaneous technical information that is relevant to the knowledge article.(fixedValue),dataLocation

(tick)

Reference template parameters  
ReferenceMaps the Reference field in BMC Knowledge Management, where you can capture the reference information that is relevant to the knowledge article.dataLocation

(tick)

Known Error template parameters  
RKMTemplateErrorMaps the Error field in BMC Knowledge Management, where you can capture details of the error relevant to the knowledge article.dataLocation

(tick)

RKMTemplateRootCauseMaps the Root Cause field in BMC Knowledge Management, where you can capture details of the root cause of the error that is relevant to the knowledge article.dataLocation

(tick)

RKMTemplateFixMaps the Workaround/Fix field in BMC Knowledge Management, where you can capture details of the fix for the error that is relevant to the knowledge article.dataLocation

(tick)

RKMTemplateTechnicianNotesMaps the Technical Notes field in BMC Knowledge Management, where you can capture miscellaneous technical information that is relevant to the knowledge article.(fixedValue),dataLocation

(tick)

Sample configuration files

You can refer to the attached samples while creating your own configuration file.

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

Comments