Upsource 3.0 Help

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. From the Upsource entry page: Go to the Reviews tab located in the right pane.

    From a project home page: Click Reviews on top of the revisions list.

  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 reviews 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.

Last modified: 8 November 2016