Configure Down-stream traceability columns (tasks, risk control measures)

Modified on Mon, 7 Apr at 4:43 PM

This article explains how to configure downstream traceability columns for risk control measures in Risksheet. It covers how to define the structure of tasks linked to risk items, with an emphasis on the configuration file and the various options available for loading and creating new items.

By default, the mitigations section shows the tasks linked to the risk items.

TABLE OF CONTENTS

Configuration
Where to load data from?
Where to create new items?

Configuration

The downstream objects are defined in the "dataTypes" section:

 "dataTypes": {
    "risk": {
      "type": "risk"
    },
    "task": {
      "type": "riskControl",
      "role": "mitigates",
      "name": "Risk Mit. Measure",
      "zoomColumn": "taskTitle"
    }
  },

Then have one column that defines "taskLink" (if the Item is named differently, adjust the term instead of using task)

    {
      "headerGroup": "Risk Control",
      "headerGroupCss": "headMitigations",
      "headerCss": "headMitigations",
      "header": "RC ID",
      "type": "taskLink",
      "id": "task"
    },

The ID of this column is important, as you will refer to it when adding more columns:

{
      "headerGroup": "Risk Control",
      "headerGroupCss": "headMitigations",
      "headerCss": "headMitigations",
      "header": "Risk Control",
      "bindings": "task.title",
      "id": "taskTitle",
      "minWidth": 170
    },

You see above that the bindings use the dot notation to refer to properties of the Task Work Item, where "task" is the id of the taskLink column ID.

Where to load data from?

You can use any combination of query, project, and document to load the items. It is not required to use all three options.

....
      "task": {
      ....
        "document":"Risks/harms",
        "project":"med_library",
        "query":"status:released" 
      }
...

Starting with version 23.7.0, you may even load the items from multiple projects.

...
        "task": {
      ...
          "projects":"RiskFMEA,TestRisk1"

Where to create new items?

Create a new object in the current document

By default, the new items are created in the same place where they are loaded from (see above).
You can force the system to create new items in the current "Risksheet" document using "createInCurrentDocument":true

Creating items with multiple projects

Starting with version 25.3.1, we improved type column handling for cross-project configurations
The 'type' column now consistently displays the Work Item type name, even in cross-project
configurations where type pickers aggregate types from multiple projects
You may choose which project to put the task in and which type of new item will be created in Risksheet
If you don't choose an option, the first project and type in the list will be selected by default.

 ....
   {
      "headerGroup": "Mitigations",
      "headerGroupCss": "headMitigations",
      "headerCss": "headMitigations",
      "header": "Task title",
      "bindings": "task.title",
      "id": "taskTitle",
      "collapseTo": true,
      "minWidth": 170
    },
   
    {
      "headerGroup": "Mitigations",
      "headerGroupCss": "headMitigations",
      "headerCss": "headMitigations",
      "header": "Task project",
      "bindings": "task.project",
      "readOnly":true,
      "minWidth": 170
    },
    {
      "headerGroup": "Mitigations",
      "headerGroupCss": "headMitigations",
      "headerCss": "headMitigations",
      "header": "Type",
      "bindings": "task.type",
      "readOnly": true,
      "minWidth": 170
    },
...
    "task": {
      "type": "task,issue,customTypeTestID",
      "role": "mitigates",
      "name": "Task",
      "zoomColumn": "taskTitle",
      "project": "RiskFMEA,TestRisk1"
    }
...

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

Was this article helpful?