What Work Items are visible on the Risksheet and understanding levels

Modified on Mon, 22 Sep at 3:53 PM

This article explains how to configure and interpret the Risksheet.


What Work Items are visible on the Risksheet is based on two main configurations:

  1. The Levels configuration – how data is visually grouped and merged

  2. The Data Types configuration – which types of work items are shown and how they’re linked


TABLE OF CONTENTS


Levels

The Level 1 and Level 2  (or more) columns are connected to a single work item, by default, the Risk Item.

Even though it looks like the Level 2 items are children of Level 1 items - because the table looks like Cause is a child of Failure Mode - in reality, this is achieved by merging the Level 1 columns.


The Last Level +1 (e.g., 3) columns are connected to a downstream / child items (typically tasks).


Example configuration

  "levels": [
    {
      "name": "Failure mode",
      "controlColumn": "failureMode",
      "zoomColumn": "failureMode"
    },
    {
      "name": "Cause",
      "zoomColumn": "causes",
      "controlColumn": "systemItemId"
    }


Level 1 columns shall be merged according to a column "failureMode" (See the "controlColumn" property).


This means that:

  • The Failure mode column (controlColumn) will be merged, i.e., all the risk items that have the same "failure mode" value will be grouped together, and cells will be merged
  • All the additional Level 3 columns - e.g. Severity - will be merged as well, supposing the values are the same, which should be the case (based on FMEA standard)


  • The last level column shall be merged according to the system column "systemItemId", which holds the risk work item id. 
    • This effectively means that the last level columns shall not be merged at all
  • The last level +1 columns are not merged at all as well.


In addition to that, you can see two other properties:

  • The "zoomColumn" defines in which column a highlighted cell will appear.
    • For example, adding a new Failure mode will create a new row and highlight the cell Failure Mode
  • The "name" property holds the label that should be visible in the toolbar + Failure Mode, + Effects, etc.
    • In this example, it would be + Failure Mode, + Cause, ...



Data Types


You can see above that the "levels" configuration does not define what work item types represent "Risk" or "Task" work items. This is defined in the dataTypes section.


Here, there are just two sections:

  • The first "risk" section is connected to Level 1 and Level 2 columns
  • The second "task" section defines the Last Level +1 (in this case, Level 3) column item type
  "dataTypes": {
    "risk": {
      "type": "risk"
    },
    "task": {
      "type": "task",
      "role": "mitigates",
      "name": "Task",
      "zoomColumn": "taskTitle"
    }
  },

To configure what work item type is a risk item, change the type property of the "risk" section.


To configure what work item type shall represent the downstream objects (usually tasks), configure the type property of the "task" section.


As you can see, you can also set the role property to configure the work item link role used between "task" and "risk".




For any assistance, please don’t hesitate to reach out by submitting a ticket here.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article