The behavior of Edit on Keystroke for each cell type is described.
Checkbox – A single mouse click on the checkbox will select the row, activate the cell and change the checkbox.
Textbox – A single mouse click will select the row and activate the cell. A keystroke or another mouse click will begin edit mode. Note that a cell value can be effectively changed with two actions, a mouse click and a keystroke. This is the same number of actions as “ edit on entry”.
ComboBox – A single mouse click will select the row and activate the cell.
o Another mouse click displays the drop down arrow, and clicking the arrow shows the drop down box.
o A keystroke begins the autocomplete feature of the Combobox and displays the drop down arrow. This is the most efficient way to deal with a ComboBox.
CheckBoxDropDown– A single mouse click will select the row and activate the cell.
Another mouse click displays the drop down arrow, and clicking the arrow shows the drop down box. There is no keyboard interface/auto complete available for this cell type.
Tasks
The Tasks List view, applicable only in Task Mode, allows the user to select and perform Tasks. Please refer to the section on Task Mode operation.
Message Query Builder and Message Query
This view provides the ability to define and apply a search query against a set of
communication messages. To fully utilize the capabilities of this feature, it is important to understand the relationship between the Queries and Communication Messages.
Page 53
A group of Communication Messages is the set of data against which a query is applied and is always the result of communication or attempted communication between two or more devices. The query is typically used to locate one or more messages within a larger set of messages that meet specific criteria. From the test set perspective, Communication Messages result from Master Mode operation, Monitor Mode operation, or RTU
Simulation Mode operation. During a communication session (Master Mode, RTU Simulation, or Monitor Mode), communication messages are always stored in the Current Message Buffer. This is an internal temporary storage area within the test set specifically intended to store communication message data and is used for several test set functions. For example, When the Line Monitor or Messages views are active, they will display data currently in the Current Message Buffer. Also, when a Query is executed, it is always executed against the contents of the Current Message Buffer. In addition to communication messages being stored in the Current Message Buffer as the result of a communication session, communication messages will also be stored there as the result of importing (File > Import> Communication Messages) from a previous exported (File >
Export > Communication Messages) set of messages (.msgx file) or as a result of selecting a previously created capture file using the View Capture selection mechanism.
The Message Query view has 6 areas for display and entry of query related information.
See screenshot below. The 6 sections are:
1. Query Tab and Query Toolbar – Contains a tab with the query name for each currently defined query and a toolbar containing an icon for:
Execute current message query
Define a new query
Rename query
2. Query Definition Pane – Used to display the 4 pages of query definition menus.
Navigation from pager to page is done using Back and Next buttons in the Navigation Pane.
3. Property Description Pane – Contains a brief description of the currently selected property in the Query Definition Pane.
4. Navigation Pane – Contain buttons for navigating between the query definition menu pages and a button to Build a query using the information contained in the query definition pages.
5. Current Query Syntax Pane - Current query definition in XML XPath syntax 6. Query Results Pane – Contains the results of the latest query execution. The query
results will be displayed in this pane using the Messages View format.
Page 54
Query parameters are entered from one of several data entry menus. The << Back and Next >> targets advance through the various menus. Once all parameters have been specified, the Build Query is selected to build the query. The XML XPath syntax is shown in the bottom portion of this menu and can be edited, if desired.
Query Definition Pane
Property Description Pane Navigation Pane
Current query definition (XML XPath syntax)
Results of last query run (communication messages) Query Name tab and Query Toolbar
Page 55
Pressing the ICON executes the Query against the current collection of
communication messages. To run the query against a capture file, that file must be opened in the ASE2000 before the query is run.
Message Query Definition
The query is defined using a set of query definition items consisting of check boxes, properties, and values. The query definition items are presented on four different pages within the Message Query view. These are:
1. Message Properties 2. Data Element Properties 3. Object ID Properties 4. Component Values
There are navigation buttons on each page labeled [<< Back and Next>>] for going from page to page. The query definition process consists of specifying a set of rules and conditions intended to identify a subset of the total messages. Each of the query
definition pages is formatted in two columns; the first column contains a property or item name and the second column contains a value or state to be associated with the
corresponding property/item in the first column. Examine each property or item to determine if that property or item should be used in defining the query criteria. If yes, check the associated box and set the associated value or state to the appropriate value. In some cases the state value is selected from a drop-down menu which is selectable when the state/value field is selected. If a property or item is not relevant for the query
definition, do no check the associated box and it will not be used. When all the relevant query definition items have been selected and appropriate values/states entered, select the Build Query button. This will generate a new query and the result of the new query definition in XPath syntax will be displayed in the Current Query Definition pane. The query can then be executed against the contents of the Current Message Buffer by selecting the Execute Query icon and the results will be displayed in Message View format in the Results of Last Query Run pane.
Message Query Builder Example
This section contains an example of building and executing a simple query. The query will be defined to locate:
1. Messages sent from the Slave to Master device and 2. Containing Analog values between 1200 and 1500 and 3. Point ID = 3 and
4. RTU ID = 5
The query definition screens are configured as follows:
Page 56
Next, select the Build Query button and the query definition XPath syntax will be generated as shown below.
Page 57
Finally, execute the query by selecting the Execute Query icon from the main test set toolbar or from the Message Queries view toolbar and the messages from the Current Message Buffer that meet the query criteria will be displayed in the Query Results pane as shown below.
Query in XPath syntax
Page 58
Page 59