Skip to main content

Documentation Portal

Installation Procedure

Procedure

  1. Download the navigationLink zip file from https://files.trendminer.com/hps/pivision/.

  2. Use the file explorer to go to the PI Vision directory. In the file explorer navigation bar type in %pihome64%, this will open up the PI Vision directory, e.g. C:\Program Files\PIPC

    Navigate to the subdirectory \PIVision\Scripts\app\editor\symbols\ext

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

  3. Extract the downloaded file in this directory.

    Important

    Do not change the names of these files.

    1. Three files are added to this directory:

      1. sym-navigationLink.js

      2. sym-navigationLink-config.html

      3. sym-navigationLink-template.html

    2. Three directories, each containing one or more files, are also added to this directory:

      1. libraries

      2. icons

      3. assets

  4. Confirming the plugin is visible within PI Vision.

    1. Go to PI Vision

      e.g. https://example.com/PIVision, example.com has to be replaced with the configured url.

    2. Click on 'New Display' in the top right of the screen.

      PI_Vision_2.png

    3. A new 'symbol' (highlighted in the picture below) has been added.

      PI_Vision_3.png
Content Security Policy (CSP)

Starting with the 2020 release of PI Vision, stricter CSP policies were introduced. The TrendMiner plugin relies on 2 local libraries to be loaded (part of the installation files) to ensure browser compatibility.

To safely permit these 2 libraries to be loaded, add the following key entry to your PI Vision web.config file:

<add key="ScriptSrcPolicy" value="'sha256-gek/Vuej/Jl9F6njjNGk4Dn9tmM0DlWFmeuT+7qXYTw=' 'sha256-1mqegnFGx8//91ISAydSFyNS3J7Kge/j/0E+ueAI9zo='" />

Example usage

For this example another 'symbol' will be used to provide the data we want to visualize in TrendHub. More specifically the 'Trend symbol' will be used.

  1. Click on 'New Display' in the top right of the screen.

    PI_Vision_4.png

  2. Select the 'Trend symbol' in the top bar.

    PI_Vision_5.png

  3. Select in the list below the assets or attributes/tags you want to visualize.

    PI_Vision_6.png

  4. Drag and drop the selected asset or attribute/tag onto the dashboard.

    Example asset:

    PI_Vision_7.png

    Example attribute/tag:

    PI_Vision_8.png

  5. Repeat step 1-3 if you want to add multiple assets or attributes/tags.

    PI_Vision_9.png

  6. Select the 'TrendMiner Navigation Link symbol'.

    PI_Vision_10.png

  7. Select an asset or attribute/tag.

    Note

    This can be any random attribute/tag, it will not be included in the attributes/tags that will be visualized in TrendHub. Selecting an attribute/tag in order to be able to drag and drop a symbol on the dashboard is a requirement of PI Vision.

  8. Drag and drop the 'TrendMiner Navigation Link symbol' onto the dashboard.

    PI_Vision_11.png

  9. Right click on the 'Open in TrendHub' button and select 'Configure...', resulting in a sidebar appearing on the right side of the screen.

    PI_Vision_12.png

    1. TrendMiner server: the full url pointing towards the TrendMiner installation e.g. https://my-trendminer-application.my-company.com.

    2. PI Web API url: the full url pointing towards the PI Web API e.g. https://my-pi-web-api-server.com/piwebapi

    3. Prefix: Sometimes historian servers in TrendMiner are configured with a prefix. Ask an admin what the configured prefixes for the servers are. If no prefix has been configured, this field can be left empty.

      PI_Vision_13.png
      PI_Vision_14.png

      The screen where a configured prefix can be found by an admin.

    To avoid having to configure the url of the TrendMiner server and or the prefix in every dashboard, the admin can set a default url and prefix in the code of the custom symbol. This url will be used when no url is specified in the config panel of the custom symbol.

    1. Use the file explorer to go to the PI Vision installation folder. In the navigation bar type in %pihome64%, this will open up the PI Vision directory. e.g. C:\Program Files\PIPC

    2. From there navigate to the “\PIVision\Scripts\app\editor\symbols\ext” sub-folder.

    3. Edit the file sym-navigationLink.js:

      • To set a default url: add the url on line 3: var defaultURL = ‘your-url-here’;

      • To set a default prefix: add the prefix on line 4: var defaultPrefix = ‘your-prefix-here’;

    4. Save the file and refresh PI Vision in the browser.

  10. Click the 'Open in TrendHub symbol' on the dashboard. This will open a view in TrendHub, visualizing all the attribute/tags that are configured on the other symbols that are on the dashboard.

    PI_Vision_15.png

    Note

    Duplicate attributes/tags will be filtered out. In the examples used in this guide 'Temperature' and 'Concentration' are visible twice on the dashboard (step 5), once in the TrendHub visualization.

    Important

    All attributes/tags (used in steps 3. and 4.) must come from the same 'historian server'. Or in other words, they all need to use the same prefix (as described in step 9b).

Dans cette section​: