Temporary (ad hoc) displays with particular data items

A URL can specify data items to show in a single trend on a temporary (ad hoc) display. The data items can be any combination of PI tags, attributes, and assets (PI AF elements). If the URL specifies an asset, all of its attributes appear in the trend.

Users can save a temporary display for later use by making a copy of the display.

The URL can include start and end time parameters for the display time range using any PI time expression. If no start and end times are specified, the default time range of 8 hours ago until now is applied, and the time range is continuously updating.

A trend is the default symbol type for an ad hoc display. To show one scale for the trend rather than a separate scale for every data item, include the Symbol=trend parameter with the MultipleScales=false setting. To change the symbol to a table, include the Symbol=table parameter.

Examples

The following URLs create temporary displays of trends:

• Single attribute (Fuel) from the B-210 asset

  https://webserver/website/#/Displays/AdHoc?DataItems=\\EastCoast\HiEfficiency\B-210|Fuel

  The pipe (|) character separates attributes from elements and parent attributes. No start and end times are specified, so the default time range applies to the display.

• Single asset (B-210) in a specified time range

  https://webserver/website/#/Displays/AdHoc?DataItems=\\EastCoast\HiEfficiency
  \B-210&StartTime=25-sep-19&EndTime=27-sep-19

  This shows data for all attributes of B-210 in the trend on the temporary display during the time range of midnight September 25, 2019, to midnight September 27, 2019.

• Multiple data items

  https://webserver/website/#/Displays/AdHoc?DataItems=\\afserver
  \B-210|Temperature;\\piserver\aPIPoint

  The semicolon separates data items. Attributes from the same asset (Temperature and Fuel) must be specified completely. No start and end times are specified, so the default time range applies to the display. By default, the trend shows a separate scale for each data item.

• Multiple data items with a single value scale

  https://webserver/website/#/Displays/AdHoc?DataItems=\\afserver
  \B-210|Temperature;\\piserver\aPIPoint&Symbol=trend;MultipleScales=false

  Includes the Symbol=trend parameter with the MultipleScales=false setting.