Skip to main content
Version: 8.1

system.opc.writeValues

This function is used in Python Scripting.

Description

This function is a bulk version of system.opc.writeValue. It takes a list of addresses and a list of objects, which must be the same length. It will write the corresponding object to the corresponding address in bulk. It will return a list of status codes representing the individual write success or failure for each corresponding address.

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.writeValues(opcServer, itemPaths, values)

Parameters

TypeParameterDescription
StringopcServerThe name of the OPC server connection in which the items reside.
List[String]itemPathsA list of item paths, or addresses, to write to.
List[Any]valuesA list of values to write to each address specified.

Returns

List[Quality] - An array of Quality objects, each entry corresponding in order to the addresses specified. Refer to the list of writeValues objects.

Scope

Gateway, Vision Client, Perspective Session

Code Examples

Code Snippet
# This example will write values to specified OPC items
# Declare a list of values
objectValue = [3]

# Declare the item path to write values back to
itemPath = "ns=1;s=[GoldSim]B3/B3:100"

# Write the values to the specified item. Replace "Ignition OPC UA Server" with your chosen OPC UA server.
system.opc.writeValues("Ignition OPC UA Server", itemPath, objectValue)

Keywords

system opc writeValues, opc.writeValues