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.

The 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.
e.g., <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 values 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 you specify more than one attribute out of these three, then preference will be given in the following sequence > Value, ApplyBehaviour, From.

To: This attribute provides the name of the new characteristic. This is a 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 the attribute Output is true, then one of the following attributes must be present: Value, From, or ApplyBehaviour.