OPC 10000-11: UA Part 11: Historical Access

Released 1.05.03

2023-12-13

This document is subject to the license terms described here.

The general OPC Foundation specification license agreement also applies and can be found here.

This document is a copy of the original which can be found here.

1 Scope 2 Normative references 3 Terms, definitions, and abbreviations 3.1 Terms and definitions 3.1.1 Annotation 3.1.2 BoundingValues 3.1.3 Historian 3.1.4 HistoricalNode 3.1.5 HistoricalDataNode 3.1.6 HistoricalEventNode 3.1.7 ModifiedValues 3.1.8 RawData 3.1.9 StartTime/EndTime 3.1.10 TimeDomain 3.1.11 StructuredHistoryData 3.2 Abbreviated terms 4 Concepts 4.1 General 4.2 Data architecture 4.3 Historians and interruption of data collection 4.4 Modification of Historical Data/Events 4.5 Timestamps 4.6 Bounding Values and time domain 4.7 Changes in AddressSpace over time 5 Historical Information Model 5.1 HistoricalNodes 5.1.1 General 5.1.2 Annotations Property 5.2 HistoricalDataNodes 5.2.1 General 5.2.2 HistoricalDataConfigurationType 5.2.3 Attributes 5.2.4 Historical Data Configuration Object 5.3 References 5.3.1 Overview 5.3.2 HasHistoricalConfiguration ReferenceType 5.3.3 HasCurrentData ReferenceType 5.3.4 HasCurrentEvent ReferenceType 5.4 HistoricalEventNodes 5.4.1 General 5.4.2 HistoricalEventFilter Property 5.4.3 HistoricalEventConfigurationType 5.4.4 HistoricalEventNodeAttributes 5.5 External History sources 5.5.1 Introduction 5.5.2 External Historical Event Node 5.6 Example Object Models in Historian Servers (informative) 5.6.1 Overview 5.6.2 HistoricalDataNodes Address Space Model 5.6.3 Historical data 5.6.4 HistoricalEventNodes Address Space Model 5.6.5 Historical Events 5.7 Exposing supported functions and capabilities 5.7.1 General 5.7.2 HistoryServerCapabilitiesType 5.7.3 Default Configuration 5.8 Historical Audit Events 5.8.1 General 5.8.2 AuditHistoryEventUpdateEventType 5.8.3 AuditHistoryValueUpdateEventType 5.8.4 AuditHistoryAnnotationUpdateEventType 5.8.5 AuditHistoryDeleteEventType 5.8.6 AuditHistoryRawModifyDeleteEventType 5.8.7 AuditHistoryAtTimeDeleteEventType 5.8.8 AuditHistoryEventDeleteEventType 5.8.9 AuditHistoryConfigurationChangeEventType 5.8.10 AuditHistoryBulkInsertEventType 6 Historical Access specific usage of Services 6.1 General 6.2 Historical Nodes StatusCodes 6.2.1 Overview 6.2.2 Operation level result codes 6.2.3 Semantics changed 6.3 Continuation Points 6.4 Arrays, index ranges and substrings 6.5 HistoryReadDetails parameters 6.5.1 Overview 6.5.2 ReadEventDetails structure 6.5.2.1 ReadEventDetails structure details 6.5.2.2 Read Event functionality 6.5.2.3 ReadEventDetails2 structure details 6.5.2.4 Read modified functionality 6.5.3 ReadRawModifiedDetails structure 6.5.3.1 ReadRawModifiedDetails structure details 6.5.3.2 Read raw functionality 6.5.3.3 Read modified functionality 6.5.4 ReadProcessedDetails structure 6.5.4.1 ReadProcessedDetails structure details 6.5.4.2 Read processed functionality 6.5.5 ReadAtTimeDetails structure 6.5.5.1 ReadAtTimeDetails structure details 6.5.5.2 Read at time functionality 6.5.6 ReadAnnotationDataDetails structure 6.5.6.1 ReadAnnotationDataDetails structure details 6.5.6.2 Read Annotation Data functionality 6.6 HistoryData parameters returned 6.6.1 Overview 6.6.2 HistoryData type 6.6.3 HistoryModifiedData type 6.6.4 HistoryEvent DataType 6.6.5 HistoryModifiedEvent DataType 6.6.6 Annotation DataType 6.7 HistoryUpdateType Enumeration 6.8 PerformUpdateType Enumeration 6.9 HistoryUpdateDetails parameter 6.9.1 Overview 6.9.2 UpdateDataDetails structure 6.9.2.1 UpdateDataDetails structure details 6.9.2.2 Insert data functionality 6.9.2.3 Replace data functionality 6.9.2.4 Update data functionality 6.9.3 UpdateStructureDataDetails structure 6.9.3.1 UpdateStructureDataDetails structure details 6.9.3.2 Specified Uniqueness of StructuredHistoryData 6.9.3.3 Insert functionality 6.9.3.4 Replace functionality 6.9.3.5 Update functionality 6.9.3.6 Remove functionality 6.9.4 UpdateEventDetails structure 6.9.4.1 UpdateEventDetails structure detail 6.9.4.2 Insert event functionality 6.9.4.3 Replace event functionality 6.9.4.4 Update event functionality 6.9.5 DeleteRawModifiedDetails structure 6.9.5.1 DeleteRawModifiedDetails structure detail 6.9.5.2 Delete raw functionality 6.9.5.3 Delete modified functionality 6.9.6 DeleteAtTimeDetails structure 6.9.6.1 DeleteAtTimeDetails structure detail 6.9.6.2 Delete at time functionality 6.9.7 DeleteEventDetails structure 6.9.7.1 DeleteEventDetails structure detail 6.9.7.2 Delete event functionality Annex A (informative)Client conventions A.1 How clients may request timestamps A.2 Determining the first or last historical data point