This documentation supports the 9.1 version of Knowledge Management.

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

Converting articles for default or modified templates

Perform this procedure if you want to convert articles that are based on default or modified (modified fields) templates provided with the 7.2 and 7.5 releases.

Best Practice

Review the parameters in the file before performing this procedure and update the file as needed. For more information, see Updating the file.

We recommend that you disable notifications during the conversion process to avoid generating unwanted alerts.

  1. In the Knowledge Management Console, choose Functions > Article Conversion Tool and click the New Conversion icon.
  2. In the Conversion Type field of the General tab, select the Upgrade option.
  3. Enter the following information in the General tab.
    • Full path—Specify a full path to the data folder that contains the articles you want to convert. The path can be:
      • A full path to a folder on the local file system such as C:\data.
      • A UNC (Uniform Naming Convention) for remote access in the following format: \\ComputerName\SharedFolder\Resource.\
      • A full path to a shared folder on the network.

        Make sure that the data\kms_data folder contains four subfolders: templates, draft, publish, and attachments.

    • Owner Group — Select a user group from the list to specify the group.
    • Owner — Select the articles owner from the list.
    • Convert Only Visibility Groups--Select this option if you want to convert only visibility groups information. This option is useful when you already converted old articles without visibility groups information and now you want to convert the visibility group information without converting all the articles again.
  4. Click Organization and Categorization and select a company from the list.
    Select one of the following conversions mode:
    • Use Template Fields — The conversion tool copies organization and categorization values from the XML template into the AR form.
    • Use Fixed Values — You enter organization and categorization values in the fields below and the conversion tool automatically enters these values for all the converted articles.
      Enter values for Product CategorizationOperational CategorizationBusiness ServiceOrganization, and Location fields.
  5. (Modified templates only ) Click the Mapping tab.
    1. In the XML Template Name list, select the template that you have modified.
    2. In the AR Form Name list, select the BMC Remedy AR System form to which the selected XML template is converted.
    3. Select a modified field from the XML Field list and review the matching BMC Remedy AR System field in the AR Field list.
    4. If required, change the mapping for the modified XML field and click Add Field.
    5. After you complete mapping all the modified fields, click Save.
  6. Click the Run tab and select one or more XML templates for conversion.
  7. Click Run to start the conversion.
    The conversion may take a while, depending on the number of articles that exist in the folder you specified.
    The tool does not provide progress indication of the conversion. You can retrieve progress information from the arjavaplugin.log file (InstallationHome\ARSystem\Arserver\Db folder). The following text indicates that the conversion has completed.

    *** Knowledge Article Conversion REPORT ***
    There are types of Articles that were
    selected to transfer:
    There were 50 found for Migration
    Migrated successfully: 50
    Failed: 0
    ###############END REPORT##################


    To ensure that the results of the conversion job are saved to the arjavaplugin.log file, verify that the log level parameter in the log4j_pluginsvr.xml file is set to info, as follows:

    <logger additivity="true" name="com.bmc.itsm.rkm">   
          <level value="info"/>

    If you manually update the log level parameter value value to info, you must restart the BMC Remedy AR System Server for the change to take effect.

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