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! 

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. 

Searching by Attribute

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

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.
created	Filter for items that created before, or after, a certain date. When using "created", you'll use created "greater than" the start date, or "less than" the end date.
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.

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.

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.