Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

AVEVA™ PI Vision™

Value entry

  • Last UpdatedNov 05, 2026
  • 3 minute read

The value entry symbol lets users manually write values to a single PI point or AF attribute. For example, a value entry symbol could be used if employees need to periodically enter a certain meter reading into your PI system because that meter cannot send data automatically.

If you want users to be able to enter data for more than one PI point or AF attribute on a single symbol, you should use the data entry symbol instead. However, when you need to enter values for only one data item, an advantage of the value entry symbol is it uses less screen space and it can fit better on crowded displays.

When you set up a value entry symbol, you select which PI point or AF attribute the symbol can be used to add data to. You can also configure the symbol to allow users to add new data values, replace existing values, or both. If replacing is enabled, users can overwrite existing values to correct inaccurate data. PI Vision does not allow users to delete data values using the value entry symbol or by any other method.

To add a value entry symbol to a display, select the value entry symbol icon in the Symbol Gallery, then drag a data item from the Assets pane onto the display. You can drag the edges of the symbol to change its size. If you want a value entry symbol to consume the least amount of screen space, size it at or near its minimum size and then the symbol automatically hides the submit button until a user enters a value. For more information, see Add a symbol to a display.

Some key points about the value entry symbol:

  • On the Administration website, administrators can restrict the use of value entry symbols by disabling the feature entirely or by allowing it only for selected identities.

  • You can use the symbol to manually enter data only for PI points and AF attributes; you cannot use the symbol for any other data types such as PI Vision calculations.

  • When configuring the symbol, an Update Mode setting provides several options for how PI Vision determines whether entered data creates a new data entry or if it replaces the value for an existing data entry.

  • The symbol can be set up so that entered data values are saved with a timestamp that reflects the date and time of entry (now) or a different specified timestamp.

  • Values entered in the symbol are not accepted if they do not comply with a data item's data type. For example, if the data type is integer, users are prevented from entering numbers with a decimal or letters. You can also set Value Limits when configuring the symbol, so that numeric data must fall within a defined range to be accepted.

  • The symbol automatically provides a drop-down list of values to choose from for any data item that is a digital PI point, a Boolean AF attribute, or an AF attribute based on an enumeration set.

  • Data that is entered using the value entry symbol does not have any special flag or annotation to differentiate it from other PI system data. However, the audit log records each instance when a user enters data through a value entry symbol.

Buffering

If AF SDK buffering is configured with the default settings on the PI Vision server, data entry through PI Vision will buffer if possible. For more information on changing this buffering behavior for the PI Vision server, see Configure n-way buffering for AF SDK clients. If PI Buffer Subsystem successfully receives the data from PI Vision but experiences an error trying to write the data, such as it not having enough permissions to write to the data item, PI Vision will not report the error. To investigate buffering errors, see Buffering and the PI message log.