Using full-text search

You can use full-text search to quickly locate test artifacts in a project.

Procedure

With full-text search, you can search for text almost anywhere in the project. Or you can limit the search to artifacts of a particular type.

Full-text search is based on the Apache Lucene text-search engine and supports features such as wild cards, fuzzy search, proximity searches, and ranges.

  1. Type your search text in the Search box, located in the upper right side of your browser window.

    The search results are displayed as you type.

  2. To fine-tune the search, click More Options and select only those artifact types that you want to include in the search.
  3. Click the Search icon (Search).

    The updated search results are displayed in the main window, as shown in this figure:

    Search Results
  4. After you run the search, you can take further actions to modify the results.
    • Type in the Type Filter Text field (Filter) at the upper, right-hand corner of the search results section to display only items that contain the typed text.
    • In the Group by field, click the down arrow and make a selection to sort the results.
    • Click the Change Display Settings (Change Display Settings) icon to change the columns that are displayed in the search results or to change the width of each column.
  5. Optional: Configure the number of items that a search returns.

    By default, the search returns up to 100 items. To increase or decrease that number:

    1. Log on as a user with JazzAdmins repository permissions.
    2. Click the Admin (Administration) icon in the top right portion of the banner, and click Manage Application.
    3. Under Configuration, click Advanced Properties to display the current settings for all system services for Quality Management.
    4. Search for com.ibm.rqm.planning.service.internal.rest.FullTextRestService.
    5. To the right of the Limit Search Results field, replace the Current® Value (100) with a different value, such as 500.
    6. When you are ready to commit the changes, click Save.
    The next time you run a search, the search will return up to the specified number of items.

Example

To search for part of a word, you must use a wild card (* or ?). Use an asterisk (*) to replace multiple characters. Use a question mark (?) to replace a single character. For example, the search term par* returns partly, participate, partial, and other words that begin with par, while the search term par? returns part and park.

Note: Wild cards are limited to a single word. For example, the search term par* would not return partly cloudy.

You can identify some words or phrases as an exact string by enclosing them in double quotation marks (" "). For example, when you input "log file" in the Search field instead of log file, you search for the complete string log file. Without the double quotation marks, the search term is interpreted to find instances of both the word log and the word file.

Note: Searches that contain a phrase enclosed in double quotes can only contain one phrase. For example, you can search for "find this", but not "find this" RTC "or that".


Have a problem or a question? Post it in the Jazz.net forum.