Skip to main content
Version: 8.1

system.opchda.insertReplace

This function is used in Python Scripting.

Description​

Will insert values on the OPC-HDA server, or replace them if they already exist.

Client Permission Restrictions​

Permission Type: OPC Server Management

Client access to this scripting function is blocked to users that do not meet the role/zone requirements for the above permission type. This function is unaffected when run in the Gateway scope.

Syntax​

system.opchda.insertReplace(serverName, itemId, value, date, quality)

Parameters​

TypeParameterDescription
StringserverNameThe name of the defined OPC-HDA server.
StringitemIdThe item ID to perform the operation on.
ObjectvalueThe value to insert or replace.
ObjectdateThe date to insert or replace.
QualityCodequalityThe quality to insert or replace.

Returns​

QualityCode - The result of the insert or replace operation. See Scripting Object Reference.

Scope​

Gateway, Vision Client, Perspective Session

Code Examples​

Example #1
# This example will insert a new date for a specific entry on an OPC HDA server.
# Declare a date to insert
start = system.date.getDate(2022, 10, 25)

# Call the system function
hda = system.opchda.insertReplace('Matrikon HDA','1',3,start,1)

# Print out various attributes
print hda.isError()
print hda.getCode()
print hda.isBad()
print hda.isGood()