Advanced Manual Entry

Revision History

Revision No.	Date	Author	Document ID	Description of changes
9.4	September 2025	RS	EW_AdvancedManualEntry_v9.4	Bug Fix Inverted Datasource on onDataSourceChange Method Added section Manage Assets
9.3	September 2025	RS	EW_AdvancedManualEntry_v9.3	Bug Fix: Widget now correctly parse LastTime date
9.2	May 2025	RS	EW_AdvancedManualEntry_v9.2	Added feature Bulk Import
9.1	May 2025	RS	EW_AdvancedManualEntry_v9.1	Added feature Get Support
9.0	April 2025	RS	EW_AdvancedManualEntry_v9.0	First version

Document References

Document	Description
PI Vision Installation and Administration Guide	PI Vision™ user manual from AVEVA

Introduction

The Advanced Manual Entry (AME) widget, via a data table, allows visualization, edit and save of different data.
It also allows the user to export/import data data as a csv file.

The PI Vision of AVEVA is available from 2017 and allows viewing real-time data from PI Data Archive and data organized in assets from the AVEVA Asset Framework (PI-AF). In order to achieve PI Vision displays, simply access https://webServer/PIVision (indicating the correct name of the webserver machine).

The most recent versions of most HTML5 compatible browsers are supported on computers, tablets and phones running Android and iOS.
In PI Vision the configuration of the elements is quite intuitive and is characterized by a simple drag-and-drop of the control into the display.

Definitions, Acronyms And Abbreviations

Acronyms and definitions that are used in the current manual are listed below.

Term	Definition

Operating Principles And Use

To insert the widget, select the corresponding icon and navigate to the asset to be displayed and drag all the attributes involved by the Advanced Manual Entry in the display area.

Then by selecting the contextual menu you can access the specific configuration of the widget.

Functionality and use

Widget use is very intuitive. On a PI Vision display it shows a table containing:

For every row the data relative to the selected asset.
- The header of every column contains an icon that allows the ordering of the table based on the column name.
- Next to the order icon there is a handle that allows the scaling of the column.
Undo and redo buttons. Start as disabled until the user inserts a new value.
Load CSV button. Allows the user to load data via CSV file. For the upload data from CSV the user has to provide at least the "path" column and every date should be in ISO format otherwise it will not work.
Refresh table data button.
Save table data button.

Inserting value

For each row, in the columns named Last Value, Value and Time, the user can insert a new value. Once the compilation is completed, the confirmation button writes the new data for each row. If the attribute is configured with PIPoint data reference and ReadOnly flag = false, writing is also performed on the tag. Customization and configuration The widget configuration allows you to change the look in terms of colors, text size, and display language.

Language

The section International allows users to choose the language with which the user visualizes labels and configuration parameters.

Figure 4 - Language selection

Import/Export Data

The export data section contains two toggles:

the first for displaying the show bulk import button that will appear under the table next to the other buttons.
the second for displaying the export button that will appear under the table next to the load data from csv button. You can choose to export the data in two formats: CSV and XLS.

Figure 5 - Toggle visibility export data button

Figure 6 - Bulk import button

Figure 7 - Export data button

Bulk Import

Clicking on the bulk import button allows the user to load a csv file containing the data.
When the file is loaded a new window will appear containing a table with all the data loaded and, if the columns Path, Value and Time are present they will be automatically selected and colored with different colors. The user can freely change the selected columns from which the path, value and the time will be used for the bulk import.
The column containing the paths of the elements is mandatory for the correct working of the widget.

Figure 8 - Columns association table

After the selection of the columns the user can click the import button to proceed to the next step or can cancel the whole process.

Figure 9 - Cancel/Import buttons

The step after clicking the import button contains the table populated with the data of the selected columns.

Figure 10 - Table with loaded data

The user can at this point stop the bulk import via the exit bulk button or can decide to save the data.

Figure 11 - Exit bulk import and save data button

After clicking save data the widget will give a feed back if the save completed successfully or not.

Figure 12 - Success data upload feedback

If the data does not upload with success the element creating the error will be highlighted with and a tooltip will show the error message.

Figure 13 - Error message

Figure 14 - Table with error line highlighted

It is useful to know that all the lines not generating the error will save the data correctly and only the line highlighted in red needs to be checked before uploading the data again.

Rows

It allows re-order of the rows from the table.

Figure 15 - Rows

Columns

For each column the user can decide to hide it. For the Last Value, Value and Time columns it's also possible to disable the edit of the row values.

Figure 16 - Columns Section

General

Default Time allows, for the time column, to set a default time in Pi Vision format.

Figure 17 - Default time

Figure 18 - Column time with default time set

Group allows the user to group the elements in the table based on the element type or the element they belong to.

Figure 19 - Group by attribute type

Figure 20 - Group by attribute type table

Figure 21 - Group by asset

Figure 22 - Group by asset table

Auto Expand allows the groups created before to auto expand or not.

Figure 23 - Auto expand off

Figure 24 - Auto expand off table

The number of decimals allows the user to choose how many decimal numbers are shown for the numeric values on the last value column.

Figure 25 - Number of decimals

Figure 26 - Table with three decimal numbers

Multi state configurations

For every row in the table it is possible to configure a multistate. Selecting a row the option to activate the multistate will appear.
Activating the multistate a default value will appear followed by the "Add". Using the "Add" button is possible to add new thresholds that can be configured as needed.

Figure 27 - Multistate configured for Double Attribute

Figure 28 - Table with multistate active for double attribute

Appearance Settings

In this section is possible to change the graphic settings of the widget for:

Title
Title color
Text size
Text color
Table color
Background Color

Figure 29 - Appearance Setting section

Assets

List of attributes dragged into the display to create the widget.
If there are more than one, it is possible to delete an asset by clicking on the symbol

Figure 30 - Asset section

Contacts

Get Support button (read Get Support documentation)

Link to e-matica.com (click on the icon)

Link to widget online documentation (click on link)

Figure 31 - Contacts

Installation

Following are the installation requirements and procedure.

Requirements

In order to install the product, minimum requirements are listed in the table below:

Software	Version	Note
PI Vision	2024 (*)	Requirements are linked to the PI Vision correct functioning

Table 1 - Installation prerequisites

(*)This widget is also compatible with PI Vision 2023, 2022, 2021, 2020 and 2019.

We suggest using Google Chrome for full compatibility with the widget.

Installation procedure

The installation procedure involves the copy of different folders and files in the predefined PI Vision path.

In particular it is necessary to copy the following filed in the folder ..\PIPC\PIVision\Scripts\app\editor\symbols\ext:

sym-EWAdvancedManualEntry.js
sym-EWAdvancedManualEntry-config.html
sym-EWAdvancedManualEntry-template.html

and in the folder ..\PIPC\PIVision\Public the following folders:

Images that contains the control icon:
- EWAdvancedManualEntry.png
Libs with the libraries used:
- EWClasses.js
- moment.js
- TweenMax.min.js

Notes And References

For more information about Vision PI refer to documentation on AVEVA © portal.
For information about the web service to refer to the specific documentation.

- PI Vision Widget -​

Revision History​

Document References​

Introduction​

Definitions, Acronyms And Abbreviations​

Operating Principles And Use​

Figure 1 - PI Vision Menu​

​

Figure 2 - Contextual Menu​

Functionality and use​

Figure 3 - Widget Advanced Manual Entry​

Inserting value​

Language​

Figure 4 - Language selection​

Import/Export Data​

​

Figure 5 - Toggle visibility export data button​

Figure 6 - Bulk import button​

Figure 7 - Export data button​

Bulk Import​

Figure 8 - Columns association table​

Figure 9 - Cancel/Import buttons​

Figure 10 - Table with loaded data​

Figure 11 - Exit bulk import and save data button​

Figure 12 - Success data upload feedback​

Figure 13 - Error message​

Figure 14 - Table with error line highlighted​

Rows​

Figure 15 - Rows​

Columns​

Figure 16 - Columns Section​

General​

Figure 17 - Default time​

Figure 18 - Column time with default time set​

Figure 19 - Group by attribute type​

Figure 20 - Group by attribute type table​

Figure 21 - Group by asset​

Figure 22 - Group by asset table​

Figure 23 - Auto expand off​

Figure 24 - Auto expand off table​

Figure 25 - Number of decimals​

Figure 26 - Table with three decimal numbers​

Multi state configurations​

Figure 27 - Multistate configured for Double Attribute​

Figure 28 - Table with multistate active for double attribute​

​

Appearance Settings​

Figure 29 - Appearance Setting section​

Assets​

Figure 30 - Asset section​

Contacts​

Figure 31 - Contacts​

​

Installation​

Requirements​

Table 1 - Installation prerequisites​

​

Installation procedure​

Notes And References​

- PI Vision Widget -