Instance Translation
With instance translation, you can add translations for each instance of an object based on your business requirements. For example, parts with the same names can have different translations in target languages. In the example below, parts 1234 and 1236 have the same name “CUP” in English, but each part has a different translation in German, “TASSE” and “BECHER.”
Instance translation is supported only for translatable text attributes (modeled and soft) on translatable objects.
|
Part Number
|
Part Name in English
|
Translated Part Name in German (target language)
|
|---|---|---|
|
1234
|
CUP
|
TASSE
|
|
1235
|
MUG
|
TASSE
|
|
1236
|
CUP
|
BECHER
|
|
1237
|
MUG
|
BECHER
|
 |
Translation using dictionary entries is not supported when instance translation is enabled.
|
Enable Instance Translation
Perform the following steps to enable instance translation:
1. Navigate to > > > and set the preference Enable Dictionary Translation Display to Yes.
2. Navigate to > > and set the Multi Language Translation Mode to Instance Translation. For more information, see Multi-Language Translation Mode.
 |
When switching to instance translation mode, all active dictionary entries are migrated to instance translation, and existing translations remain unchanged. However, all inactive dictionary entries will be deleted. In Windchill Service Information Manager Translation Management, creating a translation package is not supported in instance translation mode. We recommend implementing this mode with caution and carefully considering the impact on the existing data.
|
3. Create translated text attributes as required. For more information, see Creating Translated Text Attributes.
4. Specify authoring and target languages. For more information, see Setting Up Languages.
5. Load translations using the XML loader. For more information, see section Loading Translations for Instance Translation.
Loading Translations for Instance Translation
Follow these steps to load translated entries from an external system in Windchill using an XML file. These translated entries can be used as translated text values for the instance translation.
1. Create an XML load file. Refer to the following example:
You can load multiple translations as separate entries using the same XML load file.
<?xml version="1.0"?>
<!DOCTYPE NmLoader SYSTEM "standard13_1.dtd">
<NmLoader>
<csvBeginTranslationInstanceEntries
handler="com.ptc.core.td.LoadTranslationInstance.beginProcessTranslationInstanceEntries" />
<csvTranslationInstanceEntry
handler="com.ptc.core.td.LoadTranslationInstance.createTranslationInstanceEntry">
<csvtypeContext>wt.part.WTPartMaster</csvtypeContext>
<csvtranslatedTextAttribute>Translation_Name</csvtranslatedTextAttribute>
<csvinstanceReference>wt.part.WTPartMaster:131407</csvinstanceReference>
<csvmasterText>LOWER_LEFT_ARM</csvmasterText>
<csvtargetLanguage>ja</csvtargetLanguage>
<csvtranslatedText>LOWER_LEFT_ARM_ja_instance</csvtranslatedText>
</csvTranslationInstanceEntry>
<csvEndTranslationInstanceEntries
handler="com.ptc.core.td.LoadTranslationInstance.endProcessTranslationInstanceEntries" />
</NmLoader>
<!DOCTYPE NmLoader SYSTEM "standard13_1.dtd">
<NmLoader>
<csvBeginTranslationInstanceEntries
handler="com.ptc.core.td.LoadTranslationInstance.beginProcessTranslationInstanceEntries" />
<csvTranslationInstanceEntry
handler="com.ptc.core.td.LoadTranslationInstance.createTranslationInstanceEntry">
<csvtypeContext>wt.part.WTPartMaster</csvtypeContext>
<csvtranslatedTextAttribute>Translation_Name</csvtranslatedTextAttribute>
<csvinstanceReference>wt.part.WTPartMaster:131407</csvinstanceReference>
<csvmasterText>LOWER_LEFT_ARM</csvmasterText>
<csvtargetLanguage>ja</csvtargetLanguage>
<csvtranslatedText>LOWER_LEFT_ARM_ja_instance</csvtranslatedText>
</csvTranslationInstanceEntry>
<csvEndTranslationInstanceEntries
handler="com.ptc.core.td.LoadTranslationInstance.endProcessTranslationInstanceEntries" />
</NmLoader>
2. Run the following command in a Windchill shell to import the XML load file.
windchill wt.load.LoadFromFile -d Load File Location -u username -p password
For example,
windchill wt.load.LoadFromFile -d LoadTranslations.xml -u username -p password
|
Element
|
Optional or Required
|
Data Type
|
Description
|
|---|---|---|---|
|
csvTranslationInstanceEntry
|
Required
|
String
|
handler attribute, is required with the com.ptc.core.td.LoadTranslationInstance.createTranslationInstanceEntry value.
|
|
csvtypeContext
|
Required
|
String
|
A type where a translated text attribute is defined. For example, Translation_Name on Part Master.
|
|
csvtranslatedTextAttribute
|
Required
|
String
|
Translated text attribute for which instance translation is required.
|
|
csvinstanceReference
|
Required
|
String
|
For iterated types (for example, Part) this value is master reference (example wt.part.WTPartMaster:<id>).
|
|
csvmasterText
|
Required
|
String
|
Text to be translated.
|
|
csvtargetLanguage
|
Required
|
String
|
The name of the language enumeration entry available in the Available Languages global enumeration.
|
|
csvtranslatedText
|
Required
|
String
|
Translated text.
|