How to Configure a Multi-Level Jira Snapshots Macro
- Rina Nir _RadBee
What are Multi-Levels Snapshots?
By default, each Jira snapshot report includes a “Level 1.” This is a list of Jira issues retrieved using a JQL clause.
Sometimes you’ll need to include other issues, which are dependent or related to the issues in Level 1. These will be retrieved by adding a Level 2 to the report.
Examples of Level 1 - Level 2 issues:
Epics and their stories
Issues and their subtasks
Stories and their related bugs
Issues and their “blocker” issues
XRAY Test issues and their test runs → In this specific case, the 2nd level is a XRay Test Runs levels in Jira Snapshots
Jira Snapshots supports additional levels; you could go as far as three or four levels, if needed.
Parameters (for Each Level)
Parameters are options that you can set to control the content or format of the macro output.
JQL is Jira Query Language. This is the native query language for Jira, and these macros use it directly when retrieving data from Jira.
New to JQL? We have put here Jira JQL cheat sheet some information to help you get started
Parameter name | Required | Default | Parameter description and accepted values |
|---|---|---|---|
Level type | Yes | Jira Issue | To learn more about Test Run Level type, read XRay Test Runs levels in Jira Snapshots . |
Level title | No | Empty | A title for this level will be displayed above the column titles. |
Search JQL | Yes | - | Refer to Jira Snapshots Filtering: Jira JQL extended with page properties and metadata |
Add fields to display | Yes | Key, Summary | The list of Jira fields to display. Use the widget just below the field to drag and reorganize the order of the columns in the level. The list of available fields is specific to the Jira instance the snapshot is connected to. The list includes custom fields configured for this instance.
|