5.11.5 HistoryUpdate
5.11.5.1 Description
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.
5.11.5.2 Parameters
Table 56 defines the parameters for the Service.
| Name | Type | Description |
|---|---|---|
| Request | ||
requestHeader | RequestHeader | Common request parameters (see 7.32 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.33 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.38 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. |
5.11.5.3 Service results
Table 57 defines the Service results specific to this Service. Common StatusCodes are defined in Table 178.
| Symbolic Id | Description |
|---|---|
| Bad_NothingToDo | See Table 178 for the description of this result code. |
| Bad_TooManyOperations | See Table 178 for the description of this result code. |
5.11.5.4 StatusCodes
Table 58 defines values for the statusCode and operationResults parameters that are specific to this Service. Common StatusCodes are defined in Table 179. History access specific StatusCodes are defined in OPC 10000-11.
| Symbolic Id | Description |
|---|---|
| Bad_NotWritable | See Table 179 for the description of this result code. |
| Bad_HistoryOperationInvalid | See Table 179 for the description of this result code. |
| Bad_HistoryOperationUnsupported | See Table 179 for the description of this result code. |
| Bad_UserAccessDenied | See Table 178 for the description of this result code. The current user does not have permission to update the history. |