PrF UG queries create query - Revision history

RichMorin at 01:40, November 14, 2008

2008-11-14T01:40:19Z

RichMorin at 22:33, October 29, 2008

2008-10-29T22:33:12Z

RichMorin at 19:42, October 29, 2008

2008-10-29T19:42:21Z

RichMorin at 20:23, October 25, 2008

2008-10-25T20:23:00Z

RichMorin at 20:18, October 25, 2008

2008-10-25T20:18:36Z

RichMorin at 21:59, October 16, 2008

2008-10-16T21:59:45Z

RichMorin at 21:59, October 16, 2008

2008-10-16T21:59:00Z

RichMorin at 21:58, October 16, 2008

2008-10-16T21:58:40Z

Show changes

RichMorin: Automated import of articles

2008-10-09T09:08:57Z

Automated import of articles

New page

__NOTOC__
== Creating a Single Query ==

{{PrF_UG_TOC_queries}}<div id='prf_ug'>

The Queries Tab allows you to query your project and locate all instances that match the criteria you specify.
You can create a simple query,
or combine multiple criteria to restrict or expand your results.

You can create a simple query based on a class,
a slot,
or both.
When you specify a slot,
you also specify the criteria for matching the slot:

<ul class='a'>
<li><p>
A query based solely on a class will find all instances of the selected class <i>and</i> all of its subclasses.
</p>

<li><p>
A query based solely on a slot will find all instances whose value at the slot match the criteria you specify.
</p>

<li><p>
A query based on a class and a slot will find all instances of the class that match the criteria at the selected slot.
</p>
</ul>

<b>Note:</b> Sometimes the query buttons or query entry bar will not display correctly.
You can refresh the query entry by clicking on another tab and then returning to the Query Tab.

The directions below show how to select a class first,
then a slot.
You can also select the slot first and then the class;
this is useful if you remember the slot name,
but are not certain of the classes that it is attached to.
To do this,
select the slot as in Steps 3 and 4,
then select the class as in Steps 1 and 2.
In this case,
the <b>Select Classes</b> dialog box will show only those classes that have the selected slot.

To create a query:

<ol class='a'>
<li><p>
To specify a class,
click the <b>Select Class</b>
[[Image:PrF_UG_all_object.add.gif|all_object.add]]
button above the Class entry bar. (If you wish to create a query based solely on a slot,
start at Step 3.)

</p><p> <div>[[Image:PrF_UG_queries_query_class_entry.png|queries_query_class_entry]]</div>
</p>

<li><p>
Select the class you want from the <b>Select Classes</b> dialog box,
then click <b>OK</b>. (If you wish to create a query solely on that class,
you are now ready to
[[PrF_UG_queries_run_query|run]]
it.)

</p><p> <div>[[Image:PrF_UG_queries_query_select_class.png|queries_query_select_class]]</div>
</p>

<li><p>
Click <b>OK</b>.

</p><p> <div>[[Image:PrF_UG_queries_query_class_filled.png|queries_query_class_filled]]</div>
</p>

<li><p>
To specify a slot,
click the <b>Select Slot</b>
[[Image:PrF_UG_all_object.add.gif|all_object.add]]
button,
above the Slot entry bar.

</p><p> <div>[[Image:PrF_UG_queries_query_slot_entry.png|queries_query_slot_entry]]</div>
</p>

<li><p>
Select a slot from the <b>Select Slot</b> dialog box.
If you selected a class,
only slots attached to that class will be shown.
If no class is selected,
all slots are available.

</p><p> <div>[[Image:PrF_UG_queries_query_select_slot.png|queries_query_select_slot]]</div>
</p>

<li><p>
Click <b>OK</b>.
The slot will be filled in and the criteria menu immediately to the right will be displayed.

</p><p> <div>[[Image:PrF_UG_queries_query_slot_filled.png|queries_query_slot_filled]]</div>
</p>

<li><p>
Make a selection from the pull-down criteria menu.
This menu becomes active after you select a slot;
the choices are based on the slot's Value Type.

</p><p> <div>[[Image:PrF_UG_queries_query_menu_contains.png|queries_query_menu_contains]]</div>
</p>

<li><p>
Enter a value for comparison at the entry bar to the right.
The entry method for this value depends on the slot value type.
</p>

<ul>
<li><p>
For
[[PrF_UG_slots_value_type_boolean|Boolean]]
value type,
select whether the slot value is true or false.
</p>

<li><p>
For
[[PrF_UG_slots_value_type_class|Class]]
value type,
click the <b>Select Class</b>
[[Image:PrF_UG_all_object.add.gif|all_object.add]]
button and select a class from the dialog.
The query will find all instances where the slot value contains (or does not contain) the selected class.
</p>

<li><p>
For
[[PrF_UG_slots_value_type_float|Float]]
or
[[PrF_UG_slots_value_type_integer|Integer]]
value type,
enter the number to which you want to compare the slot value.
</p>

<li><p>
For
[[PrF_UG_slots_value_type_instance|Instance]]
value type,
click the <b>Select Instance</b>
[[Image:PrF_UG_all_object.add.gif|all_object.add]]
or <b>Select Query</b>
[[Image:PrF_UG_queries_query.gif|queries_query]]
button and select a value from the dialog box.
</p>

<li><p>
For
[[PrF_UG_slots_value_type_symbol|Symbol]]
value type,
the possible values are displayed as a drop-down list.
Select a symbol from this list.<b>Note:</b> Sometimes the query buttons or query entry bar will not display correctly.
You can refresh the query entry by clicking on another tab and then returning to the Query Tab.
</p>
</ul>
</ol>

To
[[PrF_UG_queries_run_query|run]]
the query,
click <b>Find</b>
[[Image:PrF_UG_queries_query_find.png|queries_query_find]].

To
[[PrF_UG_queries_saving_query|save]]
the query in the Query Library,
give it a name and click the <b>Add Query to Library</b>
<div>[[Image:PrF_UG_queries_query.library.add.gif|queries_query.library.add]]</div>
button.

</div>

@@ Line 2: / Line 2: @@
 == Creating a Single Query ==
-{{PrF_UG_TOC_queries}}<div id='prf_ug'>
+<noinclude>{{PrF_UG_TOC_queries}}<div id='prf_ug'></noinclude>
 The Queries tab allows you to query your project and locate all instances
@@ Line 164: / Line 164: @@
-</div>
+<noinclude></div></noinclude>

@@ Line 33: / Line 33: @@
 Sometimes the query buttons or query entry bar will not display correctly.
 You can refresh the query entry by clicking on another tab
-and then returning to the Query Tab.
+and then returning to the Query tab.
 The directions below show how to select a class first, then a slot.

@@ Line 78: / Line 78: @@
      </p>
      <div>[[Image:PrF_UG_queries_query_slot_entry.png|frame|none|
-            Slot entry bar]]</div>
+            Slot entry bar, empty]]</div>
    <li><p>
@@ Line 86: / Line 86: @@
      If no class is selected, all slots are available.
      </p>
-     <div>[[Image:PrF_UG_queries_query_select_slot.png|
+     <div>[[Image:PrF_UG_queries_query_select_slot.png|frame|none|
-            queries_query_select_slot]]</div>
+            Select Slot dialog, "date_hired" selected]]</div>
    <li><p>
@@ Line 94: / Line 94: @@
      and the criteria menu immediately to the right will be displayed.
      </p>
-     <div>[[Image:PrF_UG_queries_query_slot_filled.png|
+     <div>[[Image:PrF_UG_queries_query_slot_filled.png|frame|none|
-            queries_query_slot_filled]]</div>
+            Slot entry bar, filled]]</div>
    <li><p>
@@ Line 102: / Line 102: @@
      the choices are based on the slot's Value Type.
      </p>
-     <div>[[Image:PrF_UG_queries_query_menu_contains.png|
+     <div>[[Image:PrF_UG_queries_query_menu_contains.png|frame|none|
-            queries_query_menu_contains]]</div>
+            pull-down criteria menu]]</div>
    <li><p>
@@ Line 119: / Line 119: @@
        For [[PrF_UG_slots_value_type_class|Class]] value type,
        click the <b>Select Class</b>
-       [[Image:PrF_UG_all_object.add.gif|all_object.add]] button
+       ([[Image:PrF_UG_all_object.add.gif|all_object.add]]) button
        and select a class from the dialog.
        The query will find all instances where the slot value
@@ Line 134: / Line 134: @@
        For [[PrF_UG_slots_value_type_instance|Instance]] value type,
        click the <b>Select Instance</b>
-       [[Image:PrF_UG_all_object.add.gif|all_object.add]]
+       ([[Image:PrF_UG_all_object.add.gif|all_object.add]])
        or <b>Select Query</b>
-       [[Image:PrF_UG_queries_query.gif|queries_query]] button
+       ([[Image:PrF_UG_queries_query.gif|queries_query]]) button
        and select a value from the dialog box.
        </p>
@@ Line 156: / Line 156: @@
 To [[PrF_UG_queries_run_query|run]] the query, click the <b>Find</b> button:
-[[Image:PrF_UG_queries_query_find.png|queries_query_find]]
+<div>[[Image:PrF_UG_queries_query_find.png|frame|none|
 To [[PrF_UG_queries_saving_query|save]] the query in the Query Library,
 give it a name and click the <b>Add Query to Library</b>
-[[Image:PrF_UG_queries_query.library.add.gif|queries_query.library.add]] button.
+([[Image:PrF_UG_queries_query.library.add.gif|queries_query.library.add]]) button.
 </div>

@@ Line 50: / Line 50: @@
      To specify a class,
      click the <b>Select Class</b>
-     [[Image:PrF_UG_all_object.add.gif|all_object.add]] button
+     ([[Image:PrF_UG_all_object.add.gif|all_object.add]]) button
      above the Class entry bar.
      (If you wish to create a query based solely on a slot, start at Step 3.)
      </p>
-     <div>[[Image:PrF_UG_queries_query_class_entry.png|
+     <div>[[Image:PrF_UG_queries_query_class_entry.png|frame|none|
-            queries_query_class_entry]]</div>
+            Class entry bar]]</div>
    <li><p>
@@ Line 63: / Line 63: @@
      you are now ready to [[PrF_UG_queries_run_query|run]] it.)
      </p>
-     <div>[[Image:PrF_UG_queries_query_select_class.png|
+     <div>[[Image:PrF_UG_queries_query_select_class.png|frame|none|
-            queries_query_select_class]]</div>
+            Select Classes dialog, "Employee" selected]]</div>
    <li><p>
      Click <b>OK</b>.
      </p>
-     <div>[[Image:PrF_UG_queries_query_class_filled.png|
+     <div>[[Image:PrF_UG_queries_query_class_filled.png|frame|none|
-            queries_query_class_filled]]</div>
+            Class entry bar]]</div>
    <li><p>
      To specify a slot, click the <b>Select Slot</b>
-     [[Image:PrF_UG_all_object.add.gif|all_object.add]] button,
+     ([[Image:PrF_UG_all_object.add.gif|all_object.add]]) button,
      above the Slot entry bar.
      </p>
-     <div>[[Image:PrF_UG_queries_query_slot_entry.png|
+     <div>[[Image:PrF_UG_queries_query_slot_entry.png|frame|none|
-            queries_query_slot_entry]]</div>
+            Slot entry bar]]</div>
    <li><p>

@@ Line 154: / Line 154: @@
 </ol>
-To [[PrF_UG_queries_run_query|run]] the query, click <b>Find</b>
+To [[PrF_UG_queries_run_query|run]] the query, click the <b>Find</b> button:
-[[Image:PrF_UG_queries_query_find.png|queries_query_find]].
 To [[PrF_UG_queries_saving_query|save]] the query in the Query Library,