Skip to main content

Step 1: Add the Column Definition

Open risksheet.json and add a column entry with type set to ref:
{
  "columns": [
    {
      "id": "riskAssignee",
      "binding": "assignee",
      "header": "Assignee",
      "type": "ref",
      "width": 140
    }
  ]
}
The ref type renders the column as a user selection dropdown, displaying Polarion user IDs and allowing single-user assignment.

Step 2: Configure User Role Filtering

To restrict which users appear in the dropdown, add a userRole property to control the list of selectable users:
{
  "id": "riskAssignee",
  "binding": "assignee",
  "header": "Assignee",
  "type": "ref",
  "userRole": "project_assignable",
  "width": 140
}
userRole ValueUsers Shown
project_assignableUsers assignable in the current project
(global role name)Users belonging to the specified global role
When mitigation tasks reside in a different project than the Risksheet document, the userRole: "project_assignable" property fetches users from the Risksheet’s project context — not the task’s project. If your tasks are in a separate project, use a global role instead so that users from the target project appear in the dropdown.

Step 3: Add Assignee to Downstream Tasks

To add an assignee column for downstream mitigation tasks rather than the main risk item, nest the column under the task configuration:
{
  "id": "taskAssignee",
  "binding": "task.assignee",
  "header": "Task Assignee",
  "type": "ref",
  "userRole": "project_assignable",
  "width": 140
}
The task. prefix in the binding indicates this column maps to the downstream task work item, not the main risk item. User reference columns are editable by default for main risk items. For upstream linked item columns, you must explicitly set readOnly to false:
{
  "id": "upstreamAssignee",
  "binding": "requirement.assignee",
  "header": "Req. Assignee",
  "type": "ref",
  "readOnly": false,
  "width": 140
}
User reference columns support single-user assignment only. Selecting a new user replaces the previous assignee. The column displays the Polarion user ID of the assigned person.

Verification

Save the configuration and reload your Risksheet. You should now see the Assignee column in the grid. Click on a cell in the column to open the user selection dropdown. Select a user and verify the assignment is saved correctly by refreshing the page.

See Also

KB ArticlesSupport TicketsSource Code
  • risksheet.json
  • GetSetUtil.java
  • TextEditor.ts
  • ConfigureColumnsCommand.ts
  • AppConfig.ts