ClassID Mapping

ClassID Mapping, also known as Classification, determines the class assigned to the object in the output. Each mapping entry in the configuration is examined in turn and the first matching entry is used to generate the object’s ClassID.

The simplest form of ClassID map entry to derive ClassID for an object is shown below:

<Object>

<Conditions>

<Attribute name="object_class" pattern="Door" />

</Conditions>

<ClassID value="[object_class]">

</ClassID>

</Object>

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

Lookups may be used to obtain the ClassID from an external data source.

<Object>

<Conditions>

<Attribute name="object_class" pattern="Door" />

<Attribute name="Name" pattern="Door 100X40" />

</Conditions>

<ClassID value="[object_class]">

<Lookup id="ExcelLookup" >

<FailAction action = "Fixedvalue" value="UNKNOWN" />

</Lookup>

</ClassID>

</Object>

In this case, the value of the object_class attribute is used as a key to look up a value for the ClassID. If no match is found, value is derived from its fail action.

You can use Transforms to modify the value of an attribute, as shown below:

<Object>

<Conditions>

<Attribute name="object_class" pattern="Door" />

<Attribute name="Name" pattern="Door 100X40" />

</Conditions>

<ClassID value="[object_class]">

<Transforms>

<Remove pattern="^[A-Za-z0-9]{3}" />

</Transforms>

</ClassID>

</Object>

Use attributes from associated objects to modify the value of ClassID as shown below:

<Object>

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

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

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

</Conditions>

</IncludeAssociatedObjectAttributes>

<ClassID value="[ClassName]_[associated:ClassName]" />

...

</Object>

In the above example, the value of the ClassName attribute along with the value of ClassName of the first associated object matching the condition is used in deriving ClassID.

Notes:

• The prefix "associated:" is used when referring to the associated object's attribute.

• All conditions must be met for the ClassID mapping to be applied.

If an object does not match any of the mapping entries, it is assigned a class ID of UNKNOWN.

Often when importing tag data into AIM the tag’s ClassID is already defined. In the case where this shouldn’t be changed, you should ensure that the EIWM doesn’t contain any definition of ClassID for the relevant objects. This can be achieved in base mapping by the following methods:

• <ClassID value="" />

• <ClassID value=" " /> (Space)

• <ClassID \> node not provided in Base mapping

For example, using the following base mapping:

Will produce EIWM output without ClassID (nor ContextID) defined: