Code Collaborator has a sophisticated search facility allowing you to find reviews in many ways. Uses include:
| • | Find reviews by review ID. |
| • | Find reviews with substrings in title and custom fields. |
| • | Find reviews with specific participants. |
| • | Find reviews of particular changelists by check-in comment or changelist ID. |
| • | Find reviews of certain files by file path. |
| • | Find reviews having a substring in comment or defect text. |
Our newest feature regarding the search box is the ability to jump to a review by entering the unique review ID number into the search box. If the number entered matches a review ID number, you will automatically be taken to review. This allows you to bypass search results and quickly find the searched review.
Enter the Review ID number into the search box at the left side of the website menubar:
The browser will be automatically directed to Review # 1243:
There will be a box at the top which notifies you that you have jumped directly to the review with the matching ID number. If you did not intend to go to the review and wanted search results instead, click on the link indicated by the red arrow above.
Starting a Search
To start a search, type the search term into the box at the left side of the web site menubar:
The system will automatically search in all the ways listed above.
The number of displayed search results will be limited if the search produces too many results. The default number displayed will usually be "10." This can be changed in the form that will appear at the top of the search results. To display more or less than shown, change the value in the "number of search results" field and click "search."
Because there are many types of searching, each result block is drawn separately. For example, here's the results of searching inside review title and custom field text:
Note several features of the search results:
| • | Text at top of the block explains exactly what the block is searching on. |
| • | Reviews are displayed in creation-date order, most recent first. |
| • | Specific search term is highlighted in yellow. |
| • | Jump to a review by clicking the ID link. |
| • | When there are many results, a message appears near the top in green. |
You may notice that some reviews do not have the yellow highlight. Why did these reviews match the search? This search looks not only at the review title and participants but also in all custom fields. Those fields are not, however, displayed in this view, so nothing can be highlighted. (Custom fields are not shown because there can be a large number of them which would make the search results difficult to read.)
Here's another example where the block is searching over files present in the review:
