To start macro configuration, open your page in edit mode.
Add a STAGIL macro to the page or select existing. Click on the macro to see the ‘Edit’ button.
Click the ‘Edit’ button to open the ‘Edit macro’ dialogue.
When first added to the page, the macro will be empty, with no issues displayed.
Scope: adding issues to the macro
There are 2 options for adding issues to the macro. Issue displayed in macro are defined via ‘Scope’ configuration. There are 2 scopes:
‘JQL' scope - allows to include issues returned via a JQL query. Can also be set via the ‘Add existing issues’ button in the
panel. ‘Manual’ scope - prompts a create issue dialogue. After saving, the new issues will be displayed in the preview. Can also be set via the ‘Create issue’ in the
panel.
Manual scope
To keep adding issues in the manual scope click the ➕ icon at the beginning of the table row. When selected the button opens a menu with options to create a new issue or add existing ones (via JQL).
Manuel scope: removing issues
To remove a single issue from the table hover over the right end of the issue table to reveal a three-dot icon. Click the button to open the ‘Actions’ menu with an option to remove the issue from the table.
Default values for the ‘Create new issue’ dialogue
When users create a new issue from macro, they see and edit the ‘Create issue’ dialogue. The ‘Default field values’ configuration field allows to pre-populate of certain fields with a particular value.
To configure, first, select a custom field in the ‘Default field values’ drop-down.
Then, click on the ⚙️ icon. In the pop-up tab, you can set default values for each of the selected fields.
Table columns
In the issue table columns represent the issue fields. A wide range of system and custom fields is available to add, view and edit via our macro. See Supported field types for the list of supported fields.
To add a column, select a custom field in the ‘Column display’ drop-down list. The added field will be immediately available in the preview.
Table pagination
In the ‘Issues per page’ configuration field, users can determine the number of issues that will appear on the screen before pagination is activated.
Default ordering
In the 'Order by' configuration field, users have the option to choose a custom field to sort table rows based on custom field values.