Installation Guide

How to install custom symbols and extensions to AVEVA PI Vision (formerly Coresight).

1. Deploy Files

Extract the downloaded ZIP archive. You will see HTML, JS, and image files.

Copy these files to the PI Vision server directory:

%PIHOME%\Scripts\app\editor\symbols\ext

Typically, this path translates to:

C:\Program Files\PIPC\PIVision\Scripts\app\editor\symbols\ext

// File structure after extraction

ext/
sym-SmartSQCPro.html
sym-SmartSQCPro.js
icon.png

2. Unblock Files

Windows blocks downloaded files by default. Skip this step and the symbol will silently fail to load.

1

Right-click the .js or .html file

Select Properties from the context menu

2

Find the Unblock checkbox

Located at the bottom of the General tab, next to the Security warning

3

Check Unblock → Click Apply → OK

Repeat for each file in the package

sym-SmartSQCPro.js Properties
General | Security | Details

Type: JavaScript File

Size: 48 KB

⚠ Security: This file came from another computer...
Cancel Apply

3. License Key Activation

After purchase, a license key is delivered to your email and visible in your PIForge dashboard.

1

Open your PIForge Dashboard

Log in → Click Dashboard in the nav → find your purchase under My Licenses

2

Copy your License Key

Format: XXXX-XXXX-XXXX-XXXX

3

Enter the key inside PI Vision

Open the symbol on a display → click the settings (⚙) icon → paste into the License Key field

A3F9 — 7BK2 — X1PQ — 9ZW4

Example license key format

4. PI Vision Compatibility

Not sure which version you have? In PI Vision, go to Help → About to see the version number.

PI Vision Version Smart SQC Pro Notes
2022+ Full Support Recommended
2021 Full Support —
2020 Full Support —
2019 Partial Some features limited
2018 or older Not Supported —

How to check your PI Vision version

In PI Vision → top-right menu → Help → About PI Vision. The version number is shown at the top of the dialog.

5. Troubleshooting

Symbol doesn't appear in asset pane

  • Verify files are in the correct ext folder on the server, not your local PC
  • Hard refresh: Ctrl + Shift + R
  • Check that files are unblocked (step 2)

Symbol loads but shows blank / error

  • Open browser DevTools (F12) → Console tab → check for red errors
  • Confirm license key is entered correctly (no extra spaces)
  • Try restarting IIS on the PI Vision server:
iisreset

License key not accepted

  • Check your email for the original key — copy directly from there
  • Log in to PIForge Dashboard → My Licenses to view/copy again
  • Still not working? Contact support

6. FAQ

Do I need a PIForge account to use the symbol after purchase?
No. Once you have the license key and the symbol files, you can use them on your PI Vision server without being logged in to PIForge.
How many PI Vision servers can I install on with one license?
Each license covers a single PI Vision server installation. For multiple servers, please purchase additional licenses or contact us for volume pricing.
Where do I find my license key after purchase?
Two places: (1) your purchase confirmation email, and (2) your PIForge Dashboard under My Licenses.
Do I need admin rights on the PI Vision server?
Yes. You need write access to the ext folder on the server. This typically requires local administrator or specific IIS permissions.
Can I get a refund?
Due to the digital nature of the product, all sales are final. If you experience a technical issue we cannot resolve, please contact support and we will work with you to find a solution.