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, package, 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 for the following purposes:- Filter instances (use of the FILTER operator)
according to the following criteria:
- The beginning of their name
- A character string in their name
- Their type
- Their length
- Combine several search criteria with a UNION (OR) operator.
Tip: Tutorials on how to code SPARQL queries are available on the Internet. - Filter instances (use of the FILTER operator)
according to the following criteria:
If none of the available patterns meets your needs, you can specify the content of the search pattern:- Directly 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.
- Or in the search pattern editor if you want to create and save the search pattern.
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 already 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 is automatically completed with the search criterion or criteria of the formatted pattern. It displays each search criterion as pdp:xxx (where xxxx is the search criterion (type, name...).
- The Value column that displays the value given to each search criterion, or 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 clicking 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 can have the following status:
- Automatically completed with the SPARQL expression that corresponds to the search criterion or 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.
- Blank if your search pattern is not to be based on an existing free form pattern. 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.