Control Architect Help Documentation
×
Menu
Index

DataView Advanced Find Overview

DataView Advanced Find Overview
 
The Advanced Find view allows you to define expressions to query data items in the DataView.  You can define simple expressions using the predefined functions or you can specify complex RegEx expressions for advanced query needs.
 
1

Advanced Find ToolWindow tab

1. Advanced Find ToolWindow tab
Click this ToolWindow tab to open the view window.  Click the Pin button located in the top-right corner of this view to pin the view in a docked state.
2

Query Builder

2. Query Builder
The Query Builder is where you build query expressions by specifying a Property Name, Function, Value, and optionally an Operand.  Multiple expressions can be logically combined using the AND or OR operand.
 
The Property Name that you specify represents the Parameter name of the entity you wish to find.
 
Wildcard expression syntax is supported when defining the Property Name column value.  The following expression for the Property Name column...
"*PKGNAME*" indicates to find all entity parameter names that contain the text phrase "PKGNAME".  Notice how the '*' character precedes and ends this specified Parameter name.  The wildcard char '*' means to ignore any characters preceding the name "PKGNAME" and any characters ending after this Parameter name.  It will successfully match and find these examples using this syntax:
  • UC100.PKGNAME(1)
  • UC100.PKGNAME(2)
  • UC100.PKGNAME(3)
  • ...
3

DataView Scope Options

3. DataView Scope Options
Choose the scope option to execute the Query against in the Data View.
4

Run button

4. Run button
Click this button to execute the defined query expressions against the data located in the DataView.
5

Query Results Status

5. Query Results Status
When a query has been executed against the DataView, the items contained in the Data View represent data that satisfied the query expression.  A status LED indicator will show the results of the expression that was executed on a DataView list item.
 
 
6

Search Results Filter

6. Search Results Filter
The Search Filter value will be replaced with the text value "<Results>", which will automatically filter the DataView list for only items that are part of the last executed query result set.  Clicking the X button in the Search bar will reset the DataView to its unfiltered set of items.
7

Refresh button

7. Refresh button
Click this button to apply the last executed query results to the DataView.  This function simply enters the value "<Results>" in the DataView search filter bar.
8

Save button

8. Save button
Click this button to save the Query Builder expressions for later restore.
 
A popup view will become visible that allows you specify how to save the Query Builder expressions.
 
 
Specify a description that will uniquely identify the Query Builder expression(s) when saved.  Saved Query expressions are added to the "Save/Restore Query Builder" list.  Expressions in the saved list can be restored back to the Query Builder by left-mouse double-clicking on an item to restore.
 
You can also choose to overwrite an existing saved Query item by choosing the item from the drop-down list.
 
Click the Save button in this popup view to complete the save operation or click the X button to close the popup view.
9

Save/Restore Query Builder list

9. Save/Restore Query Builder list
When you save the query expressions contained in the Query Builder they will appear in this list of items for later restore.  Left-mouse double-click on an item in this list to restore its saved query expressions to the Query Builder.
 
You can delete selected item(s) in this list by pressing the keyboard Delete button.
10

Clear Query Builder Expressions

10. Clear Query Builder Expressions
Click this button to quickly remove all existing Query Builder expressions.