The PI Vision custom symbol Multiple Manual Input is a multiple datasource symbol that allows you to input new values to PI AF attributes and PI tags as well.
Its look & feel has several similarities with the core symbol Table, so it will easily integrate to your existing PI Vision displays :
The columns New Timestamp and New Value allows you to enter a datetime and a new value.
The selected new values are pushed to PI AF database or the PI Data Archive server when you click on the "Send value(s)" button.
A feedback message is displayed in the symbol, next to the Send button.
Success messages are displayed in green :
Error messages are displayed in red :
Information messages are displayed in blue :
You have to ways to input the timestamp :
Using a calendar (aka calendar edit mode)
Enter text manually (aka manual edit mode)
The calendar is displayed with the current user's language settings :
When entering manually a datetime, you can specify a full date with format "dd/MM/yyyy HH:mm:ss", or enter a PI time expression.
This custom symbol is fully compatible with all Aveva time expressions, like '*', '*-2d', 't', 'y+8h', which is really useful. The default value is "*" (current time).
You can easily switch between the calendar edit mode and the manual edit mode with the "Change edit mode" button :
You can apply a timestamp and its edit mode to all other lines, with the "Apply to all" button.
Before :
After :
If the time expression is malformed, the textbox look & feel is updated in order to reflect the problem before trying to send the value(s).
Empty input texts are not allowed for both the "New alue" field and the "New Timestamp" field.
Features
The Multiple Manual Input custom symbol is compatible with any kind of data types.
Texts and Numbers
Digital sets (PI tags) and Enumeration Sets (PI AF attributes) :
Booleans :
Configuration options
Style
You can choose between the 3 styles also available for the Table core symbol
Datasources
You can manage the list of the symbol's datasources, similarly to other pultiple datasource symbols :
You can also choose a background color and a foreground color, which may help you organize your datasources in the symbol :
Visibility (display or not the following items)
Timestamp
Value
Units
Inputs
New timestamp default value This option allows the user to configure which timestamp is set by default for the new value. This can be a time expression, or a format stringWith the first option, all AVEVA time expressions are supported :
*
*-1d
t-2mo
y+6h
mon
apr
etc...
With the second option, you can for example set the default timestamp at the full hour relatively to current time, with the format string "dd/MM/yyyy HH:00:00".
To be precise : if current time is 09/02/2024 19:45:29, the new value timestamp will default to 09/02/2024 19:00:00 when the display is opened or refreshed. The user may then change this timestamp before sending the new value.
Borders :
Color
Weight (from 0 pixel to 20 pixels)
Reset: The "Use default settings" button helps you to revert back each configuration option to its default value (including all datasources)
Technical considerations
Compatibility
This custom symbol is compatible with PI Vision 2017 R2 or later.
Tested with :
PI Vision 2017 R2 SP1 (build 3.3.1.0)
PI Vision 2019 Patch 1 (build 3.4.1.0)
PI Vision 2020 Patch 1 (build 3.5.1.0)
PI Vision 2021 Patch 1 (build 3.6.1.0)
PI Vision 2022 (build 3.7.0.0)
PI Vision 2022 Patch 1 (build 3.7.1.0)
PI Vision 2023 (build 3.8.0.0)
PI Vision 2023 SP1 Patch 1 (build 3.9.1.0)
Data retrieval
Based on PI Web API.
Tested with :
PI Web API 2018 SP1 (version 1.11.1.5474)
PI Web API 2019 SP1 (version 1.13.0.6518)
PI Web API 2021 SP2 (version 1.16.0.254)
PI Web API 2021 SP3 (version 1.17.0.200)
PI Web API 2023 (version 1.18.0.572)
Asset Switching
This custom symbol is fully compatible with the asset switching feature.