Advanced Search Syntax and Options
The supported search string complexity ranges from keywords to keyword groups connected by logical operators.
You can specify the keywords by using wildcards.
In the advanced search, Boolean operators allow combination of terms using logic operators.
Codebeamer search supports the following Boolean operators:
• OR
• AND
• +
• -
• NOT
 |
Boolean operators, grouping (brackets), and fuzzy searches are only supported if you select the Allow Query syntax checkbox in the advanced search. Specify the OR, AND and NOT Boolean operators in all capital letters
|
Filtering Results by Date or Username
You can use dates and usernames in the search expressions to restrict the number of results.
Enter the dates in the following formats:
• YYYYDDMM
• YYYYDD
• YYYY
For example, to search for issues that are related to Firefox and are either submitted by or assigned to john.smith65 in 2014 May, use the query:
Firefox john.smith65 201405
Wildcard Searches
| | This feature only works when the Allow Query syntax checkbox is selected in the advanced search form. |
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 the keywords text or test,use the following query :
te?t
Multiple character wildcard searches, search for zero or more characters. For example, to search for the keywords test, tests or tester, tuse the following query:
test*
You can also use wildcard searches in the middle of a term:
te*t
Escaping Special Characters
The Codebeamer search supports escaping special characters that are a part of the query syntax. The following special characters are supported:
+ - && || ! ( ) { } [ ] ^ " ~ * ? : \
When these characters are in the search text, use the \ character before the character. For example, to search for the term (1+1):2, use the query:
\(1\+1\)\:2
Grouping
| | This feature only works when the Allow Query syntax checkbox is selected in the advanced search form. |
Codebeamer supports using parentheses to group clauses into sub queries. This is very useful when defining a more complex Boolean logic for a query.
For example, to search for one of the terms jakarta or apache, and also for the website term, use the query:
(jakarta OR apache) AND website
Fuzzy Searches
| | This feature only works when the Allow Query syntax and Find approximate matches checkboxes are selected in the advanced search form. |
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.
To search a term having spelling similar to roam, use the fuzzy search:
roam~
This search returns terms like foam and roams.
Extended Search
By default, the words in a search expression are connected by AND. The result contains only those items that match all parts of the expression.
To change this setting, navigate to the Advanced Search page and click the Extended search checkbox.
As a result, the words of the expression are connected by OR, and all items matching at least one of the words appear in the search result.
Restricting Search Scope with Project Groups
Searching by project group helps to narrow down the scope of the search. See Project Groups for more information on working sets.
Search for Artifacts by Owner or Submitter
To find artifacts created by a particular user, add the relevant Codebeamer username to the Owner/Submitter field.
To search for items submitted by the account j.wilson, add it to the Owner/Submitter field of the search form:
j.wilson
You can also use real usernames or other account data such as company name, phone number and others for searching.
To search for items submitted by the company PTC, add it to the Owner/Submitter field of the search form:
PTC
Search for Artifacts by Creation or Modification Date
Enter dates and intervals to search for artifacts created or modified After or Before a specific date or interval:
Examples:
To find all artifacts that are 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
Created / Before: 2005-05-30
To find all artifacts that are 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
Modified / Before: 2005-05-30
Search for Artifacts by Date and by User
To find all artifacts which are 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
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 in the Boolean operators section do not apply to this. |
Example:
To search for the source code symbol open, enter the following values and click GO:
Search for: | open |