This function is used in Python Scripting.


Inserts values on the OPC-HDA server, or replaces 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.


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

  • Parameters

String serverName - The name of the defined OPC-HDA server.

String itemId - The item ID on which to perform the operation.

Any value - The value to insert or replace.

Any date - The date to insert or replace.

Integer quality - The 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
Code Snippet
# This example will insert a new date for a specific entry on an OPC HDA server.
# Declare a date to insert
start =, 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()

system opchda insertReplace, opchda.insertReplace