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.
Macro scopes
Users can create a custom data table that will display Jira issues or Confluence tasks. The first step is to set up what data the user wants to display by defining a scope — an exact list of tasks or issues conditioned by filters or managed manually.
To add a new scope, click on the ‘Add scope’ link button in the macro configuration:
Macros can contain multiple tables with different scopes. Each new scope table will be displayed in a separate tab.
Scope: JQL filter
This scope allows the display of a list of JQL query results.
To configure, select the JQL filter in the ‘Scope type’ selector and enter a query in a ‘JQL’ field:
Scope: manual issue selection
Manual scope also allows to return issues from a JQL query. However, the JQL query is not pre-configured in the same way as for the JQL scope. Instead, users can add issues that have been returned by multiple JQL queries. New JQL queries are added from ‘Edit macro’ dialogue:
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. Issues can be removed by users directly from the page view in the ‘Edit macro’ dialogue.
Scope: Confluence tasks
This scope allows us to get a list of Confluence tasks in the instance. The tasks table is displayed with 4 default columns: Description, Assignee, Due Date and Page (parent page of the task).
Tasks can be filtered by location, status, assignees, and due date.
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 Issue fields supported in macro 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.
Sorting direction
A checkbox ‘Reverse order’ gives an option to define the direction of sorting.
To sort issues in ascending order, leave the box unchecked. Check the box to sort issues in descending order.
This configuration is available only for a JQL scope.