Query wizard
Use this wizard to create a set of query results.
- Click .
- Click in the navigation tree, if you have this displayed.
Preparing to run a query
When you invoke the query wizard, you are offered a choice of entity types to query. Select a type from the list, and click OK.
If you select "All Entities", you can search only on the attributes of the BaseObject class and not attributes that are defined on a subclass. This restriction can be overcome by searching for objects of a specific type instead.
Entering the details for your query
The details you can specify are dependent on the type of query you selected. The Query Wizard is not case sensitive.
For all queries, you can specify the following options:
| Option | Description |
|---|---|
| AND or OR condition | Select AND to generate query results that satisfy all the supplied conditions. This setting is the default. Select OR to generate query results that satisfy any of the supplied conditions. |
| Classifications | Specify the list of classifications to be searched. Click Choose to open the classification browser page. To specify that the classifications to be searched include the child classifications of the listed classifications, select the Match children check box. |
For Entities by Classification queries you can, additionally, specify the following search fields:
| Option | Description |
|---|---|
| Name | Specify the name of the object to be searched. |
| Namespace | Specify the namespace of the object to be searched. |
| Version | Specify the version of the object to be searched. |
For Entities with Custom Relationships queries you can, additionally, specify the following search fields:
| Option | Description |
|---|---|
| Relationship name | Specify the name of a relationship to be searched. |
| Target entity name | Specify the name of a target entity to be searched. |
For all other queries, you can, additionally, specify the following search fields:
| Option | Description |
|---|---|
| Name | Specify the name of the object to be searched. |
| Namespace | Specify the namespace of the object to be searched. |
| Version | Specify the version of the object to be searched. |
| Property name | Specify the name of a property to be searched. |
| Property value | Specify the value of a property to be searched. |
| Text search | Specify the terms to use to perform a text search as part of the query. If text search is not enabled, this field does not appear in the Query Wizard. |
Searching for business model objects
If you are searching for objects that are defined in a business model, and your query details include a property name or a relationship name, you must prefix the name with the value of the <wsrr_prefix> element in the business model OWL file.
For example, if you want to include the "department" property in your query details, and the value of the <wsrr_prefix> element is "MyModel", enter "MyModel_department" in the property name field.
If the business model was created by using WSRR Studio, the value of the <wsrr_prefix> element is the value that was entered in the Prefix field when the business model was created.
Using wildcards
You can use wildcards in some of the search fields of the query wizard. The following table describes where you can and cannot use wildcards:
| Field | Wildcard allowed? |
|---|---|
| Name | Yes |
| Namespace | Yes |
| Version | Yes |
| Property name | No |
| Property value | No |
| Relationship name | No |
| Target entity name | No |
| Text search | Yes |
Reviewing your query
After specifying the details for your query, click Next. The Summary page opens.
You can check the details of your query on the Summary page. If you want to change any of the details for the query, click Previous to return to the Enter details page. If you are happy with your query, click Finish. The results of the query are shown on the Query results page; the Query results page provides you with an option to save the query for future reuse.