Jira offers a very powerful search engine that is based on JQL (Jira Query Language), which allows users to search for issues that match a specific criteria. Over the years JQL become a standard in various places like dashboard gadgets, REST API based integrations and apps.
Panorama adds an extension to JQL that allows you to search for issues that are present in the given panorama or even a specific directory inside of a panorama.
Searching for issues of a panorama
To search for issues that are present in a panorama there is an alias called "panorama" that will react to the name of your panorama, for example if you have a panorama named "Blue Mountain Coffee" to search for all the issues that are present in your panorama simply run the following query: panorama = "Blue Mountain Coffee"
Searching for issues of directory
Now let's say that your Blue Mountain Coffee panorama contains many issues but is internally divided to several directories, like this:
and you are only interested in the issues living in the Support directory, then you can use another alias called panoramaDirectory that will do just this, search for the issues that are inside the directory named Support:
Please notice the combination of both aliases panorama = "Blue Mountain Coffee" and panoramaDirectory = "Support", if we would use only panoramaDirectory = "Support" we will find all the issues that are under such directory and it may happen that there are more than single panorama with directory called Support which as a result will return issues from multiple panoramas.
Using search in gadgets
Panorama was build to help users gain visibility into what is happening inside their projects. Additionally to grouping fields and various views that panorama offers on its own, you can also use search aliases to combine panorama hierarchy abilities with powerful dashboards provided by Jira. By using the ability to search for issues of a given panorama (or even a specific directory) you easily create a Pie Chart gadget that will display a chart with distribution of Priorities or issue types:
With all the gadgets provided by Jira and apps the possibilities are almost endless and we hope these new search aliases will help you gain even more visibility into your projects.