Macro configuration
After a STAGIL macro is added to the page, it is empty by default and requires for a scope to be configured.
To start configuring the macro:
Enter page edit mode.
Hover over the macro and click the pencil icon in the toolbar to open the macro configuration.
Macros can include multiple scopes, each shown as a tab in the macro. Scopes are configured individually.
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.
To configure a scope:
Hover over the scope name in the configuration dialog.
Click the [···] icon.
Select Edit to open the scope settings.
Adding a new scope
To add a new scope, click on the Add scope link button in the macro configuration:
Scope types
Macros can contain multiple tables with different scopes. Each new scope table will be displayed in a separate tab. STAGIL Macro offers the following scope types:
JQL filter
This scope allows the display of a list of JQL query results.
Jira manual selection
Allows users to build a custom issue list directly from the page view. They can search for existing issues or create new ones on the spot. Any issue added is instantly displayed in the macro table. There are several ways to add issues to this scope:
Only the Jira manual selection scope allows users to remove individual issues from the table. To do this, hover over the issue row in page view. A [···] menu will appear on the right. Click it to open the ‘Actions’ menu and select Remove. The issue will be immediately removed from the macro.
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).
Scope configuration
Each scope has its own configuration dialog.
Jira issue scopes share the following configuration fields:
Name: Give your scope a name. This name is shown as a tab label in page view.
Display style: Choose how issues should be shown:
Table — display issues in a list with columns
Kanban board — display issues as cards in columns based on status
Jira issue columns to display: Select which issue fields (system or custom) should be shown in the table view. See Issue fields supported in macro for the list of supported fields. Columns can also be added or removed from the table directly from the page view. Click on the filter icon in top right corner of the macro to open the column configuration menu:
Rows per page: Choose how many issues to show at once in the table before pagination: 10, 25, 50, 100.
JQL filter scope will also contain the JQL query input field. It will define the list of Jira issues to display based on the provided JQL query.
When configuring ‘Confluence tasks’ scope tasks can be filtered by location, status, assignees, and due date.
Related content
© 2023, STAGIL