DZone
Thanks for visiting DZone today,
Edit Profile
  • Manage Email Subscriptions
  • How to Post to DZone
  • Article Submission Guidelines
Sign Out View Profile
  • Post an Article
  • Manage My Drafts
Over 2 million developers have joined DZone.
Log In / Join
Refcards Trend Reports Events Over 2 million developers have joined DZone. Join Today! Thanks for visiting DZone today,
Edit Profile Manage Email Subscriptions Moderation Admin Console How to Post to DZone Article Submission Guidelines
View Profile
Sign Out
Refcards
Trend Reports
Events
Zones
Culture and Methodologies Agile Career Development Methodologies Team Management
Data Engineering AI/ML Big Data Data Databases IoT
Software Design and Architecture Cloud Architecture Containers Integration Microservices Performance Security
Coding Frameworks Java JavaScript Languages Tools
Testing, Deployment, and Maintenance Deployment DevOps and CI/CD Maintenance Monitoring and Observability Testing, Tools, and Frameworks
Partner Zones AWS Cloud
by AWS Developer Relations
Culture and Methodologies
Agile Career Development Methodologies Team Management
Data Engineering
AI/ML Big Data Data Databases IoT
Software Design and Architecture
Cloud Architecture Containers Integration Microservices Performance Security
Coding
Frameworks Java JavaScript Languages Tools
Testing, Deployment, and Maintenance
Deployment DevOps and CI/CD Maintenance Monitoring and Observability Testing, Tools, and Frameworks
Partner Zones
AWS Cloud
by AWS Developer Relations
  1. DZone
  2. Data Engineering
  3. Databases
  4. How to Search for Issues in YouTrack

How to Search for Issues in YouTrack

Jura Gorohovsky user avatar by
Jura Gorohovsky
·
Sep. 24, 09 · Interview
Like (0)
Save
Tweet
Share
15.94K Views

Join the DZone community and get the full member experience.

Join For Free

Now that YouTrack has been announced and adopted by most JetBrains products, it's time to show how it actually works. That's because you report bugs to JetBrains now and then, don't you?

Let's start with the way you search for issues.

You do that by typing a natural-language-like search query in the search box. For example, the following query finds you all critical issues in project "YouTrack" that should be (or should have been) fixed for version 1.0.

YouTrack search box

Even when you're somewhere outside of the search box, no need to grab your mouse to get there: just press Esc.

The primary building block of YouTrack search queries is an attribute-value pair. Issue attributes include issue ID, project, state, type, priority, assignee, reporter, date of creation/update, associated tags etc. For example, to find all critical issues that won't fix in project "IDEA Development", you type the following query:

state: {Won't fix} priority: critical project: IDEADEV

You can make your query even shorter by skipping unambiguous keywords. For example, in this case, keywords “state”, "priority" and "project" can be safely omitted:

#{Won't fix} #critical #IDEADEV

On the other hand, "today" would be an ambiguous value because it is valid for two attributes: "updated" and "created". That's why using it without explicitly specifying one of those attributes could render inaccurate search results.

Several things make YouTrack query language special, and one of those things is the use of shortcut keywords. When looking for all issues assigned to or reported by yourself, no need to enter a cumbersome query like

assigned to: me or reported by: me

Instead, type

#my

Of course, search queries may also contain full-text search items: for example, typing

#unresolved light bulbs

returns all unresolved issues that contain words "light" and "bulb" in summary, description, comments etc.

When you type a query into the search box, YouTrack displays suggestions using query completion: YouTrack query completion

We suggest that you use query completion extensively, for two reasons:

  • Plain and simple: it lets you enter queries faster.
  • More importantly, it automatically inserts special syntax items for you:
    • Colons (:) after attributes.
    • Hash marks (#) before values specified without attributes.
    • Curly braces ({}) around values that contain spaces.

In most cases, query completion displays automatically but whenever you need to call it at will, just press Ctrl+Space or Alt+Down. With any character you type, the completion list shrinks to show only the matching options:

YouTrack query completion only shows matching suggestions

To help you get the feel of YouTrack search queries, here are some practical examples from our own YouTrack instance:

  • Issues from three IntelliJ IDEA projects assigned to Max Shafirov that were updated this week.
  • Unresolved dotTrace features scheduled for version 4.0.
  • RubyMine issues supporting YAML implemented in version 1.5.
  • Unresolved YouTrack issues sorted by number of votes in descending order.

Let's sum it all up. In YouTrack, instead of setting up complicated filters in forms that bolster your inferiority complex, you just type what you are looking for in a manner very similar to how you would say it in plain English, aided by query completion.

There have been other issue trackers that used search queries as a filtering option but there are none to my knowledge that rely as heavily on them and make them as usable as YouTrack.

For additional information on YouTrack search queries, see the following docs:

  • YouTrack Quick Start Guide: Searching for Issues.
  • YouTrack search demo.
  • YouTrack Search Keyword Reference.
  • YouTrack search features at the JetBrains website.

You can download YouTrack 1.0 Beta or use our Early Access Program to receive latest builds.

Track with pleasure!

Database

Opinions expressed by DZone contributors are their own.

Popular on DZone

  • Authenticate With OpenID Connect and Apache APISIX
  • Fargate vs. Lambda: The Battle of the Future
  • gRPC on the Client Side
  • Important Data Structures and Algorithms for Data Engineers

Comments

Partner Resources

X

ABOUT US

  • About DZone
  • Send feedback
  • Careers
  • Sitemap

ADVERTISE

  • Advertise with DZone

CONTRIBUTE ON DZONE

  • Article Submission Guidelines
  • Become a Contributor
  • Visit the Writers' Zone

LEGAL

  • Terms of Service
  • Privacy Policy

CONTACT US

  • 600 Park Offices Drive
  • Suite 300
  • Durham, NC 27709
  • support@dzone.com
  • +1 (919) 678-0300

Let's be friends: