Skip to main content
Version: 8.1


This function is used in Python Scripting.


Returns the data quality for the property of the given component as an integer. This function can be used to check the quality of a Tag binding on a component in the middle of the script so that alternative actions can be taken in the event of device disconnections.

A description of the quality codes can be found on the Quality Codes and Overlays page.

Client Permission Restrictions

This scripting function has no Client Permission restrictions.


system.gui.getQuality(component, propertyName)


JComponentcomponentThe component whose property is being checked.
StringpropertyNameThe name of the property as a string value.


Integer - The data quality of the given property as an integer.


Vision Client

Code Examples

Example #1
# The following code checks the quality code on an component. If a quality is anything other than good, a message appears.

# Fetch the quality code from the Value property on a Numeric Label. The Numeric Label in this example is inside the same container as this script.
qualityCode = system.gui.getQuality(event.source.parent.getComponent('Numeric Label'), "value")

# Evaluate the quality code. If a value other than 192 is returned:
if str(qualityCode) == "Good":
# The quality code is good, so continue working. This example simply shows a message, but could be modified to do something more meaningful
system.gui.messageBox("The property is showing good quality")
# ...then show a message informing the user. Using Python's string formatting (%i) to pass the quality code into the message.
system.gui.messageBox("Operation Aborted \n The associated tag is showing quality code %s \n Please check the device connection" % qualityCode)


system gui getQuality, gui.getQuality