Elements and Attributes

Attributes

This is the root element in the Attributes Mapping file. It contains multiple instances of the sub-element "Attribute". There can be only one instance of the "Attributes" element.

Attribute

"Attributes" element can contain multiple instances of this element. It specifies the attribute in the input dataset which is to be mapped into another attribute in the output file. It can also specify if an attribute should be present in the output file or not.

Following are the attributes supported by this element:

From

The value for the new attribute would be taken from the column specified in this attribute from the DataSet. It is mandatory to have the attribute mentioned here be available in the DataSet as a column.

for example, <Attribute From="TagNo" To="Tag Number" Output="true"/>

In the above example, in the output file there would be a characteristic as follows:

<Characteristic>

    <Name>Tag Number</Name>

    <Value>00-AE-123ab</Value>

</Characteristic>

Value

Hard coded string that will be used as the value of the characteristic.

ApplyBehaviour

Perform some processing on DataSet value(s) to determine the value of the characteristic.

Note:
Out of "From", "Value" or "ApplyBehaviour" which define how the value for the attribute should be determined, one and only one of these three should be specified. In case user specifies more than one attributes out of these three, then preference will be given in following sequence >Value, ApplyBehaviour, From.

To

This attribute provides the name of the new characteristic. This is mandatory attribute.

Default

A default value that will be used if no value is found in the DataSet.

RegExPattern

Specified regular expression pattern will be applied to the attribute's value and the matched sub-string to the pattern will be the output value for the characteristic.

RegExRemovePattern

A regular expression pattern to identify part of the value to be removed. E.g. This could be used to remove spaces or dashes from a value.

Output

This attribute can have "true" and "false" as valid values. If it is "true", the output file would contain the corresponding attribute. If it is "false", the attribute would not be present in the output file.

If the value of attribute 'Output' is "true", then one of the following attributes must be present: "Value", "From" or "ApplyBehaviour".