Windchill System Administrator's Guide

Setting the preceding property’s value true allows the import of hierarchical IBA
definitions.
By default in Release 7.0, the default value of the property is false, and that value
allows the creation of hierarchical IBA definitions. A false value for the property
prevents the import of hierarchical IBA definitions, except when you use a
properly written mapping file, called a mapping file. A mapping file maps
hierarchical IBA definitions to non-hierarchical IBAs.
The creation of hierarchical IBA definitions without having the property set true is
likely to have occurred in releases prior to 7.0 because no recommendation to set
the property true existed for those releases. Nested Attribute Organizers are
allowed in R7.0 as they were in prior releases, without regard to the property’s
value.
This section describes the syntax of mapping files that provide rules to map
hierarchical IBA definitions to non-hierarchical IBA definitions. Mapping files
control both import and export and a given mapping file has the same effects on
both import and export. Mapping files can be used at any time and for any XML
files. Mapping files are more likely to be used with Windchill PDMLink than with
Windchill, because Windchill PDMLink can use many containers while
Windchill uses one layer.
A mapping file must map hierarchical IBA definitions to non-hierarchical IBA
Definitions for both IBA definitions and for IBAHolder instances such as WTPart
and TypeDefinition.
How to Write a Mapping File for Hierarchical IBAs
To understand how to write a mapping file, consider the case of a jar file to be
imported named ibaDefinitions.xml, The file includes IBA definitions with the
following structure:
Test Organizer
The goal is to create a non-hierarchical StringDefinition of NestedTestString
under the AttributeOrganizer TestOrganizer or any other AttributeOrganizer.
The following block achieves this goal:
path
Test String
NestedTestString
TestOrganizer/TestString
Import and Export Policies, Mapping Rules, and Conflict Messages C-13