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"