General Mapping Conventions

When mapping field names from their source to the desired AVEVA Asset Information Management field certain conventions apply.

Handling of UDA and UDET Names

Where a UDA or UDET name is included in the data handled and processed by the gateway, the UDA or UDET name will, in the source system, be prefixed by a colon (:). The Schematic Gateway Mapping files are XML and as such conform to accepted XML standards and conventions. A colon at the beginning of a node name in an XML file has a specific meaning (it is used as a separator between a namespace and a name) and cannot therefore be used in a schematic gateway mapping file. To overcome this issue the Schematic Gateway automatically removes all preceding colon characters from field names provided to it from source systems. If you wish to create a mapping from a colon prefixed field it will therefore be necessary to reference the field without including the colon prefix.

For example:

Source system field name = ":OperatingTemp"

Must be referenced in a mapping file in this manner:

…

<ID Value="OperatingTemp"/>

…

Spaces in Field Names

Where a source Field Name contains spaces these will be automatically removed by the Schematic Gateway and each space character replaced by the underscore character "_".

To reference a source system field name which contains one or more spaces, in a mapping file, replace all spaces with an underscore character ("_") in your mapping.

For example:

Source system field name = "Operating Temp"

Must be referenced in a mapping file in this manner:

…

<ID Value="Operating_Temp"/>

…