Skip to main content

Manual Data Entry

Contributors: Tyler Engelhardt

Manual Data Entry Overview

Overview

The PI Vision Manual Data Entry symbol allows entering data (point values) into the OSIsoft PI Data Archive through PI Vision displays. The symbol is configured using the Asset Framework with a defined structure for the required attributes. This allows controlling the ability to update or delete existing values for a point via the symbol and setup of an optional audit log using the native PI Asset Framework security.

Security of the symbol has two aspects. Users who need to add, update, or delete values from a PI Point need to be mapped to an identity that has the Write Data permission. Users who need to configure the symbol need to be mapped to an identity that has the Admin permission. These requirements enable a best practice where one group of users are allowed to configure the manual data entry symbols while another group of users are able to consume the symbol.

Historical data for the selected PI Point can be viewed using the normal PI Vision update interval or by connecting to a PI Web API instance and configuring the connection. Using the PI Web API to gather historical data for a point allows using a time context that is different from the current display context. This is useful when the PI Point may not have data within the time context being used for the current display.

Goals

The goal of the PI Vision Manual Data Entry symbol was to allow sending manual data to the PI Data Archive without using a custom application and to simplify the process compared to using the PI Manual Logger product. Many users would rather enter data through PI Vision instead of with PI Manual Logger because PI Vision allows viewing the manual data entry alongside critical operational displays.

Challenges

The challenge of building a custom PI Vision symbol through the extensibility framework was understanding the capabilities of the framework. The extensibility framework is purely JavaScript and has no type inference capability. Additionally, there are many functions built-in that are available for use but not documented.