Class and Attribute Mapping

Use the Class and Attribute Mapping part of the AVEVA AIM Gateway Config window to map AVEVA E3D Design elements and attributes to AVEVA AIM. The mapping functionality defines the display of AVEVA E3D Design classes and attributes when exported to AVEVA AIM.

Class Mapping

Defines the mapping of AVEVA E3D Design element types to AVEVA AIM classes.

Load Existing Class Mapping

Use Browse for Class Mapping File to load a .pmlmac file created by the legacy AVEVA AIM Gateway application. When the file is selected, the class mappings defined using the legacy application are automatically loaded for the selected element types.

AVEVA AIM Class

Use the AVEVA AIM Class drop-down list to select an available class for mapping.

Note:
The AVEVA AIM Class list does not necessarily display the current list of classes available in AVEVA AIM. Before attempting to map elements to classes, make sure that the classes in the AVEVA AIM Class list resemble the list in AVEVA AIM. This may require manual addition or removal of classes.

Selected Element

By default, the element types selected on the Element Selection and Filters part of the AVEVA AIM Gateway Config window are displayed in the Selected Element column.

AVEVA AIM Class

Use the AVEVA AIM Class drop-down list to manually map the currently selected element type to an AVEVA AIM Class.

Note:
Element types that are not mapped to an AVEVA AIM Class are exported using the element type name.

Select the Map to Unknown check box to map unmapped element types to the UNKNOWN AVEVA AIM Class. By default, the check box is deselected.

Attribute Mapping

Defines the mapping of AVEVA E3D Design attributes to AVEVA AIM attributes. Attributes that are not mapped are not exported.

Load Existing Attribute Mapping

Use Browse for Attribute Mapping File to load the DES-VNET-INCLUDE file created by the legacy AVEVA AIM Gateway application. If the loaded file does not contain the mappings but contains only the attributes, only the list of attributes is loaded.

AVEVA AIM Attribute

Use the AVEVA AIM Attribute drop-down list to select an available attribute for mapping.

Note:
The AVEVA AIM Attribute list does not necessarily display the current list of attributes available in AVEVA AIM. Before attempting to map attributes, make sure that the attributes in the AVEVA AIM Attribute list resemble the list in AVEVA AIM. This may require manual addition or removal of attributes.

Attribute

The Attribute column contains the list of attributes for the selected element type. Use the Attribute drop-down list to select an attribute.

AVEVA AIM Attribute

Use the AVEVA AIM Attribute drop-down list to specify the AVEVA AIM attribute.

Persist

Select the Persist check box to apply the attribute mapping to all element types where the attribute is present.

Add Attribute

Use to create an empty attribute mapping row.

Delete Attribute

Use to delete the currently selected attribute mapping.

Select all Attributes

Select the Select all attributes check box to display all available attributes for the currently selected element type. By default, the check box is deselected.

Add a PML Expression as an Attribute

A PML expression can be added as an attribute for selected element types. The PML expression must be typed in the Attribute column. The PML expression can be mapped to an AVEVA AIM attribute. The result of the PML expression must be a string data type for successful export.

The examples indicate PML expressions that can be added as an attribute:

String(TYPE+'string'+NAME)

IFT(PSPE eq 'A3B',PSPE,'UNKNOWN'

If the Persist check box is selected for a PML expression, the expression and the corresponding mapping is added to all the selected element types.

Note:
The gateway does not validate PML expressions. If an invalid PML expression is entered, the attribute is not exported.

Mapping Name for Element Types

Names for the selected element types can be mapped from the list of available attributes. Select the required attribute and map it to the NAMEINOBJECT AVEVA AIM attribute. This mapping enables element export using the Name with a value derived from the selected attribute.

The Persist check box must be selected to map a name for element types.

If the mapped attribute value is empty or null/unset/nulref, the Name value is unset. If the mapped attribute value is invalid, the name tag is the same as the ID.