Upsource

Searching reviews

You can search specific reviews across entire Upsource or selected projects using a wide range of search criteria including discussion comments.

To find a specific review:

  1. On the Upsource entry page or a project home page, go to the Reviews tab located in the right pane. Note: When you are on a project page, your search is always limited to that particular project. To search across entire Upsource, go to an entry page where all projects are listed.

  2. Enter your query in the search text field. You can use a drop-down menu to select attributes and values; your recent queries can be also found there:

    search_reviews

  3. Inspect the search results and filter them out if necessary by refining your query.

Each review has a number of attributes, such as state, commit, author, etc. In turn, each attribute has a value. When searching for specific issues, you specify an attribute with a selected value. You can combine several attribute-value pairs to narrow down your search. For example, state: open author: Herbert Binkley will return all issues created by Herbert Binkley that have not been closed.

Attribute Value Meaning Example
Commit: commit ID Search for reviews that include a commit with a specified ID commit: 39fa60b
State: open, closed Search for reviews in a specified state state: open
Author: Upsource user name Search for reviews created by a specified user author: Trevis Wikett
Reviewer: Upsource user name Search for reviews that are to be o have been reviewed by a specified user reviewer: Andrea DeLacey
Path: file name and/or path Search for reviews that include a specified file path: */newdir/newfile.java
Project: project ID Search for reviews in a specified project project: JB Demo

Besides, there are shortcut keywords that combine a number of attribute values each. For example, #my returns issues that you either authored or are assigned to as a reviewer.

Keyword Meaning
#My Search for reviews that you either authored or are assigned to as a reviewer
#{ready to close} Search for reviews you created that have been completed by all reviewers and can be now closed
#{to review} Search for reviews which you are expected to complete (accept or reject the changes)
#{authored by me} Search for open and closed reviews that you created

You can also search review titles and discussion comments for specific words or phrases, including them in your query.