Tag Quality and Overlays

Tag Quality

Ignition has Quality built into Tags automatically. Data Quality is the measure of how reliable a particular Tag's data is. If a Tag's quality is not Good, the value generally should not be trusted, and an overlay is shown to make the Tag's bad quality visible. There are a wide variety of causes of bad data, from network disconnections, to software failure, to invalid Tag configurations.

Quality is extremely important and exists on every Tag. It is visible in the Designer and in the Runtime through an Overlay system. There are a few of ways to check Tag Quality.

  • In the Tag Browser, find your Tag, expand it, and scroll down to the meta property called Quality. Here, you can see if the quality of the Tag is either Good or Bad Quality. This example shows a Good Quality Tag, meaning the Tag can be trusted.

    images/download/attachments/7079020/Tag_Browser_Good_Quality_Tag.png

  • One obvious indicator if the Tag is of bad quality is if there is an overlay on the Tag itself. This example shows two Tags with overlays that have a quality issue. The HOA Tag was expanded to show that there is a Configuration Error and the HR1 Tag has an Unknown issue. Ignition typically tries to identify the Quality issue to help you resolve it promptly.

    images/download/attachments/7079020/Tag_Browser_Bad_Quality_Tag.png

  • Quality is also reflected on the component in the window of the Designer and Runtime using an overlay. Using an overlay on a component lets the operator know that they could be looking at a bad value for that Tag. When the overlay goes away and the values start coming in again, the operator knows that it's a valid Tag, and the values can be trusted. Bad Quality overlays on components look like the ones in this example which show a Tag's Evaluation Error.

    images/download/attachments/7079020/Bad_Quality_Overlay_for_Component.png

Primary Data Qualities

The following table outlines the primary data qualities. The most important is Good, and that has a value of 192. There are more values, but these represent the most common:

Quality
Value
Meaning

Good

192

The data has met all criteria for being considered reliable.

OPC_Bad_Data

0

The data is not reliable, further data isn't available.

OPC_Not_Connected

8

The OPC server driving the tag is not currently connected OR a value has not yet been received by the tag from the server.

Config_Error

300

There is a problem with the tag's configuration. The error log may provide more information as to the exact problem.

Comm_Error

301

There is a problem in communication somewhere between the tag and its data source.

Expression_Eval_Error

310

The expression in the tag generated an error during execution. The error log should provide more information on the error.

Tag_Exec_Error

330

There was an error when evaluating the tag.

Type_Conversion_Er
ror

340

The value of the tag could not be converted to the requested data type. Check the assigned data type of the tag.

Driver_Demo_Timeout

900

The system driving the tag is operating in demo mode and has timed out.

Access_Denied

403

The tag permission settings do not allow the current user to view the tag.

Not_Found

404

The tag, or a tag referenced from inside of it, could not be found (incorrect reference path).

Disabled

410

The tag's "enabled" property has been set to false.

Stale

500

The tag has not been evaluated within the expected time frame. There is likely a deeper problem with the tag provider.

GW_Comm_Off

901

When viewing Tags in the Designer, the tags will have this value if communication with the Gateway is turned off from the toolbar.

Tag Quality and Referenced Tags

When Tags reference other Tags, such as in expressions, they will often pass the worst sub-quality up as their own. For example, even though a particular Tag's expression executes without problem, if the expression references a Tag whose quality is "Bad", the expression Tag will also report "Bad."

Component Overlays

It is especially important in HMIs to be able to gauge the health and accuracy of what is displayed at a glance. In a highly distributed system like Ignition, it is especially important, as the client may be located at quite a distance (maybe across the world) from the physical process it is monitoring and controlling.

For these reasons, components display visual overlays (as shown below) for various reasons to indicate that the data they are displaying is not good, or pending a reply from the device. Each data binding that drives a component is evaluated for quality. If any of these qualities becomes poor, the component will show an overlay. The different overlays can mean different things, denoting their underlying cause. What they indicate is based on the Quality properties of Tags. The table below shows all the available overlays Ignition provides.


images/download/attachments/7079020/image2015-4-7_16_27_16.png

Overlay Opt-out

Choosing the Overlay Opt-out option will ignore the quality of the chosen Tag, making it have no effect on the component's quality overlay. The Overlay Op-out option is located in the Tag bindings for components. If this option is enabled, the operator will not see any overlays and will have no indication that the underlying Tag quality is something other than good. A word of caution when you use the Opt-out option because you always want to give the operator some indication that the values they are seeing on the screen can be trusted, and by opting out, you are removing that indicator for the operator.

images/download/attachments/7079020/Overlay_Opt-out.png

Similar Topics ...