PrF UG queries query editor

From Protege Wiki
Revision as of 15:26, October 14, 2008 by RichMorin (talk | contribs)

Jump to: navigation, search

The Query Editor


Protege-Frames User's Guide
Queries
The Queries Tab
The Query Editor
The Search Results Pane
The Query Library Pane
Creating a Single Query
Combining Multiple Queries
Chaining Multiple Queries
Running a Query
Saving a Query
Retrieving a Query
Clearing a Query
Exporting Query Results
Glossary, Editing Help

The Query Editor allows you to enter, modify, or save your queries. The Query Editor has the following components:

  1. One or more query bars, where you can construct a query by selecting a class, slot, criterion, and value.

  2. The Combined Query buttons, which allow you to add and remove additional query bars, and to specify how they are combined.

  3. The Find button, which allows you to run your query.

Query Bar(s)

Each query bar has:

  1. A Class entry field, which allows you to specify a class by clicking the Select Class classes_class.add button. If a class is already shown, using the Select Class classes_class.add button replaces it. You can also view the selected class by clicking the View Class classes_class.view button, or remove it by clicking the Remove Class classes_class.remove button.

  2. A Slot entry field, which allows you to specify a slot by clicking the Select Slot slots_slot.add button. If a slot is already shown, using the Select Slot slots_slot.add button replaces it. You can also view the selected slot by clicking the View Slot slots_slot.view_top_level button, or remove it by clicking the Remove Slot slots_slot.remove button.

  3. A criteria menu, which allows you to set the criteria for the query, based on the slot.

  4. A value entry bar or menu, which allows you to set the value for comparison. The entry type is based on the slot value type.

Choices for the criteria menu and value are as follows:

Slot Type Criteria Menu Action

Boolean

queries_query_menu_boolean

Verifies whether or not the Boolean value is true or false,

as selected from the menu at the right.

Class

queries_query_menu_class

The selected criterion is compared to a class selected at the right. To select a class, click the Select Class

all_object.add

button and make a selection from the dialog. To remove a class, click the Remove Class all_object.remove button. Only one class can be selected.

Float

queries_query_menu_float

The selected criterion is compared to the value typed in the Float entry bar at the right.

Instance

queries_query_menu_class

The selected criterion is compared to an instance or query selected at the right.

  • To select an instance, click the Select Instance all_object.add button and make a selection from the dialog.

  • To select a query, click the Select Query queries_query button and make a selection from the dialog.

  • To remove an instance or query, click the Remove Instance all_object.remove button.Only one instance or query can be selected.

Integer

queries_query_menu_float

The selected criterion is compared to the value typed in the Integer entry bar at the right.

String

queries_query_menu_string

The selected criterion is compared to all or part of a string typed in the entry bar to the right.

For example, selecting begins with and typing M in the String entry bar will find all instances of the selected class/slot combination that begin with M.

Symbol

queries_query_menu_symbol

The Symbol entry bar to the right becomes a drop-down menu that displays all possible values for the slot.

The selected criterion is compared to the value.

Combined Query Buttons

More Click this button to create an additional query bar,

which can then be set with class, slot, and criterion.

Fewer If there are two or more query bars,

click this button to remove the bottom-most query bar.

Clear Click this button to clear all query bars and reduce the Query Editor to a single,

blank query bar.

Match All For two or more query bars,

click this button to specify that any instance found must match all of the criteria (the intersection or AND) specified in the query bars.

Match Any For two or more query bars,

click this button to specify that any instance found must match at least one of the criteria (the union or OR) specified in the query bars.