Object Mapping
- Last UpdatedAug 26, 2024
- 2 minute read
A generic object consists of a list of attributes that defines the characteristics of that object. It also contains a list of associations to other generic objects.
The Object Mapping section is classified as follows:
-
Transform mapping settings to modify an existing object/remove it.
-
Load mapping settings to make the object ready for AIM load.
The following is an example of Object Mapping:
<Object>
...
<Conditions>
<Attribute name="Class" pattern="EQUIPMENT" />
</Conditions>
<TemplateID id ="default" />
<ObjectID value="ID_[object_name]" />
<ObjectName value="[object_name]" />
<ClassID value="[Class]" />
<ContextID value="[object_context]"/>
<Revision value="[Versionlabel]"/>
<IncidentalClassifications>
<IncidentalClassification value="void" />
</IncidentalClassifications>
<Attributes>
<Attribute name="Identifier" >
<Value value="[Tag]" />
</Attribute>
<Attribute>
<Conditions>
<Attribute name="Class" pattern="EQUIPMENT" />
<Attribute name="Subtype" pattern="PUMP" />
</Conditions>
<Name value="Maximum Pressure" />
<Value value="[max_pressure]"/>
<Units value="psi" />
</Attribute>
</Attributes>
<Associations>
<Association attribute="Nozzle_ID" attributePattern="^.*$" >
<Type value="Has Nozzle" />
<TargetID value="[Nozzle_ID]" />
<TargetClassID value="NOZZLE" />
<ContextID value="[object_context]" />
</Association>
</Associations>
...
</Object>
Transform Mapping Settings
Transform mapping settings contain the following mappings that can be applied to a generic object.
Object Remove Mapping:
<Object>
<Conditions>
<Attribute name="object_class" pattern="Door" />
</Conditions>
<Remove />
</Object>
This mapping entry indicates that for all the objects matching the condition, remove the objects so they are no longer considered for the output files.
Note: The mandatory attributes needed for objects in EIWM such as the ObjectID identifier of an object (aka tag) and its ClassID are mapped just like any other attribute and refer to the Attribute mapping section.
To set custom output file names, add the following attributes to the Manifest object:
#TARGET_NAME_EIWM#: Sets output name for EIWM.
#TARGET_NAME_XGL#: Sets output name for XGL.
#TARGET_NAME_CSV#: Sets output name for CSV.
Example Base Mapping:
<Object>
<Conditions>
<Attribute name="#TYPE#" pattern="^manifest$" />
</Conditions>
<Attributes>
<Attribute>
<Name value="#TARGET_NAME_EIWM#" />
<Value value="custom eiwm name" />
</Attribute>
<Attribute>
<Name value="#TARGET_NAME_XGL#" />
<Value value="custom xgl name" />
</Attribute>
<Attribute>
<Name value="#TARGET_NAME_CSV#" />
<Value value="custom csv name" />
</Attribute>
</Attributes>
</Object>
Notes:
-
The Output name for EIWM is overridden by setting the File Name under Custom Folder Structure if set.
-
The output name for XGL is overridden by Presentation Mapping - Segmentation if set.