Hourly (v1 only)

Description

Retrieves hourly summary values for the tags specified. The default for Hourly is to report summary values for the last 24 hours.

URL

/Hourly

Method

GET 

Required Parameters

• FQN=[string]
  The fully qualified name for the tag. A fully qualified tagname uses the format: DataSourceName.TagName.

• StartDateTime=[DateTimeOffset]
  The starting date and time for the retrieval cycle. This is always specified in UTC using the RFC3339 / ISO8601 format with the Z time zone designator. For example: 2016-09-03T18:44:09.352247Z

• EndDateTime=[DateTimeOffset]
  The ending date and time for the retrieval cycle. This is always specified in UTC using the RFC3339 / ISO8601 format with the Z time zone designator. For example: 2016-09-03T18:44:09.352247Z

Optional Parameters

• TimeZone=[string]
  The timezone used for the timeframe. See "Accepted values for TimeZone" below.

• OPCQuality=[Int32]
  OPC quality. Normal OPC quality retrieval logic is applied if:

  All the point found and processed for this row have GOOD quality. If they all have the same GOOD quality, then that quality is returned.

  If there is a gap in the entire calculation cycle, then BAD quality is returned for the tag.

  For any other scenario with any mixture of GOOD and BAD points, a DOUBTFUL OPC quality (64) is returned.

• PercentGood=[Double]
  The ratio of the number of rows that have "good" quality to the total number of rows in the retrieval cycle, expressed as a percentage in the range 0 to 100.

• Analog=[analog statistics]
  An embedded collection that maps to AnalogSummary.

• Split=[collection of state statistics]
  An embedded collection that maps to StateSummary for the ValueState retrieval mode.

• Contained=[collection of state statistics]
  An embedded collection that maps to StateSummary for the ContainedState retrieval mode.

• Raw
  A URL used to retrieve all stored values for a specified time period and tag. This is equivalent to a preconfigured ProcessValue query.

• Minute