Understanding Rule Violation Messages in the Queue
What are Rules?
Rules are the subsystem of AssetTrack that automatically checks collected data for problems and reports those problems to data collectors and asset managers. Rules can vary from form to form, or between the mobile, web and the Queue. Rules is configurable via the Management Console, so contact your AssetTrack administrator for information specific to your installation.
Rules are applied to a field on a given form. Some common rules rules available are:
- The field is not empty - There must be a value in this field or the rules message will be displayed.
- Pattern Match - The field must match the provided regular expression or the rules message will be displayed.
- Unique in Database - The field must have a value that is unique in the database.
- String length - The value in the field must be a certain length.
Rule Levels
When you attach a rule to a field on a form, you must also specify whether the rule should be applied as an Error, Warning or Message. This setting determines what the user sees when collecting data or when editing the data in the Console.
| Severity | Icon | Results |
| Error |  | This is a critical rule. Records cannot be collected nor published if this rule is violated. You must fix the offending value before saving or publishing this record. |
| Warning |  | This value may cause problems at publishing or reporting, but you may save or attempt to publish the record anyway. |
| Message |  | This is an informational message only to call out certain things about the value you collected. It does not mean there is a problem with the data, but you may want to take a look. |
Viewing Rule Messages in the Queue
When data is loaded from the Queue into a workspace in the console, the data is automatically checked against rules configured for that particular form. Any cell that contains a value that violates a rules will be tagged with the appropriate icon, as shown below.
There are two ways to see the rule message for a given row:
- Hover your mouse over the icon to see the rule message in a tooltip
- Select the entire row and see all messages associated with that given row in the messages list at the bottom of the screen.
Fixing Rules Errors
To clear a rules error, simply check out the row and edit the values until the rule is no longer violated. Checking of rules happens in the background as you make changes, so it may take a second for your grid to update once you have fixed a problem. For example, if you have a rule that states that the PO Number field cannot be empty, simply check out the row and add a PO Number. The message will go away.