Insert generators allow you to automatically add issues to the structure. This is often the first step in building a new structure using automation, since it allows you to import specific issues that you can then sort, group, filter or expand upon using additional generators.
Some examples of how you might use the Insert generator include:
- Add all Epics from a specific Agile board (and then you could use the Extend Generator to add stories and sub-tasks)
- Use a JQL query to add all issues assigned to you (and then organize them with a Group Generator or Sort Generator)
- Insert issues from specific projects into their own folders within the structure
- Compile multiple structures into a single structure
Insert generators can only add issues from Structure-enabled projects.
Types of Inserters
As you add an Insert generator, you can choose from the following options:
- Agile Board Inserter — Adds issues from a selected Agile board into the structure.
- JQL Query Inserter — Adds the results of the JQL query to the structure.
- Structure Inserter — Adds a selected structure into the current structure.
- Text Query Inserter — Adds the results of a text search to the structure.
Additional Insert generators may also be available, depending on the add-ons you have installed. For instance, if you have Structure.Pages installed, you will see a Confluence Pages Inserter in your drop-down list.
Generators run every time you open a structure, so the list of issues added by the Insert generator is always up-to-date.
Additionally, if issues change as you work with the structure, they will be added or removed accordingly, based on the rules of your Insert generator.