Use a URL-based query to create charts

The base URL

https://online.wonderware.[DOMAINSUFFIX]/framework/content

Note: /framework will generate a chart

An indicator showing that parameters are to follow

?

Query parameters

tags=WeatherApp.Auckland.Cloudiness
&chartType=LineChart
&startTime=2017-03-29T08:45:00.000
&endTime=2017-03-30T08:45:00.000

Tags

(required) Defines the tags to include in the chart. Use the case-sensitive, fully qualified name for each tag (that is, the data source name plus the tag name). Separate tag names with commas.

For example: Tags=MyDataSource.Pump12.Temp,MyDataSource.Pump12.Speed

StartTime

Specifies the when the reporting time period begins, using this format:

yyyy-MM-dd'T'HH:mm:ss.fff

For example: StartTime=2017-03-27T08:47:40.763

Note that milliseconds, represented by fff, are optional.

StartTime is in local time (ISO 8601 format) for the client computer. To use UTC format, append the time with a z (New Look only).

If no value is provided, the default is Today.

EndTime

Specifies the when the reporting time period begins, using this format:

yyyy-MM-dd'T'HH:mm:ss.fff

For example: EndTime=2017-03-28T12:47:40.763

Note that milliseconds, represented by fff, are optional.

EndTime is in local time (ISO 8601 format) for the client computer. To use UTC format, append the time with a z (New Look only).

If no value is provided, the default is Today.

DurationHours

Specifies the duration to report, in hours. This parameter also supports decimal input. DurationHours is used only if provided.

For example: DurationHours=2.5

sliceBy

Specifies the event aggregate in a column chart. This parameter accepts the fully qualified name of a non-analog tag. For example: sliceBy=IntouchAlarm.ConcValve1

If sliceBy is provided in the URL along with resolution or timeAggregate, those parameters are ignored and event aggregate is selected for the chart.

If no tag name, or an invalid tag name, is provided for sliceBy, the sliceBy option is ignored.

resolution

Specifies a time aggregate in milliseconds for a chart supporting time aggregate options. For example: resolution=900000.

resolution accepts any value, in milliseconds.

timeAggregate

Specifies a time aggregate in daily or hourly values for a chart supporting time aggregate options. For example: timeAggregate=Day

The following values are supported:

• Day

• Hour

• Event

• TimeInState (Only on Column Chart types)

• A value in minutes, such as 90. Providing a value populates the Custom Duration field in supported chart types.

  Alternatively, you can provide 1, 2, 3, or 4 for Day, Hour, 15minute, or Event, respectively.

  The following rules apply:

• If the sliceBy query parameter is used, then timeAggregate is automatically set to Event and any other timeAggregate option is ignored.

• If resolution and timeAggregate are both provided, only resolution is considered.

valueAggregate

Specifies a value aggregate for a chart supporting value aggregate options. For example: valueAggregate=average.

Valid values are:

• minimum

• maximum

• total

• average

• last

• meter (Only on Column and Summary chart types)