The HistoryRead Service defined in OPC 10000-4 can perform several different functions. The HistoryReadDetails parameter is an Extensible Parameter that specifies which function to perform and the details that are specific to that function. See OPC 10000-4 for the definition of Extensible Parameter. Table 27 lists the symbolic names of the valid Extensible Parameter structures. Some structures will perform different functions based on the setting of its associated parameters. For simplicity the functionality of each structure is listed. For example, text such as ‘using the Read modified functionality’ refers to the function the HistoryRead Service performs using the Extensible Parameter structure ReadRawModifiedDetails with the isReadModified Boolean parameter set to TRUE.

Table 27 – HistoryReadDetails parameter Symbolic Names

Symbolic Name

Functionality

Description

ReadEventDetails

Read event

This structure selects a set of Events from the history database by specifying a filter and a time domain for one or more Objects or Views. See 6.5.2.1.

When this parameter is specified, the Server returns a HistoryEvent structure for each operation (see 6.6.4).

ReadEventDetails2

Read event

This structure selects a set of Events from the history database by specifying a filter and a time domain for one or more Objects or Views. See 6.5.2.1.

When this parameter is specified, the Server returns a HistoryEvent structure for each operation (see 6.6.4).

ReadEventDetails2

Read event modified

This structure selects a set of modified Events from the history database by specifying a filter and a time domain for one or more Objects or Views. See 6.5.2.3

When this parameter is specified, the Server returns a HistoryModifiedEvent structure for each operation (see 6.6.4).

ReadRawModifiedDetails

Read raw

This structure selects a set of values from the history database by specifying a time domain for one or more Variables. See 6.5.3.1.

When this parameter is specified, the Server returns a HistoryData structure for each operation (see 6.6.2).

ReadRawModifiedDetails

Read modified

This parameter selects a set of ModifiedValues from the history database by specifying a time domain for one or more Variables. See 6.5.3.1.

When this parameter is specified, the Server returns a HistoryModifiedData structure for each operation (see 6.6.3).

ReadProcessedDetails

Read processed

This structure selects a set of Aggregate values from the history database by specifying a time domain for one or more Variables. See 6.5.4.1.

When this parameter is specified, the Server returns a HistoryData structure for each operation (see 6.6.2)

ReadAtTimeDetails

Read at time

This structure selects a set of raw or interpolated values from the history database by specifying a series of timestamps for one or more Variables. See 6.5.5.1.

When this parameter is specified, the Server returns a HistoryData structure for each operation (see Clause 6.6.2).

ReadAnnotationDataDetails

Read Annotation Data

This structure selects a set of Annotation Data from the history database by specifying a series of timestamps for one or more Variables. See 6.5.6.1.

When this parameter is specified, the Server returns an Annotation structure for each operation (see Clause 6.6.6).

The HistoryReadDetails Structure definition in the AddressSpace is shown in Table 28. The Structure is an abstract supertype and contains no fields.

Table 28 – HistoryReadDetails definition

Attribute

Value

BrowseName

HistoryReadDetails

IsAbstract

True

References

NodeClass

BrowseName

DataType

TypeDefinition

Other

Subtype of the Structure defined in OPC 10000-3

Conformance Units

Historical Access Read Raw