Import translated entities
Note: To run the import script (
kImportAttributes.sh), you must have the Sys Admin: Manage Translations access grant.
The import script
kImportAttributes.sh can operate on any combination of:
.zipfiles that include only
Before you import a
.properties file, make sure it is ASCII encoded. You can use the built-in Java utility
native2ascii included in PPM to perform this encoding. (Most commercially available translation management tools perform the encoding automatically.)
The following example converts a file that is UTF-8 encoded to ASCII
native2ascii -encoding UTF-8 <input file> <output file>
When you import translations, their languages must be supported (previously installed) on PPM.
Note: You cannot import scoring criteria definitions using referenceCode or primaryKey. You can export definitions only for a full list of scoring criteria.
.properties filename(s) and .zip filename(s) to be imported must be appended with “_” followed by a two-character language code from the subset of languages in ISO standard 639-1 that are supported by Oracle. The filename(s) can be further appended with “_” followed by a two-character country code from the subset of codes in ISO standard 3166-1 that are supported by Oracle.
ToPPM_pt_BR.propertiesfor Brazilian Portuguese
Data in the
.properties files must use the Java standard format:
By default, files will be imported from the
<PPM_Home>/mlu/translations directory. However, you can save them elsewhere on the PPM Server and specify that path when you run the import script.
Translation Impact Report
Before importing the data, we recommend that you generate and review a Translation Impact report by running the import script with the
-mode test option. The report is saved at the location shown on screen when you run the script.
For each file to be imported, for new or updated translations only, the report displays:
The key for each attribute
The attribute's original value in its definition language
The existing translation (if any) of the attribute in the language to be imported
The new translation of the attribute in the language to be imported
As reflected in the Translation Impact report, importing unmodified translation files, including translation files previously exported using the export script, has no impact.
Review the quality of the new translations. If there are errors, determine how you want to proceed. You can import some properties files and not others, or you might be able to edit some of the files (in collaboration with any translation service you might use).
After running the import script with the
-mode test option and reviewing the report, run the import script without the
-mode test option to import the translations to PPM.
Running Import Script
To run the import script:
On the PPM Server, navigate to the directory that contains the
Run the following script:
sh ./kImportAttributes.sh -username <user name>
-password <password> [options]
where the options are as described in the following table.
The name of the file to import.
If unspecified, all files in the specified
The directory in which the files to be imported are located.
If unspecified, the default is
Value of <mode> is
If unspecified, the default is
For example, after substituting valid values for the
password, run the script in test mode as follows:
sh ./kImportAttributes.sh -username admin -password pw
The script runs and generates the Translation Impact report. If the script is run without the
-mode testoption, it imports the specified files.
Log files are saved as described on screen.
Note: In general, the import script does not overwrite attributes in their definition languages. (However, installing a language pack provided by Micro Focus can do so.)