Upsource 3.5 Help

Searching reviews

You can search specific reviews using a wide range of search criteria including discussion comments. Search across your favorite projects, or limit your search to a particular project you're currently in.

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, created-by, 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 created-by: 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 that include commits made by a specified user author: Trevis Wikett
reviewer: Upsource user name Search for reviews that are to be or have been reviewed by a specified user reviewer: Andrea DeLacey
created-by: Upsource user name Search for reviews created by a specified user created-by: Andrea DeLacey
created: Review creation date Search for reviews created on a specified date created: 2016-Jan-15
updated: Review last updated date Search for reviews updated on a specified date updated: 2017-Jan-09
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: 21 February 2017