6 Historical Access specific usage of Services ToC Previous Next

6.8 HistoryUpdateDetails parameter ToC Previous Next

6.8.2 UpdateDataDetails structure ToC Previous Next

6.8.2.1 UpdateDataDetails structure details ToC

Table 32 defines the UpdateDataDetails structure.

Table 32 – UpdateDataDetails

Name Type Description
UpdateDataDetails Structure The details for insert, replace, and insert/replace history updates.
   nodeId NodeId Node id of the Object to be updated.
   performInsertReplace PerformUpdateType Value determines which action of insert, replace, or update is performed.
   Value   Description
   INSERT_1   See 6.8.2.2.
   REPLACE_2   See 6.8.2.3.
   UPDATE_3   See 6.8.2.4.
   updateValues[] DataValue New values to be inserted or to replace.

6.8.2.2 Insert data functionality ToC

Setting performInsertReplace = INSERT_1 inserts entries into the history database at the specified timestamps for one or more HistoricalDataNodes. If an entry exists at the specified timestamp, then the new entry shall not be inserted; instead the StatusCode shall indicate Bad_EntryExists.

This function is intended to insert new entries at the specified timestamps, e.g., the insertion of lab data to reflect the time of data collection.

If the Time does not fall within range that can be stored then the related operationResults entry shall indicate Bad_OutOfRange.

6.8.2.3 Replace data functionality ToC

Setting performInsertReplace = REPLACE_2 replaces entries in the history database at the specified timestamps for one or more HistoricalDataNodes. If no entry exists at the specified timestamp, then the new entry shall not be inserted; otherwise the StatusCode shall indicate Bad_NoEntryExists.

This function is intended to replace existing entries at the specified timestamp, e.g., correct lab data that was improperly processed, but inserted into the history database.

6.8.2.4 Update data functionality ToC

Setting performInsertReplace = UPDATE_3 inserts or replaces entries in the history database for the specified timestamps for one or more HistoricalDataNodes. If the item has an entry at the specified timestamp, then the new entry will replace the old one. If there is no entry at that timestamp, then the function will insert the new data.

A Server can create a modified value for a value being replaced or inserted (see 3.1.6) however it is not required.

This function is intended to unconditionally insert/replace values and qualities, e.g., correction of values for bad sensors.

Good as a StatusCode for an individual entry is allowed when the Server is unable to say whether there was already a value at that timestamp. If the Server can determine whether the new entry replaces an entry that was already there, then it should use Good_EntryInserted or Good_EntryReplaced to return that information.

If the Time does not fall within range that can be stored then the related operationResults entry shall indicate Bad_OutOfRange.

Previous Next