Object Mapping

The <ObjectMappings> node contains one or more <Object> nodes for identifying the mappings that should apply to specific objects extracted from the data source and stored in the Object Model.

Evaluation of complex regular expressions can sometimes take a significant amount of time. You may optionally specify a timeout value (in seconds), for evaluation of regular expressions used in mapping entries specified in the file.

Note: If not specified, the default value for this timeout is 60 seconds.

<ObjectMappings regExTimeoutSecs="10">

If the regular expression is not evaluated within the time specified, an error is raised.

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 loading into AIM.

An Object Mapping example is as follows:

<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_SVG#: Sets output name for SVG.

#TARGET_NAME_CSV#: Sets output name for CSV.

Example of 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_SVG#" />

<Value value="custom svg name" />

</Attribute>

<Attribute>

<Name value="#TARGET_NAME_CSV#" />

<Value value="custom csv name" />

</Attribute>

</Attributes>

</Object>

Note: The Output name for EIWM is overridden by setting the File Name under Custom Folder Structure if set.