TAL a Synonym Bundle
In addition to bundles published from the content authored in Windchill Service Information Manager, you can also TAL bundles containing third party content, such as synonyms.
Synonym information is contained in synonym bundles. Synonym bundles contain the following files:
• BUNDLE.mf – The manifest file that provides information about the bundle.
Following is an excerpt from the file that identifies it as a synonym bundle:
Bundle-Id: SYN-000001
Bundle-Category: SYNONYMS
Bundle-type: full/incremental
Bundle-Version: 2.2
Bundle-source: PTC
Bundle-Publish-Date: 10/01/2015 00:00:00
family-Name: All
The manifest file provides the following settings:
◦ Bundle-Id – The unique identifier for the bundle
◦ Bundle-Category – The type of bundle
For synonym bundles, the type must be SYNONYMS.
◦ Bundle-type – Not currently used
◦ Bundle-Version – The version of the bundle
The version must be 2.2 or greater.
◦ Bundle-source – The name of the organization that produced the bundle
◦ Bundle-Publish-Date – The date the bundle was published
◦ family-Name – Not currently used
In a future release, this will specify the segment where the object will be loaded.
• ReadyForTAL – Indicates the bundle is eligible for the TAL process.
• Synonyms.xml – The XML file containing the synonyms data to be loaded.
This file must be named Synonyms.xml. Following is an example of the file content:
<definition>
<!-- definition of indiviudal expressions -->
<expressions>
<expression id="3166" langId="en-US">o-ring</expression>
<expression id="3167" langId="en-US">seal</expression>
<expression id="3168" langId="en-US">aux</expression>
</expressions>
<!-- Grouping of expressions into synonyms -->
<synonyms>
<group id="1">
<expRef>3166</ expRef>
<expRef>3167</ expRef>
</group>
<group id="2">
<expRef>3167</ expRef>
<expRef>3168</ expRef>
</group>
</synonyms>
</definition>
Note the following things about synonym bundles:
• The TAL process validates the following information before loading the data:
◦ Duplicate expressions statement (with same ID)
◦ Duplicate group statement (with same ID)
◦ Duplicate expression references in a group definition
◦ Undefined expression reference in a group
• Incremental bundle loading is not supported for synonyms.
• The existing synonyms data in the database is cleaned up prior to loading another synonyms bundle.
• The TAL process expects a single load file for synonyms, so data for multiple languages should be a part of the same bundle.