This Service is used to update historical values or Events of one or more Nodes. Several request parameters indicate how the Server is to update the historical value or Event. Valid actions are Insert, Replace or Delete.
Table 62 defines the parameters for the Service.
Table 62 – HistoryUpdate Service Parameters
|
Name |
Type |
Description |
|
Request |
|
|
|
requestHeader |
RequestHeader |
Common request parameters (see 7.33 for RequestHeader definition). |
|
historyUpdateDetails [] |
Extensible Parameter HistoryUpdate Details |
The details defined for this update. The HistoryUpdateDetails parameter type is an extensible parameter type formally defined in OPC 10000-11. It specifies the types of history updates that can be performed. The ExtensibleParameter type is defined in 7.17. |
|
Response |
|
|
|
responseHeader |
ResponseHeader |
Common response parameters (see 7.34 for ResponseHeader definition). |
|
results [] |
HistoryUpdate Result |
List of update results for the history update details. The size and order of the list matches the size and order of the details element of the historyUpdateDetails parameter specified in the request. This structure is defined in-line with the following indented items. |
|
statusCode |
StatusCode |
StatusCode for the update of the Node (see 7.39 for StatusCode definition). |
|
operationResults [] |
StatusCode |
List of StatusCodes for the operations to be performed on a Node. The size and order of the list matches the size and order of any list defined by the details element being reported by this result entry. |
|
diagnosticInfos [] |
DiagnosticInfo |
List of diagnostic information for the operations to be performed on a Node (see 7.12 for DiagnosticInfo definition). The size and order of the list matches the size and order of any list defined by the details element being reported by this results entry. This list is empty if diagnostics information was not requested in the request header or if no diagnostic information was encountered in processing of the request. |
|
diagnosticInfos [] |
DiagnosticInfo |
List of diagnostic information for the history update details. The size and order of the list matches the size and order of the details element of the historyUpdateDetails parameter specified in the request. This list is empty if diagnostics information was not requested in the request header or if no diagnostic information was encountered in processing of the request. |
Table 63 defines the Service results specific to this Service. Common StatusCodes are defined in Table 182.
Table 63 – HistoryUpdate Service Result Codes
|
Symbolic Id |
Description |
|
Bad_NothingToDo |
See Table 182 for the description of this result code. |
|
Bad_TooManyOperations |
See Table 182 for the description of this result code. |
Table 64 defines values for the statusCode and operationResults parameters that are specific to this Service. Common StatusCodes are defined in Table 183. History access specific StatusCodes are defined in OPC 10000-11.
Table 64 – HistoryUpdate Operation Level Result Codes
|
Symbolic Id |
Description |
|
Bad_NotWritable |
See Table 183 for the description of this result code. |
|
Bad_HistoryOperationInvalid |
See Table 183 for the description of this result code. |
|
Bad_HistoryOperationUnsupported |
See Table 183 for the description of this result code. |
|
Bad_UserAccessDenied |
See Table 182 for the description of this result code. The current user does not have permission to update the history. |