ObjectName Mapping

ObjectName Mapping determines the name of the object. Each mapping entry in the configuration is examined in sequence and the first mapping entry to match is used to generate the object’s context ID.

The simplest form of ObjectName map entry to derive Object Name for an object is shown below:

<Object>

...
<Conditions>
<Attribute name="object_class" pattern="Door" />
</Conditions>
<ObjectName value="[object_name]">
</ObjectName>

...
</Object>

Note: Conditions may hold multiple attribute elements. All conditions must be met for the mapping to be applied.

To modify the ObjectName value, use Lookups and transforms.

<Object>

...
<Conditions>
<Attribute name="object_class" pattern="Door" />
</Conditions>
<ObjectName value="[object_class]">
<Transforms>
<Replace pattern="\d{2}" value="yyy" />
</Transforms>
</ObjectName>

...
</Object>

<Object>

...
<Conditions>
<Attribute name="object_class" pattern="Door" />
</Conditions>
<ObjectName value="[object_class]">
<Lookup id="ExcelLookup" >
<FailAction action = "DiscardElement" />
</Lookup>
</ObjectName>

...
</Object>

Attributes from associated objects can also be used, as shown below:

<Object>

...
<IncludeAssociatedObjectAttributes type ="^FillsVoids$" refID ="[Name]">
<Conditions>

<Attribute name = "ClassName" pattern = "^OPENINGELEMENT" />

<Attribute name = "Name" pattern = "^element1$" />

</Conditions>

</IncludeAssociatedObjectAttributes>

<ObjectName value="[Name]_[associated:Name]" />

...

</Object>

In the above case, the value of the Name attribute along with the value of Name of the first associated object matching the condition is used in deriving ObjectName. The prefix "associated:" is used when referring to the associated object's attribute.

If an object does not match any of the mapping entries, it is not assigned any ObjectName.