Rational Programming Patterns for System z

RTC Server Advanced Design Search tab

In this tab, you can perform complex searches on the instances 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 written and adapted by users. There are two types of search patterns:
  • Formatted patterns, which offer the following search criteria:
    • Entity type (for example: Program, Screen...),
    • Keyword,
    • Location, package, or project,
    • Data Element Type (string-type Data Elements for example),
    • Data Element length.
    If several of these search criteria are combined, they are always associated with the AND operator.

    The content of the selected search pattern is displayed in the Formatted Pattern table and in the non-edit field 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,
      • Their length.
    • 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 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.
Four buttons are associated with the Search patterns list:
  • Edit, to create a search pattern which 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 which 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 initialize your new pattern. Then you access the search pattern editor.
  • Import, to import a search pattern made available as an XML file.
Formatted Pattern
This table is constituted of:
  • The Index column, which 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, which 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 which is displayed then.
  • A non-edit box, which displays the search in the SPARQL query language, used for the free form patterns.
Four buttons are associated with this table:
  • Add 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 which is displayed then. Select a new criterion in the list and give it a value.
  • Remove to remove a search criterion from the pattern. You must select a search criterion in the table before clicking Remove.
  • Move up to move up the selected criterion in the pattern, provided there is at least one previous line.
  • Move down to move down the selected criterion in the pattern, provided there is at least one following line.
Free Form Pattern
This edit field is:
  • Automatically completed with the SPARQL expression which 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 created in the Rational Team Concert Server to integrate the work done in workspaces.


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)