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. |
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. |
0 Comments