You can now share your traceability matrices more easily with your coworkers, by inserting them in your Confluence pages.
Insert the macro
In the Confluence page editor: Type
/req
to access the RY macros, and select the RY Report macro
Select the desired saved matrix
How to configure the report display?
If you display external properties in this report, you can make them editable.
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.
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 replaceBR
byFN
, giving you a report based on this query:key ~ 'FN%'
.
⚠️ 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 tick the “Share with everyone in the space” button
🎉 Tada
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..
Changes to the traceability matrix made in the Confluence page are not saved and will be lost when you refresh the page, and are not viewable by your colleagues.
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.
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
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.
As an exemple, if Alice creates a report in space A, and decides to insert it in space B, Bob will not be able to see the results of the report if he doesn’t have the view permission on space A.