Skip to main content

​
Prerequisites

  • Access to the RISKSHEET configuration file (risksheet.json)
  • Understanding of your project’s user roles in Polarion
  • Basic familiarity with column configuration syntax

​
Configuration Steps

​
1. Locate the Column Configuration Section

Open your risksheet.json file and find the columns array where you want to add the assignee column.

​
2. Add the Assignee Column Definition

For a risk item assignee column, add this configuration: 
{
  "headerGroup": "Risk Details",
  "headerGroupCss": "headRiskDetails",
  "headerCss": "headRiskDetails",
  "header": "Assignee",
  "bindings": "assignee",
  "id": "riskAssignee",
  "type": "ref:user",
  "typeProperties": {
    "userRole": "project_assignable"
  },
  "width": 100
}
For a mitigation task assignee column, use this configuration: 
{
  "headerGroup": "Mitigations",
  "headerGroupCss": "headMitigations",
  "headerCss": "headMitigations",
  "header": "Assignee",
  "bindings": "task.assignee",
  "id": "taskAssignee",
  "type": "ref:user",
  "typeProperties": {
    "userRole": "project_assignable"
  },
  "width": 100
}

​
3. Understanding the Configuration

PropertyPurpose
bindings"assignee" for risk items, "task.assignee" for tasks, or "ITEMID.assignee" for other linked items
type"ref:user" designates this as a user reference column
typeProperties.userRoleFilters assignee options to users with the specified role (typically "project_assignable")
idUnique identifier for this column
widthColumn width in pixels
The userRole property filters users based on role membership. For multi-project setups, consider using a global role instead of project-specific roles to ensure consistent assignee options across projects. Project-local role filtering is currently limited.
Currently, assignee filtering works best with global roles. If you specify a project-local role like project_assignable, users from other projects with that role may still appear in the dropdown. This is a known limitation. As a workaround, create a global role for assignable users across all relevant projects.

​
4. Save and Reload

After adding the column configuration:
  1. Save the risksheet.json file
  2. Reload your RISKSHEET document in Polarion
  3. The new assignee column will appear in the configured position

​
Verification

You should now see:
  • An Assignee column in your RISKSHEET
  • A dropdown selector when you click any cell in the column
  • A filtered list of users based on the project_assignable role (or your specified role)
  • The ability to assign and reassign responsibility for items

​
Common Use Cases

diagram You can configure multiple assignee columns for different levels of your hierarchy:
  • Risk-level assignee: Person responsible for managing the risk
  • Task-level assignee: Person implementing the mitigation action
  • Downstream item assignee: Using "ITEMID.assignee" syntax for other linked work items

​
See Also

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