Table of contents
  • 1. QUICK START GUIDE
  • 2. VISUALISE RISK MATRICES in Confluence
  • 3. VISUALISE RISK TABLE in Confluence
    • 3.1. Sort Risks in the Risk Table in Confluence
  • 4. VISUALISE RISK HISTORY in Confluence
  • 5. BOOK A DEMO
Risk Manager for Confluence User Guide

SoftComply Risk Manager for Confluence is an extension of the SoftComply Risk Manager apps (Risk Manager & Risk Manager Plus) on Jira Cloud to visualize and report risks in Confluence.

With this app you are able to create and customize Risk Reports in Confluence. You can now add the Risk Matrices view and the Risk Table view to your Confluence pages.

This is a free Confluence app – try it out yourself!

1. QUICK START GUIDE

  1. First, install the SoftComply Risk Manager or the SoftComply Risk Manager Plus app (from hereon, Risk Manager) from the Atlassian Marketplace to your Jira instance. This step may require Jira administration permission.
  2. After the successful installation, open the “Risk Manager” or “Risk Manager Plus” app and create a few risks.
  3. Next, install the SoftComply Risk Manager for Confluence app from the Atlassian Marketplace to your Confluence instance. This step requires Confluence admin permission. 
  4. NOTE: If you are using the SoftComply Risk Manager PLUS app, you will need to link the Jira application with the Confluence application. Read more about connecting the two apps here: Connecting Confluence to Jira.

Success! You are now ready to visualise risks on your Confluence pages.

2. VISUALISE RISK MATRICES in Confluence

In the Risk Matrix macro you can select the Risk Project, Matrix type (Initial, Residual or both) and additional risk parameters to be displayed in the macro.

Follow these steps to display the Risk Matrices in Confluence:

  1. First, go to the the edit mode of a Confluence page and add the Risk Matrix macro by typing “/risk matrix report” and then press enter.
  2. Next, go to the edit mode of the Risk Matrix macro and select a risk project from the “select project” dropdown list.
    • Next, select the matrix type to display in the macro from the “Select Which Matrix to Show” dropdown list. You can select between Initial Risk Matrix, Residual Risk Matrix or both to be displayed.
    •  To display the total count of the initial and the residual risks in the macro, please choose it from the “Show Counts in Matrix Cells” radio box.
    • To display the Jira Issue Keys of the  initial and residual risks in the macro, please choose it from the “Show Issue Keys in Matrix Cells” radio box.
    • To display additional risk class information in the macro, please choose the details of your choice from the “Show Risk Class Colours, Names and Descriptions” radio box.
    • To display the information about the risk classification parameters in the macro, please choose the details from the “Show Classifiers Names and Descriptions” radio box.
    • To apply a sub-query filter, enter the JQL in the “JQL Sub Filter” field. For example, project = “DEMO1” <AND JQL Sub Filter> ORDER BY created DESC. Note: Do not type “AND” in the filter box before you start typing your JQL sub-filter.
  3. Publish the page and wait for the macro to load for the Risk Matrix to be displayed on your Confluence page. You can add additional information on the page now to create a compliant Risk Management Plan or Report with the Risk Matrix configuration and risk count already displayed.  

3. VISUALISE RISK TABLE in Confluence

In the Risk Table macro you can select the Risk Project and the number of risks to be displayed in the macro.

Follow these steps to display the Risk Table in Confluence:

  1. First, go to the edit mode of a Confluence page and add the Risk Table macro simply by typing “/risk table report” and then press enter.
  2. Next, go to the edit mode of the Risk Table Macro and select a risk project from the “select project” dropdown list that you would like to display in the macro.
    • You can also enter the number of risks to be displayed in the risk table by specifying a number in the “Page Size” input box.
    • To apply a sub-query filter, enter the JQL in the “JQL Sub Filter” field. For example, project = “DEMO1” <AND JQL Sub Filter> ORDER BY created DESC. Note: Do not type “AND” in the filter box before you start typing your JQL sub-filter.
  3. Publish the page and wait for the table to load. You can add additional information on the page now to create a compliant Risk Management Report with the Risk Table with the risks already displayed.  

3.1. Sort Risks in the Risk Table in Confluence

First, make sure that the Risk Table sorting in Jira (in the SoftComply Risk Manager app) is user-based, i.e. you have enabled the user-based sorting of risks for the Risk Table in the Project Setting page. 

Once the setting has been enabled in Jira, you will be able to sort the risk table in Confluence macro by hovering over the column you wish to sort risks by and then clicking on the column header to sort them.   

4. VISUALISE RISK HISTORY in Confluence

With the Risk History macro you will be able to see a graphical interpretation of the history of up to five individual risks showing how the Risk Class values (Initial and/or Residual) of your selected risks have changed over time.

Follow these steps to display a Risk History on your Confluence page:

  1. First, go to the the edit mode of a Confluence page and add the Risk History macro by typing “/“ followed by the macro name “Risk History Macro” and press enter;
  2. Next, go to the edit mode of the Risk History macro for customising the macro settings. You can select up to 5 risks from the same risk project you want to see the history of, i.e. theie Jira issue keys;
    • You can select from 100 most recently updated risks per project. If you need to see older risks or you have a bigger risk project, please use the text filter to specify search.
  3. Next, select the risk class values you wish to display in the macro – the Initial or the Residual Risk Class values or both.
    • You can change the names for “Initial Risk” and “Residual Risk” using the Alias fields.
    • To display the latest values as today’s in the graph as a dotted line up to today, please choose the option of “Show the latest Risk Class values as today’s values” checkbox.
    • To display Dates as vertical lines on the graph, you can add any dates that you have created in the project (date field type of the Jira issue). Note that only the dates that have value will be displayed in the Risk History graph.
    • To define the Start Date for the Risk History graph, you can choose between the risk creation date and the date when the risk was assigned a risk class value for the very first time. If those are not the dates you want to define as the starting point for the Risk History graph, you can pick one yourself by selecting the “Custom timeframe” option.
    • Finally, to display all the details about the Risk History of your chosen risks in a table below the graph, please check the “Show Data Table” box.
  4. Publish the page and wait for the macro to load for the Risk History to be displayed on your Confluence page. You can add additional information on the page now to create a Risk Report you need.  

5. BOOK A DEMO

For additional resources on SoftComply Risk Manager features, customisation options and practical tips and tricks, please see the SoftComply Knowledge Base for more guidance.

For any questions or to BOOK an ONLINE DEMO CALL of the SoftComply Risk Manager for Confluence, please don’t hesitate to contact us.