PI Vision release and compatibility guide
PI Vision 2024 adds useful display, administration, and security improvements. This guide shows what to check before upgrading when your dashboards also depend on Vision Library+ symbols.
A PI Vision upgrade is more than a server-side installation. It can change how teams edit displays, organize folders, apply permissions, and load custom symbols. Use the release as an opportunity to test the complete path from the PI Vision web application to the symbols and configuration files that support daily operations.
What changed in PI Vision 2024?
PI Vision 2024, version 3.10.0.0, introduced improvements across display editing, homepage navigation, permissions, and administration. The exact behavior of a feature still depends on your deployment and security configuration, so validate the items that matter to your users in a non-production environment first.
Faster display editing
Apply fonts and font sizes across symbols, bulk-edit multiple symbols, and use the new Time Series Table and Multi-State Table options for more structured process views.
More useful navigation
Sort displays, switch between thumbnail and tabular views, open folders through direct URLs, and move folders with their contents.
Stronger administration
Manage read, write, manage, and administrator permissions, control inheritance, and review active display sessions and loading metrics.
Release features worth testing
Display editing
Confirm that fonts, font sizing, bulk editing, rich text, and preserved zoom levels behave as expected in the displays your operators maintain.
Tables and conditional formatting
Test the Time Series Table and Multi-State Table with representative PI data. Check timestamps, units, row formatting, and the behavior of empty or bad-quality values.
Folders and permissions
Test direct folder URLs, sorting, tabular view, folder moves, inherited permissions, and the experience for users who have different access levels.
Performance and monitoring
Compare loading behavior for Analysis, StringBuilder, and UriBuilder attributes. Use active-user information to identify slow or unexpectedly heavy displays.
Vision Library+ compatibility
Vision Library+ custom symbols are designed to extend PI Vision with richer dashboards, interaction, data entry, and operational workflows. After the PI Vision 2024 upgrade, confirm that the library package and each business-critical symbol are supported by the installed PI Vision version.
Compatibility is a deployment check: do not rely only on whether a symbol appears on the display. Validate loading, configuration, data retrieval, interaction, and any write or browser-permission behavior used in production.
| Area | What to verify | Evidence to keep |
|---|---|---|
| Symbol loading | All required symbols render without console or network errors. | Test display and browser log |
| Data behavior | Values, timestamps, quality, units, and time ranges remain correct. | Known-good comparison |
| Interaction | Selections, menus, tooltips, dialogs, and navigation still work. | Operator workflow checklist |
| Configuration | Custom settings and symbol JSON are preserved after deployment. | Backup and deployment record |
| Security | Permissions, CORS, authentication, and write operations behave as intended. | Role-based test results |
Symbols that need special attention
In the original PI Vision 2024 compatibility check, Value+ and WebView+ required the updated Vision Library+ package. If your environment still uses these symbols, install the compatible library release specified by your Software Athlete download or support documentation before completing the production upgrade.
Do not assume that a version number alone proves compatibility. Reopen displays that use these symbols, verify their settings, and test the workflows that depend on them. For a repeatable deployment process, follow the Vision Library+ update guide.
Use a controlled upgrade sequence
Inventory dependencies
List production displays, custom symbols, web.config changes, authentication settings, integrations, and user roles that must be re-tested.
Back up before installation
Back up displays, custom symbol packages, configuration files, and any deployment notes. Record the current versions so a rollback is possible.
Upgrade a test environment
Install PI Vision 2024 and the compatible Vision Library+ package in a representative environment. Test both standard symbols and the most important custom workflows.
Reapply configuration deliberately
Review every custom web.config setting after the upgrade. PI Vision updates can overwrite changes, including settings used for Alarm Sound+ or WebView+.
Publish with evidence
Capture test results, approvals, installed versions, and the final configuration. Keep the record with the deployment so future upgrades start from known information.
Post-upgrade validation checklist
Operator view
- Displays open at the expected zoom and time range.
- Trends, tables, gauges, and custom symbols show current data.
- Navigation and symbol interactions work for the operator role.
Administrator view
- Folder access and inherited permissions match the design.
- Active-user and loading information is available.
- Configuration changes are documented and recoverable.
Failure paths
- Test missing data, bad quality, and unavailable symbols.
- Confirm errors are visible and actionable.
- Verify the rollback or recovery procedure.
A successful upgrade is one that preserves dependable daily work, not merely one that completes the installer. Validate the displays and symbols people use, retain evidence of the checks, and schedule a follow-up after production users have exercised the new release.
Make PI Vision upgrades predictable
Use a tested compatibility checklist for PI Vision, Vision Library+, custom symbols, permissions, and configuration changes.
Explore Vision Library+
