Generators are powerful tools that let you create dynamic structures. These structures update themselves automatically when Jira changes.
You can use generators to build entire structures or add generators to a manually created structure – for example, add a generator to automatically place issues that match a query under a Flex item .
How Generators Work
Generators are special rules that tell Structure what issues to include from Jira and where to place them within the structure.
-
When you first build the structure, they add, organize, and filter issues based on your rules.
-
Each time a structure is opened, they run again and rebuild the structure, based on the current information available in Jira.
-
While you view the structure, they run in the background, checking for changes in Jira so your data stays up to date.
If multiple people are using a structure simultaneously, it is only generated when the first person opens the structure; however, it will continue to update in real time.
Adding a Generator
To add a generator to your structure, open the Add menu and select the type of generator you want to add.
The following types of generators are available:
-
Preset - Automatically add and configure generators to accomplish a specific use case.
-
Insert - Automatically add issues to the structure based on Jira fields, Jira boards, or a JQL query.
-
Extend - Add additional issues based on the Parent field or issue links.
-
Filter - Remove issues based on a JQL query.
-
Group - Group issues by fields or issue links.
-
Sort - Order the structure based on Jira fields.
Generator Scope
Generators are placed in the structure, just like other items, and their scope is defined by their position within the structure:
-
Place the generator at the top of the structure, and it will impact the entire structure.
-
Place it under a Flex item , and it will only affect items within that Flex item.
Generators can only be added under static items ( Flex items , manually added issues).
Generators cannot be added under dynamic items (items added by another generator).