Converting articles from external file formats
Perform this procedure to convert knowledge articles from third-party applications to AR forms that can be used by BMC Knowledge Management. The Article Conversion Tool supports the custom XML and HTML formats.
The following video provides information about converting third-party knowledge articles in BMC Knowledge Management.
- Though the video provides information about converting third party knowledge articles in BMC Knowledge Management 8.1.01, the same information is applicable in this version.
- Although the CSV option is available on the UI, the Article Conversion Tool does not support the conversion of articles from CSV format.
Before you begin
You must prepare a configuration file that will be used to manage the conversion task. For more information, see Creating a configuration file for conversions.
To convert knowledge articles from external file formats
- In the Knowledge Management Console, choose Functions > Article Conversion Tool and click the New Conversion icon.
- In the Conversion Type field of the General tab, select the External File Format option.
- In the Article Format field, select the type of source file that your knowledge articles use. The following options are available:
- Custom XML
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.
- In the Path to Config File field, enter the absolute path (including the file name) to the config.properties file that you created earlier.
For more information, see Creating a configuration file for conversions.
- In the Full Path field, enter the absolute path to the source files of the knowledge articles that you want to convert.
- Under the Organization & Categorization tab, select the required value for the Company field.
- Go to the Run tab, and 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 Article Conversion Tool does indicate the progress of the conversion. You can retrieve progress information from the arjavaplugin.log file that is located in the InstallationDirectory\ARSystem\Arserver\Db directory.
The following text indicates that the conversion is complete:
To ensure that the results of the conversion job are saved to the arjavaplugin.log file, verify that the
log levelparameter in the log4j_pluginsvr.xml file is set to
info, as follows:
<logger additivity="true" name="com.bmc.itsm.rkm">
If you manually update the
log levelparameter value value to
info, you must restart the BMC Remedy AR System Server for the change to take effect.