Tags:  Search

Searching

Using full text search you can search projects or workspaces for documents, tasks, bugs, forums, Wiki pages, users, SCM commit comments, attachments and projects. The search is based on indexing, which takes place in the background and the new artifacts are searchable within seconds. Once indexing is complete, CodeBeamer's search automatically synchronizes with any changes you make. You can search and then place tags or labels on the relevant items you found, and share just about everything with your team.

Full-text search is provided for:

  • documents - including Microsoft Word, Microsoft Excel, RTF, PDF, HTML, wiki and text document contents,
  • projects - the content of the name, description and category fields,
  • tracker items - including all fields, comments and attachments. For attachments the same file formats are supported as for document search,
  • forum messages,
  • CMDB configuration items,
  • e-mails in forum inboxes and
  • report - the content of the name and description fields.

CodeBeamer Simple Search Syntax

A simple syntax is used for word based searches.  The simple search field is found in the upper right corner of almost every codebeamer screen. The special characters usable in this syntax are the double quote mark ", # (hash mark) and (asterisk). The meanings of them are the following:

  • "microsoft" - double quotes are used for exact expression matches. It is case-insensitive and will, for example, match both "Microsoft" and "microsoft".
  • #1 - putting "#" (hash mark) in front of a number means search for this an identifier in CodeBeamer (in this example 1). See section below on Searching
  • org* - putting "*" (asterisk) at the end of the word means search for all words which start with the given sub-word (in this example org). This means it will match organization, organ, etc.

These search syntax limiters are listed here in order of "precedence" and they are not easily mixable: a "microsoft*" search will match only for exact microsoft* words in document (probably very rare), while "#1*" will only match for #1 words in the document.

Wildcard Searches

CodeBeamer supports single and multiple character wildcard searches.

To perform a single character wildcard search, use the "?" symbol.

To perform a multiple character wildcard search, use the "*" symbol. The single character wildcard search looks for terms that match the single character replaced.

For example, to search for "text" or "test" you can use the following query:

te?t

Multiple character wildcard searches look for zero or more characters. For example, to search for test, tests or tester, you can use the search:

test*

You can also use the wildcard searches in the middle of a term.

te*t

Escaping Special Characters

The CodeBeamer search supports escaping special characters that are part of the query syntax. The following special characters are supported:
+ - && || ! ( ) { } [ ] ^ " ~ * ? : \

When these characters are in the search text, use the \ character before them (to 'escape' them). For example to search for the term "(1+1):2" use the query:

\(1\+1\)\:2

Search Tabbed Results

In both simple and advanced searches, Trackers, forums, wikis, acounts and document items in codeBeamer are all searched for the keyword or text. The results are given in a tabbed table, separated into pages. For example a search on:

126

gives results as shown in the screen capture figure below. Click the appropriate tab, sort the table-result by columns by clicking on the column-headings or page through the results to find what you want, and click your desired link.

Figure: Search Results

Simple Searches made Fuzzy

A simple search initially looks for the pattern, plus the * wild-card suffix, to look for the exact given pattern, plus any following characters. If this returns no results, then codeBeamer will go on to do a fuzzy search on the given pattern.

If a previous Advanced Search, in the same session, turned on "Allow Query Syntax", any simple searches subsequently performed will not be fuzzy. You can deliberately make a simple search fuzzy either by
  1. including the tilde suffix to make a particular search fuzzy as described below (which is a one-of fuzzy search), or
  2. by clicking the "Allow Query Syntax" flag again in Advanced Search mode, to re-set or disable it, which semi-permanently resets searching to default to fuzzy searches.

Advanced Search Syntax and Options

The supported search string complexity ranges from keywords to keyword groups connected by logical operators. The keywords can be specified using wild cards, as described above. In the Advanced Search, Boolean operators allow terms to be combined through logic operators. CodeBeamer search supports the OR, AND, +, - and NOT boolean operators. Boolean operators, grouping (brackets) and fuzzy searches are only supported when the 'Allow Query Syntax' box is checked, in the Advanced Search.

The OR, AND and NOT boolean operators must be used in ALL CAPS form.

Figure: Advanced Search on CodeBeamer Applications.

OR

The OR operator links two terms and finds a matching document if either of the terms exist in the document. This is equivalent to a union using sets. The || symbol sequence can be used in place of the OR word. To search for documents that contain either the "jakarta apache" or just "jakarta" strings, use the following query:

"jakarta apache" OR jakarta

The OR operator is optional. This is why the following search string is equivalent to the above one:

"jakarta apache" jakarta

AND

The AND operator matches documents where both terms exist anywhere in the text of a single document. This is equivalent to an intersection using sets. The && symbol sequence can be used in place of operator AND. To search for documents that contain both the "jakarta apache" and the "Apache CodeBeamer" terms, use the following query:

"jakarta apache" AND "Apache CodeBeamer

+

The "+" operator requires that the term after the "+" symbol exists in the document. To search for documents that must contain the "jakarta" term and may contain the "apache" term, use the following query:

+jakarta OR apache

-

The "-" operator excludes documents that contain the term after the "-" symbol. To search for documents that contain "jakarta apache" term but not "Apache CodeBeamer" term, enter the following query:

"jakarta apache" -"Apache CodeBeamer"

NOT

The NOT operator excludes documents that contain the term after the NOT operator. This is equivalent to a difference using sets. The ! symbol can be used in place of the word NOT. To search for documents that contain the "jakarta apache" term but not the "Apache CodeBeamer" term, use the query:

"jakarta apache" NOT "Apache CodeBeamer"

The NOT operator cannot be used with just one term. For example, the following search will return no results:

NOT "jakarta apache"

Grouping

CodeBeamer supports using parentheses to group clauses into sub queries. This can be very useful if you want to define a more complex boolean logic for a query.

For instance, to search for one of the terms "jakarta" or "apache" and also for the term "website", use the query:

(jakarta OR apache) AND website

Fuzzy Searches

CodeBeamer supports fuzzy searches based on the Levenshtein Distance, or Edit Distance algorithm. To do a fuzzy search use the tilde, "~", symbol at the end of a single word term. For example to search a term which spells similar to "roam" use the fuzzy search:

roam~ 

This search will find terms like foam and roams.

Restricting Search Scope with Working Sets

When you know that what you're searching for is in a certain type of project, but you don't know exactly which project, searching by working set helps to narrow the scope of the search. Please see Grouping Projects with Working Sets for more information on working sets.

Search for Artifacts by Owner / Submitter

You can enter a CodeBeamer user name or account name in the Owner/Submitter field if you want to find artifacts created by a particular user. To search for work items submitted by the account "j.wilson" you can enter in the Owner/Submitter field of the search form:

j.wilson

You can also use the account's real user name or other account data such as company name, phone number and others for searching. To search for work items submitted by the company "Intland" you can enter it in the Owner/Submitter field of the search form:

Intland

Search for Artifacts by Creation / Modification Date

Enter dates and intervals to search when artifacts were created or modified by filling the After and Before fields of the search form. THis way you can find all documents or tracker items which were uploaded onto the server at a specific interval of time. To find all artifacts which were uploaded to the server between 2005-05-04 and 2005-05-30, enter the following values and click GO :

Created / After: 2005-05-04
Created / Before: 2005-05-30

To find all artifacts which were modified on the server between 2005-05-04 and 2005-05-30, enter the following values and click GO :

Modified / After: 2005-05-04
Modified / Before: 2005-05-30

Search for Artifacts by Date and by User

To find all artifacts which were modified by the account "j.wilson" on the server between 2005-05-04 and 2005-05-30, enter the following search criteria:

Modified / After: 2005-05-04
Modified / Before : 2005-05-30
Owner/Submitter: j.wilson

Search for Source Symbols and Files

The search for source symbols and files supports only simple pattern matching. The more advanced features described above in the boolean operators section do not apply here. For example to search for the source code symbol "open", enter the values following value and click GO :
Search for: open