Searching with the Awesome Bar

Overview

The Awesome Bar is the search bar across the top of the Tickets, Reports, Mine, and Prioritize tabs. It provides a type-ahead, keyboard-based interface to our Search API. You can use it to find items by assignee, created within a certain date range, unassigned or unestimated items, and ones that have attachments.

A few unique features of Sprintly's Awesome Bar search functionality:

  • Search results return items across all products you are a member of.
  • Each search term is combined with an AND rather than an OR.
  • You can add a filter multiple time.
  • Negative filters (e.g. not tagged with "My Project").

Anatomy of an Awesome Bar Filter

Every filter is made up of a few different parts:

  • The attribute name (e.g. status or assignee)
  • The symbol (e.g. equals or does not equal)
  • The value

Sprintly's Awesome Bar offers a visual, type-ahead interface with tab completion to these filters. No more having to remember complicated pseudo SQL! 

2017-03-01_at_12.52_PM.png

Free Text Searching

You can also just type in some text to search for items using free text. This will look for the term "file" or "attachment" in item titles, descriptions, and comments. 

2017-03-01_at_12.58_PM.gif

Searching by Attribute

Finding items by attributes like assignee or type is straightforward with the Awesome Bar. 

2017-03-01_at_12.43_PM.gif

Each item in Sprintly has a number of attributes that you can filter for. Below is a complete list of each attribute you can filter by and what they filter for.

Attribute Description
accepted_by Filter items accepted by the user ID specified.
assignee Filter items assigned to the user ID specified.
author Filter items created by the user ID specified.
blockers Filter for items with a given number of blockers.
blocking Filter for items that are blocking a given number of items.
blocks Filter for items that are blocking the user ID specified.
description Filter for items whose description matches the search terms specified.
favorites Filter for items with a given number of favorites.
loved_by Filter items that have been favorited by the user ID specified.
mentioning Filter items that mention the user ID specified.
product By default all queries will return all items for any product the requesting user has access to. To filter items by a specific product, or products, you use the product ID.
size Filter for items with a given size estimate. Valid values are ~, S, M, L, and XL.
status Filter items for a given status. Valid values are someday, backlog, in-progress, completed, and accepted.
team An item’s team consists of anyone who has had a meaningful interaction. Anyone that favorites, follows, comments on, is mentioned in, or uploads an attachment to is added to an item’s team along with the creator, any assignee, and acceptor.
title Filter for items whose title matches the search terms specified. “dashboard” would filter for items whose title matches the phrase “dashboard”.
type  Filter for items of a given type. Valid values are task, story, defect, and test.

Using Negative Filters

The Awesome Bar also lets you search for items that do not match a given filter. For instance status is not Backlog or not tagged with foo. To apply a negative filter choose "does not equal" for the symbol of your filter.

2017-03-01_at_1.06_PM.gif

Export to CSV

By clicking the button to the right of the Awesome Bar will run a report that will send you a CSV file via email. CSV files can be imported into Excel, Google Spreadsheets, and many other analysis/reporting tools.

2017-03-01_at_1.13_PM.png

Using is and has to Filter by Item Facts

The is and has filters are two pseudo attributes that allow you to filter items based on certain facts about them. For instance you can filter by items that have attachments, has a PR opened, or is unassigned.

has

The has filter lets you filter for features an item possesses. Below is a list of values you can use with this filter and a short description of what it filters for.

Attribute Description
attachment Whether the item has been moved to another product or not.
children Whether an item has sub-items or not.
comment Whether or not an item has one or more comments.
commit Whether or not an item has had a commit pushed relating back to it.
estimate Whether or not an item has been assigned a size estimate.
favorite Whether or not an item has been favorited.
moved Whether the item has been moved to another product or not.
parent Whether or not the item is a sub-item of a story.
pr Whether the item has had a PR issued against it.
tag Whether or not an item has one or more tags.

is

The is filter lets you filter for facts about an item. Below is a list of values you can use with this filter and a short description of what it filters for.

Attribute Description
assigned If the item does have an assignee.
blocked Whether or not the item is currently blocking another item.
blocker Whether or not the item is a blocker for one or more items.
child If the item is a sub-item.
deployed If the item has been deployed or not.
duplicate Whether or not the item is a duplicate of another item.
duplicated Whether or not one or more items has been marked as a duplicate of the item.
unassigned If the item does not currently have an assignee.
Have more questions? Submit a request

0 Comments

Article is closed for comments.
Powered by Zendesk