Windchill System Administrator's Guide

*
444-@@
content
filename
EngineReq
Properties in Mapping Rules Files
The preceding examples showed how to place properties in mapping rules files.
The chapter in this document about Windchill Export and Import describes the
properties that you can use to control Windchill Import. You set properties in
mapping rules files by editing the files, and you cannot use the xconfmanager
utility for this purpose. If you are not setting properties through a graphical user
interface or in a mapping file, you add or edit properties with the xconfmanager
utility, which is discussed elsewhere in this guide.
Do Not Map Number Attributes for MCAD Documents
About Mapping Rules
COPY Element
The number attribute of an MCAD document in the Windchill database is a string
identical to the document's Pro/ENGINEER file name. If you change an MCAD
document's number attribute by a mapping rule or by altering the object when it is
on the local disk, you create data that is incompatible with the assembly files that
refer to it. Attempting to repair a number change by reverting to the original
information does not succeed because the software perceives an attempt to check
in the renamed object as an attempt to duplicate an existing object.
Each mapping rule is an XML element within the mapping rule file. Each
mapping rule element, except for one that specifies copying, has at least two subelements:
and . These two sub-elements determine whether the rule
applies for any given element in an imported or exported XML file. If multiple
rules in a file could apply to an element in an imported or exported file, only the
first rule applies.
The following examples show the types of rules and how to apply them to a
variety of attributes. To work with attributes that do not appear in the following
examples, you need to understand XML and read the XML file that you are
mapping.
By default, all elements in a source XML file are copied into the resulting XML
file, and consequently it is not necessary to specify a rule that copies elements
without alteration. If any rule specifies an action other than copying for an
element, copying does not occur and the other rule controls the result for the
C-8 Windchill System Administrator’s Guide