Long text
- PI Vision Widget -
Revision History
| Revision No. | Date | Author | Document ID | Description of changes |
|---|---|---|---|---|
| 9.0 | July 2025 | RS | EW_LongText_v.9.0_en.docx | -Compatibility PI Vision 2024 -Graphic restyle |
| 8.0 | August 2023 | AM | EW_LongText_v.8.0_en.docx | Compatibility PI Vision 2023 |
| 7.0 | August 2022 | AM | EW_LongText_v.7.0_en.docx | Compatibility PIVision 2022 |
| 6.0 | October 2021 | MDC | EW_LongText_v.6.0_en.docx | Compatibility PIVision 2021 |
| 4.0 | December 2020 | MDC | EW_LongText_v.4.0_en.docx | First release documentation and specifications |
Document References
| Document | Description |
|---|---|
| PI Vision Installation and Administration Guide | PI Vision™ user manual from AVEVA |
Introduction
The LongText widget for PI Vision allows to view strings within the PIVision. The strings can be of any length and the user can decide the size of the text box, the text size, the text alignment and the colors of the text and of the background.
Compared to the standard “Value” widget, this widget allows you to view very long texts and to wrap when you want by configuring the size of the text box.
Figure 1 – Long Text widget
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 Long Text widget, select the corresponding icon, navigate between the PIVision assets and drag the attribute you want to view onto the display.
Figure 2 - Long Text widget
When the mouse is released, the text is displayed immediately. Later, by calling the context menu with the right mouse button, customizations and configurations are possible.
Figure 3 - Context Menu
Functionality and use
Users can set the size of the text box. (Figure 4).
Figure 4 – Text box size
Customization and configuration
The widget configuration allows to change the appearance in terms of colours, text size and language visualization.
Language
The section Language allows users to choose the language with which the user visualizes labels and configuration parameters.
Figure 5 - Language selection
Appearance Settings
In the Appearance settings section it is possible to change the value and color of:
- Text size;
- Text color;
- Background color;
- Text Alignment;
Figure 6 -Appearance settings
Contacts
Link to e-matica.com (click on the icon)
Link to widget online documentation (click on link)
Figure 7 - 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-EWLongText.js
- sym-EWLongText-config.html
- sym-EWLongText-template.html
and in the folder ..\PIPC\PIVision\Public the following folders:
- Images that contains the control icon:
- EWLongText.png
- Libs with the libraries used:
- EWClasses.js
Then, open the web.config file inside the PIVision folder (..\PIPC\PIVision) and check that debug is set to "true" (Figure 8).
Save the file and restart the IIS.
Figure 8 - web.config
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.