Upsource 2018.1 Help

Keymap:

Searching for reviews

You can search for 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:

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.

When you are on a project page, your search is always limited to that particular project. To search across your favorite projects, go to an entry page where they are listed.

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:

Inspect the search results and filter them out if necessary by refining your query. Right below the search field, you can see how many reviews there are in each common group (created, assigned, has concern, etc.) and narrow down the results to a particular group just by clicking it.

Each review has a number of attributes, such as state, commit, author, etc. In turn, each attribute has a value. When searching for specific reviews, 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}

watcher:

Upsource user name

Search for reviews that are watched by a specified user

watcher: {Andrea DeLacey}

participant:

Upsource user name

Search for reviews that include a specified user as a creator, reviewer, or watcher

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

closed-by:

Upsource user name

Search for reviews closed by a specified user

closed-by: {Andrea DeLacey}

closed:

Review closing date

Search for reviews closed on a specified date

closed: 2016-Jan-15

updated:

Review last updated date

Search for reviews updated on a specified date

updated: 2017-Jan-09

accepted-by:

Number of reviewers

Search for reviews accepted by a specified number of reviewers

accepted-by: 2

duration:

Review duration

Search for reviews that have (or had) been open for a specified period of time (or longer)