Server Advanced Design Search tab
You can perform complex searches on the instances that are stored in the Rational Team Concert™ server. To do so, you can use one of the available search patterns or write your own search pattern.
- Search patterns
- This list displays all the available search patterns. These patterns can be built-in patterns,
or patterns that are written and adapted by users. There are two types of search patterns:
- Formatted patterns that offer the following search criteria:
- Entity type (Program or Screen for example)
- Keyword
- Location or project
- Data Element Type (string-type Data Elements for example)
- Data Element length
The content of the selected search pattern is displayed in the Formatted Pattern table and in the non-edit field that is associated with the table. The search is translated into its expression in the SPARQL query language in this field.
- Free Form patterns.
The content of these patterns is entirely free and must be entered in the SPARQL query language. You can use regular expressions and operators to filter the search.
Some built-in free form patterns can be used to filter instances (use of the FILTER operator) according to the beginning of their name, a character string in their name, their type, or their length. You can combine several search criteria with a UNION (OR) operator.
The selected free form pattern initializes the content of the search pattern in the Free Form Pattern edit field, in the form of a SPARQL expression. You can modify or complement it as you like in this field.Tip: Tutorials on how to code SPARQL queries are available on the Internet.
If none of the available patterns meet your needs, you can specify the content of the search pattern. You can do it in the Formatted Pattern table or the Free Form Pattern edit field of this tab if you do not want to make the search available for future uses. If you want to create and save the search pattern, you specify the content in the search pattern editor.
The following buttons are associated with the Search patterns list:- Edit to create a search pattern that will be available for future searches or to modify the content of an existing pattern.
- Remove to remove the selected pattern from the list of the available patterns.
- New to create a search pattern that will be available for future searches. This choice opens a wizard in which you give a name to your pattern and select the pattern whose content initializes your new pattern. Then, you access the search pattern editor.
- Import to import a search pattern made available as an XML file.
- Formatted patterns that offer the following search criteria:
- Formatted Pattern
- This table is constituted of the following elements:
- The Index column that displays the search criteria of the formatted pattern. It displays each search criterion as pdp:xxx (where xxxx is the search criterion such as type or name).
- The Value column that displays the value of each search criterion. It displays nothing if no value has been given to it yet. If the search criterion has a limited list of values (entity type for example), you can see the possible values by clicking the column and the arrow that is displayed then.
- A non-edit box that displays the search in the SPARQL query language, used for the free form patterns.
The following buttons are associated with this table:to add a search criterion to the pattern. The new search criterion is initialized with pdp:type in the Index column and no value in the Value column. Click inside the Index column and on the arrow that is displayed then. Select a new criterion in the list and give it a value.
to remove a search criterion from the pattern. You must select a search criterion in the table before you click Remove.
to move up the selected criterion in the pattern, provided there is at least one previous line.
to move down the selected criterion in the pattern, provided there is at least one following line.
- Free Form Pattern
- This edit field automatically displays the SPARQL expression that corresponds to the search
criteria of the free form pattern selected in the Search patterns list. You
are free to modify this SPARQL expression to adapt the search to your needs.
However, if your search pattern is not to be based on an existing free form pattern, this field is blank. You can then write your own pattern here in the SPARQL query language.
- Server scope
- You can select a stream to limit the search scope.
A stream is the equivalent of a work session. It is a repository object that is created in the Rational Team Concert server to integrate the work that is done in workspaces.