Skip to main content
Version: 8.1


This function is used in Python Scripting.


This function is equivalent to the system.opc.readValue function, except that it can operate in bulk. You can specify a list of multiple addresses to read from, and you will receive a list of the same length, where each entry is the qualified value object for the corresponding address.

Client Permission Restrictions

This scripting function has no Client Permission restrictions.


system.opc.readValues(opcServer, itemPaths)


StringopcServerThe name of the OPC server connection in which the items reside.
List[String]itemPathsA list of strings, each representing an item path, or address to read from.


List[QualifiedValue] - A sequence of QualifedValue objects, one for each address specified, in order. Each object contains a value, quality, and timestamp returned from the OPC server for the corresponding address.


Gateway, Vision Client, Perspective Session

Code Examples

Code Snippet
# This example will read values from a Tag provider called "testSimTags".
# Declare list values for itemPaths parameter
itemPaths = ['[testSimTags]_Meta:Random/RandomInteger1', '[testSimTags]_Meta:Random/RandomInteger1']

# Call the system function
system.opc.readValues('Ignition OPC UA Server', itemPaths)


system opc readValues, opc.readValues