| Table of Contents |
|---|
After a STAGIL macro is added to the page, it is empty by default and will not be displayed in the page view until configured.
To start configuring the macro, go to page edit mode → hover over and click on the macro to see the macro edit toolbar. Select Edit (pencil icon) to open the macro content parameters configuration dialogue.
...
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 displays Jira issues or Confluence tasks. The first step is to set up the data the user wants to display by defining a scope—an exact list of tasks or issues conditioned by filters or managed manually.
Before configuring a scope, select a Jira instance to display issues from in the ‘Jira connection’ field.
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
Manualscopealso 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 for the list of supported fields.
To add a column, select a custom field in the ‘Jira issue columns to display’ drop-down list. The added field will be immediately available in the preview:
...
Supported system fields:
Summary*
Description
Status
Reporter
Assignee
Components
Priority
Original Estimate
Remaining Estimate
Due Date
Fix version
Labels
*Summary column is always displayed by default and can not be removed.
Supported custom fields:
...
Table pagination
In the ‘Rows per page’ configuration field, users can determine the number of issues or tasks that will appear on the screen before pagination is activated.