Defining Received Delivery Mapping Using a Load File
If you would prefer to load your received delivery mapping definitions rather than specifying them using the Define Mapping action, you can use the <Windchill>/loadFiles/preference.federationmapping.xml load file, where <Windchill> is the location where Windchill is installed. Using the file as an example, you can create your own file to load mapping definitions for
• Folders: FederationFolderMapping
• Views: FederationViewMapping
• Owning Organizations: FederationOwningOrgMapping
• Contexts: FederationContextMapping
• Life Cycles: FederationLifecycleMapping
• Security Labels: FederationSecurityLabelMapping
In the following example, the imported data is mapped to the Engine Folder folder in the Generic Computer product.
<csvBeginMVPreferenceInstance handler="wt.preference.LoadPreference.beginMVPreferenceInstance">
<csvname>FederationFolderMapping</csvname>
<csvcomments>no comments1</csvcomments>
<csvcontainerClass>wt.pdmlink.PDMLinkProduct</csvcontainerClass>
<csvcontainerName>GENERIC_COMPUTER</csvcontainerName>
<csvparentContainerPath>/wt.inf.container.OrgContainer=Demo Organization</csvparentContainerPath>
<csvclientName>453802382-1321857691652-6818173-136-14-21-130</csvclientName>
<csvlock>FALSE</csvlock>
<csvlockOnly>FALSE</csvlockOnly>
</csvBeginMVPreferenceInstance>
<csvMVPreferenceInstance handler="wt.preference.LoadPreference.mvPreferenceInstance">
<csvvaluekey>/Default/Engine Folder</csvvaluekey>
<csvvalue>/Default</csvvalue>
<csvlock>false</csvlock>
</csvMVPreferenceInstance>
<csvBeginMVPreferenceInstance handler="wt.preference.LoadPreference.beginMVPreferenceInstance">
<csvname>FederationContextMapping</csvname>
<csvcomments>no comments1</csvcomments>
<csvorganization>Demo Organization</csvorganization>
<csvclientName>453802382-1321857691652-6818173-136-14-21-130</csvclientName>
<csvlock>FALSE</csvlock>
<csvlockOnly>FALSE</csvlockOnly>
</csvBeginMVPreferenceInstance>
<csvMVPreferenceInstance handler="wt.preference.LoadPreference.mvPreferenceInstance">
<csvvaluekey>/wt.inf.container.OrgContainer=PackagesAutomation/wt.pdmlink.PDMLinkProduct=Car</csvvaluekey>
<csvvalue>GENERIC_COMPUTER</csvvalue>
<csvlock>false</csvlock>
</csvMVPreferenceInstance>
<csvEndMVPreferenceInstance handler="wt.preference.LoadPreference.endMVPreferenceInstance"/>
<csvMVPreferenceInstance handler="wt.preference.LoadPreference.mvPreferenceInstance">
<csvvaluekey>/wt.inf.container.OrgContainer=PackagesAutomation/wt.pdmlink.PDMLinkProduct=Car</csvvaluekey>
<csvvalue>GENERIC_COMPUTER</csvvalue>
<csvlock>false</csvlock>
</csvMVPreferenceInstance>
<csvEndMVPreferenceInstance handler="wt.preference.LoadPreference.endMVPreferenceInstance"/>
<csvBeginMVPreferenceInstance handler="wt.preference.LoadPreference.beginMVPreferenceInstance">
<csvname>FederationLifecycleMapping</csvname>
<csvcomments>no comments2</csvcomments>
<csvcontainerClass>wt.pdmlink.PDMLinkProduct</csvcontainerClass>
<csvcontainerName>GOLF_CART</csvcontainerName>
<csvparentContainerPath>/wt.inf.container.OrgContainer=Demo Organization</csvparentContainerPath>
<csvclientName>1</csvclientName>
<csvlock>FALSE</csvlock>
<csvlockOnly>FALSE</csvlockOnly>
</csvBeginMVPreferenceInstance>
<csvMVPreferenceInstance handler="wt.preference.LoadPreference.mvPreferenceInstance">
<csvvaluekey>wt.part.WTPart;charuLC;temp1</csvvaluekey>
<csvvalue>Basic;INWORK</csvvalue>
<csvlock>false</csvlock>
</csvMVPreferenceInstance>
<csvEndMVPreferenceInstance handler="wt.preference.LoadPreference.endMVPreferenceInstance"/>
<csvBeginMVPreferenceInstance handler="wt.preference.LoadPreference.beginMVPreferenceInstance">
<csvname>FederationViewMapping</csvname>
<csvcomments>no comments1</csvcomments>
<csvclientName>1</csvclientName>
<csvlock>FALSE</csvlock>
<csvlockOnly>FALSE</csvlockOnly>
</csvBeginMVPreferenceInstance>
<csvMVPreferenceInstance handler="wt.preference.LoadPreference.mvPreferenceInstance">
<csvvaluekey>NewDesign</csvvaluekey>
<csvvalue>Design</csvvalue>
<csvlock>false</csvlock>
</csvMVPreferenceInstance>
<csvEndMVPreferenceInstance handler="wt.preference.LoadPreference.endMVPreferenceInstance"/>
<csvBeginMVPreferenceInstance handler="wt.preference.LoadPreference.beginMVPreferenceInstance">
<csvname>FederationOwningOrgMapping</csvname>
<csvcomments>no comments1</csvcomments>
<csvclientName>1</csvclientName>
<csvlock>FALSE</csvlock>
<csvlockOnly>FALSE</csvlockOnly>
</csvBeginMVPreferenceInstance>
<csvMVPreferenceInstance handler="wt.preference.LoadPreference.mvPreferenceInstance">
<csvvaluekey>TestOrg</csvvaluekey>
<csvvalue>Test_Org</csvvalue>
<csvlock>false</csvlock>
</csvMVPreferenceInstance>
<csvEndMVPreferenceInstance handler="wt.preference.LoadPreference.endMVPreferenceInstance"/>
<csvBeginMVPreferenceInstance handler="wt.preference.LoadPreference.beginMVPreferenceInstance">
<csvname>FederationSecurityLabelMapping</csvname>
<csvcomments>no comments1</csvcomments>
<csvclientName>482499601-1370661076932-1478036579-36-26-21-130</csvclientName>
<csvlock>FALSE</csvlock>
<csvlockOnly>FALSE</csvlockOnly>
</csvBeginMVPreferenceInstance>
<csvMVPreferenceInstance handler="wt.preference.LoadPreference.mvPreferenceInstance">
<csvvaluekey>CUSTOM_FILTER=;CUSTOM_PTC=;CUSTOM_UK_EXPORT=;</csvvaluekey>
<csvvalue>CONTEXT_BASED_LABEL=DemoBased;EXPORT_CONTROL=TestControl;</csvvalue>
<csvlock>TRUE</csvlock>
</csvMVPreferenceInstance>
<csvEndMVPreferenceInstance handler="wt.preference.LoadPreference.endMVPreferenceInstance"/>
After creating your own load file, save it to the
<Windchill>/loadFiles directory. You can load your file using the LoadFromFile utility. For more information, see
Using the LoadFromFile Utility.
Tag Descriptions
• csvname - Type of mapping definition. The possible values include:
◦ Folders: FederationFolderMapping
◦ Views: FederationViewMapping
◦ Owning Organizations: FederationOwningOrgMapping
◦ Contexts: FederationContextMapping
◦ Life Cycles: FederationLifecycleMapping
◦ Security Labels: FederationSecurityLabelMapping
• csvcomments - Default comment of the mapping definition. The text is stored in DEFAULTCOMMENT of the PREFERENCEDEFINITION table.
• csvcontainerClass - Type of context. For example, a product would be wt.pdmlink.PDMLinkProduct.
• csvcontainerName - The name of the context.
• csvparentContainerPath - The parent context.
• csvclientName - The source system identifier for which the mapping is defined.
• csvlock - Sets the preference instance precedence. The preference instance mapping can be defined at the Site, Organization, Product, Library, or User level. If the preference is locked at a higher level, it cannot be modified in lower levels. For example, if it is locked at the Organization level, the value cannot be changed at the Product, Library, or User level.
• csvlockOnly - Defined on the preference instance set using the csvlock element. If the value is true, then the csvlock definition is not considered for multi-valued preferences. If the value is false, then the csvlock definition is enforced.
• csvvaluekey - Source value of the mapping definition.
• csvvalue - Target value of the mapping definition. When the mapping definitions are loaded into Windchill, the csvvalue value will appear rather than the csvvaluekey value.
• csvorganization - The organization name under which the mappings are defined. If both csvorganization and csvContainerName are defined, csvorganization takes precedence.