Field configuration

The Template attribute fields screen shows the following fields:

• Included

  All fields are included by default; however, you can improve performance by deselecting unwanted fields or fields that will not be used. Transferring field data that is not used can slow system performance. In addition, having fewer fields might make the list easier to understand.

  You can select the individual fields you want exposed in the Template attribute fields section. Fields with a checkmark are used in the layer while those without a checkmark are not. Remove the checkmark to remove the attribute from the layer.

• Name

  The name field shows the name that will be used in the ArcGIS platform. The name can be different from the attribute name specified in AF, if necessary, to make it easier for users to understand.

  Attribute names must be composed from simple alphanumeric characters: A-Z, a-z, and 0-9 and underscore ( _ ). When the New Layer page opens, the AF attribute names are converted automatically to simple alphanumeric characters. For example, characters with diacritical marks are converted into the closest corresponding simple characters, but they may then be edited further as desired. Validation cues will appear if the user modifies an attribute name to contain invalid characters.

• Attribute Name

  The name of the attribute as it appears in AF. The attribute name cannot be changed in this screen.

• Type

  The data type of the attribute.

• Source

  The name of the AF data reference or static.

• Units

  The default measurement unit for the attribute.

• Function

  The X and Y functions are pre-selected if the tool finds any attribute name that contains the words longitude or latitude, or X or Y and assigns them to the x and y function. If desired, you can select a different function (select None, X, Y, Key or Geometry). You specify X and Y functions for attributes that indicate geographic positions, including positions that move over time. Only one X and Y pair can be specified.

  A field function defines a special function for the field value, which allows you to specify those fields that make up the geometry (or location) of a map feature. You can select either an X or a Y function, or select a geometry function.

  • Specifying X and Y

    By specifying the X and Y functions, you determine which values make up the location of the map feature. For example, when you have longitude and latitude values defined in your AF template, you can select the X function for longitude and Y for latitude. X and Y must be defined in pairs; you cannot have an X value without a Y value and you cannot have a Y value without an X value. X and Y function fields must be numeric.

    By default, PI Integrator for Esri ArcGIS attempts to identify element names that contain longitude and latitude information and assigns those elements to the X and Y fields automatically. You should verify that the X and Y fields identified contain longitude and latitude values.

  • Specifying a geometry

    Another geometry option is to specify the geometry or location on a map feature by defining it in Esri Feature Geometry JSON. See Geometry objects in ArcGIS documentation for more information. Specifying a geometry allows for much more complex areas to be defined, such as (poly)lines or polygons. Geometry function fields must be of type string.

  • Specifying a key function

    A key function specifies a unique identifier for a particular map feature. Use care to ensure that the key function is unique for your configured search parameters when you select a field. The key function is used when updating map features in a feature service and also to identify AVEVA PI Vision displays.

    Only string data types can be selected for the key field.