Define Find Filter Relationships dialog
The Define Find Filter Relationships dialog is the second step in creating and editing find criteria, which enables you to use filters to find objects in a test object map. You use this dialog to define the relationship between the properties you added to the find filter.
The Define Find Filter Relationships dialog has the following controls:
- Filter
- Lists all the groups of filter properties you specified in the Define Find Filter Properties
dialog. If necessary, click <Back to make any additions or
edits to the list.Note: You can right-click a group folder to change it to AND or OR. To group objects, press Ctrl and click the objects you want to include, right-click, and select Group. To ungroup objects, right-click the group folder and select Ungroup. Right-clicking objects in the Filter field enables you to cut, copy, paste, or delete them.
- Relationship
- The controls in this section change based on whether you click a group or a property in the Filter box.
- AND
- When selected, changes the highlighted group to an AND; all the property relationships in the group must resolve to true in order for Test UI to find the object in the test object map.
- OR
- When selected, changes the highlighted group to an OR; at least one property relationship in the group must resolve to true in order for Test UI to find the object in the test object map.
- Operator
- Enables you to indicate whether the Value: Exists (the default), IsNull, or is Equal.
- NOT Relationship
- When selected, Test UI searches for objects that do not contain the specified relationship and value.
- Value
- For the specified property, enter a value you want Test UI to search for.
- Convert Value to Regular Expression
- Available when Operator is Equal, enables you to specify a regular expression in the Value field. For information, see Replacing an Exact-Match Property with a Pattern.
- Convert Value to Numeric Range
- Available when Operator is Equal, enables you to specify a numeric range in the Value field. For information, see Replacing an Exact-Match Property with a Pattern. Clicking the NR notation in the Value field displays fields that enable you to specify the numeric range parameters. This button is only enabled if the value is of a numeric type.
- Back
- Returns to the Define Find Filter Properties dialog.
- Next
- Advances to the Define Find Filter Name dialog.
- Finish
- Available when editing existing find criteria, saves any changes and closes the Define Find Filter Relationships dialog.
- Cancel
- Closes the Define Find Filter Relationships dialog without saving any changes you have made.
To open: When defining or editing find criteria, click Next in the Define Find Filter Properties dialog.