/
Macro configuration

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:

  1. Enter page edit mode.

  2. 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:

  1. Hover over the scope name in the configuration dialog.

  2. Click the [···] icon.

  3. 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:

image-20240513-182442.png
Adding issues to manual scope in the ‘Edit macro’ dialogue (with no prior configuration)
image-20240513-182825.png
Adding issues to manual scope in page view (with no prior configuration)
image-20240513-182920.png
Adding issues to manual scope in page view (with already existing configuration)

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.

image-20240513-183017.png
Removing an issue from manual scope results in page view

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).

image-20240513-184352.png
‘Confluence Tasks’ scope in page view

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:

image-20241130-192929.png

Rows per page: Choose how many issues to show at once in the table before pagination: 10, 25, 50, 100.

image-20250421-125208.png
Configuration dialog for the ‘Jira manual selection’ scope

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.

image-20250421-125417.png
Configuration dialog for the ‘JQL filter’ scope

When configuring ‘Confluence tasks’ scope tasks can be filtered by location, status, assignees, and due date.

image-20240513-184617.png
Configuration dialogue for ‘Confluence Tasks’ scope

 

Related content

© 2023, STAGIL