You specify an advanced search pattern to perform a complex
search on the instances that are stored in the Rational Team Concert™ server.
You can use one of the available search patterns or create your own
pattern. These patterns are either formatted patterns or free form
patterns.
Before you begin
You must decide what kind of search you want to carry out.
If
you need a pattern only once, you must use an existing pattern or
write your own free form pattern directly in the Advanced
Search tab.
However, to perform the same search
several times, create your pattern and enter its content in the search
pattern editor, or use an imported pattern.
About this task
To be able to work with an advanced search pattern, the Rational Team Concert server
must be started and a repository connection must exist.
Click the
toolbar button or the Search menu
and select Server Advanced Design Search. The
following steps depend on the type of search you want to perform.
Procedure
- If you want to carry out searches without saving them for
future uses or for other developers, you can use one of the existing
patterns, or write your own search pattern from scratch. You do it
directly in the Advanced Search tab.
- If you want to base your search pattern on an existing pattern,
you must choose between the following patterns:
- Formatted pattern. Its criteria must be selected among the proposed
criteria and are always linked with an AND operator.
- Select a formatted pattern in the Search Patterns drop-down
list. Its search criteria are then displayed in the Index column
of the Formatted Pattern table, displayed as pdp:xxxx (where xxxx is
the search criterion such as the type or name).
- Enter the value of each search criterion in the Value column.
If the search criterion has a limited list of values (entity type
for example), click the Value column and click
the arrow that is displayed then. Select a value in the list that
displays all the possible values.
- You can combine search criteria. These criteria are linked with
an AND operator. To add a criterion, click
.
A new line, initialized with the pdp:type search
criterion, is then automatically inserted in the table. To change
this search criterion, click inside the column. Click the arrow that
is displayed then and select a new criterion in the list. You can
use
to remove a search criterion from the pattern. Note: The
non-edit box associated with the table displays the translation of
the formatted pattern into the SPARQL query language, used for the
free form patterns.
- When you have specified all the search criteria and their corresponding
values, click Search.
- Free form pattern. You can define its criteria and select the
operators that link them.
- Select a free form pattern in the Search patterns drop-down
list. Its translation into the SPARQL language is then displayed in
the Free Form Pattern edit field.
Tip: Tutorials
on how to code SPARQL queries are available on the internet.
- You can modify the SPARQL expression directly in this field to
adapt the pattern to your needs, or add new search criteria. You can use regular expressions and operators to
filter the search.
- Click Search.
- If you want to write your own search pattern from scratch,
without the help of an existing pattern, you must perform the following
actions:
- Click the Formatted Pattern radio button
and select the search criteria. You can also click the Free
Form Pattern radio button and enter the search criteria
in the SPARQL language, directly in the Free Form Pattern edit
field.
- Click Search.
- If you want to perform the same search more than once or
make it available for other developers, you must create your own search
pattern in the search pattern editor. You can perform the following
actions:
- Create a pattern and edit its content.
- You create a pattern by either:
- Clicking New associated with the Search
patterns drop-down list. In the wizard that opens up,
give a name to your pattern and select the pattern whose content initializes
your new pattern. Select Open the edit dialog box now and
click OK to access the search pattern editor.
- Or selecting a pattern in the Search patterns list
and click Edit. In the search pattern editor
that opens up, overwrite the pattern name with a new name.
- Specify its content in the search pattern editor.
- Click OK.
The new pattern is now displayed among the other patterns in
the Search patterns list.
- Import a search pattern, in the form of an XML file.
To do so, click Import associated with the Search
patterns list.
- Export one of your search patterns to make it available for
other developers. To do so, open the search pattern editor and click Export.
Results
The instances that are stored on the Rational Team Concert server,
in the selected stream (if any), are searched for. The instances that
match the search criteria are found, even if they have not been downloaded
to your workspace.
Once the search is complete, your focus automatically
switches to the Server Design Search view,
where the results of the search are displayed.