Skip to main content
Version: 7.9

system.opc.writeValue

This function is used in Python Scripting.

Description​

Writes a value directly through an OPC server connection synchronously. Will return an OPC-UA status code object. You can quickly check if the write succeeded by calling isGood() on the return value from this function.

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.opc.writeValue(opcServer, itemPath, value)

Parameters​

TypeParameterDescription
StringopcServerThe name of the OPC server connection in which the item resides.
StringitemPathThe item path, or address, to write to.
ObjectvalueThe value to write to the OPC item.

Returns​

Quality - The status of the write. Use returnValue.isGood() to check if the write succeeded.

Scope​

All

Code Examples​

Code Snippet
server = "Ignition OPC-UA Server"
path = "[SLCSim]_Meta:N7/N7:0"
oldQualifiedValue = system.opc.readValue(server, path)
newValue = oldQualifiedValue.getValue() + 1
returnQuality = system.opc.writeValue(server, path, newValue)
if returnQuality.isGood():
print "Write was successful"
else:
print "Write failed"