system.tag.readAll

This function is used in Python Scripting.

Description

Reads the values of each tag in the tag path list. Returns a sequence of qualified value objects. You can read the value, quality, and timestamp from each object in the return sequence. Reading in bulk like this is more efficient than calling read() many times.

Client Permission Restrictions

This scripting function has no Client Permission restrictions.

Syntax

system.tag.readAll(tagPaths)

• Parameters
  • String[] tagPaths - A sequence of tag paths to read from.
• Returns
  • QualifiedValue[] - A sequence of qualified values corresponding to each tag path given. Each qualified value will have three sub-members: value, quality, and timestamp.
• Scope
  • All

Code Examples

Example #1

# This example would read 5 tags at once and print each of their values
  
tags = ["Tags/T1", "Tags/T2", "Tags/T3", "Tags/T4", "Tags/T5"]
values = system.tag.readAll(tags)
for x in range(len(tags)):
   print "%s = %s" % (tags[x], values[x])