Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Tip

You can now share your traceability matrices more easily with your coworkers, by inserting them in your Confluence pages.

Insert the macro

  1. In the Confluence page editor: Type /req to access the RY macros, and select the RY Report macro

...

Click on a query to select it, and press Enter or click on Insert to insert the macro in the page

...

  1. Select the desired saved matrix

...

3. Then, you’ll see a recap of the selected matrix, and you’ll be able to configure the report display:

  • By default, we display the title and description of the matrix. If you do not want to see them in the Confluence page, you can remove them with the toggle.

⚠️ Permissions on the matrices

Matrices need to be shared to the whole space to be displayed in the Report macro. If you have not made them public before hand, you can edit the permissions directly when selecting a matrix (c.f : Step 2.)

The regular way to edit the permissions of your matrices is in the Saved Matrices tab → Edit → And select either the “With view only permissions” or “With view and edit permissions” radio button.

...

🎉 Tada

...

Sharing permissions

Note that you can share your traceability matrices either :

  • to allow other users to update it using the “With view and edit permissions”

  • to allow others to only see the result of your matrices without being able to update your template using “With view only permissions”. However other will be able to clone your matrices if they went to use yours as template.

To go further

Use the report

Once the report is embedded and the page published, you can interact with the report like you would in the Traceability tab: Move/Add/Remove columns, click on requirement keys to show their details, etc..

...

To make permanent changes to a traceability macro, go to the Saved queries tab, select the macro you wish to change, make your changes, and don’t forget to save.

...

Edit external properties

On macro creation, you can decide to allow users to edit the external properties directly in the Confluence page by checking “Enable the edition of external properties in the report macro”

Changes to external property values will then be saved.

Exports of Confluence pages

Unlike requirement definitions or links, the report macro is not available in the exports to Word or Excel. You will only be shown a link to the saved traceability matrix.

Exemple of pdf export

...

...

Configure the saved query of the report

If you are using a saved matrix as a template report, that you’ll be able to reuse on different pages, but showing information from different requirements, it is possible to replace the saved query by something else.

  • In the example below, see that the query is key ~ 'BR%' we’ll replace BR by FN, giving you a report based on this query: key ~ 'FN%' .

...

Export your reports in PDF

You can now export your reports in PDF! Simply click on the three dots at the top-right of the page and on export. The dynamic RY Report macro will be visible just like this:

...

Permissions cross spaces

You can insert macros that pull data from an other Confluence space. The report macro uses the permissions of the space where it was saved to display requirements.

...