6 Historical Access specific usage of Services ToC Previous Next

6.4 HistoryReadDetails parameters ToC Previous Next

6.4.6 ReadAnnotationDataDetails structure ToC Previous Next

6.4.6.1 ReadAnnotationDataDetails structure details ToC

Table 24 defines the ReadAnnotationDataDetails structure.

Table 24 – ReadAnnotaionDataDetails

Name Type Description
ReadAnnotationDataDetails Structure Specifies the details used to perform an “at time” history read.
   reqTimes [] UtcTime The entries define the specific timestamps for which values are to be read.

6.4.6.2 Read Annotation Data functionality ToC

The ReadAnnotationDataDetails structure reads the Annotaion Data from the history database for the specified timestamps for one or more HistoricalDataNodes.

The order of the Annotations Data returned shall match the order of the timestamps supplied in the request.

If Annotation Data is not supported for a HistoricalDataNode then the StatusCode shall be Bad_HistoryOperationUnsupported.

If the read request is taking a long time to calculate then the Server may return zero results with a ContinuationPoint that allows the Server to resume the calculation on the next Client HistoryRead call.

Previous Next