Ad Hoc Workspace URLs with data items

You may want to generate URLs that allow users to directly open the Ad Hoc Workspace, with the workspace showing specific data items during a specific time range. For example, if an exception occurs, you could use third-party tools to generate an Ad Hoc Workspace URL that is automatically sent to relevant users, so that those users can investigate the issue.

The parameters that you can use with an Ad Hoc Workspace URL include:

• DataItems - specifies which data items appear in the Ad Hoc Workspace. You can include multiple data items.

• StartTime - specifies the start time for the span of time that is shown on the Ad Hoc Workspace.

• EndTime - specifies the end time for the span of time that is shown on the Ad Hoc Workspace.

• TZ - specifies a time offset from UTC time so that users see the time zone that you specify.

For more information about using these parameters and their syntax rules, refer to URL parameters reference.

Examples

The following are examples of Ad Hoc Workspace URLs with parameters:

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

  https://webserver/website/#/AdHocWorkspace?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 is applied.

• Multiple data items in a specified time range

  https://webserver/website/#/AdHocWorkspace?DataItems=\\afserver
  \B-210|Temperature;\\piserver\aPIPoint&StartTime=25-sep-25&EndTime=27-sep-25

  The semicolon (;) separates data items. Attributes from the same asset must be specified completely. The parameters are separated with an ampersand (&). The Ad Hoc Workspace shows data from the time range of midnight September 25, 2025, to midnight September 27, 2025.