Skip to main content

​
Overview

Task link columns are specialized column types that render links to downstream work items associated with each risk item. Common use cases include:
  • Displaying mitigation tasks (risk control measures) linked to FMEA/HARA risks
  • Showing related downstream work items from different projects
  • Creating traceability chains from risks to implementation tasks

​
Column Configuration

NameTypeDefaultDescription
typestringrequiredMust be set to "taskLink" to enable task link rendering. Creates a link column for downstream work items.
idstringrequiredUnique identifier for this column. Used as reference in bindings and dataTypes.task.zoomColumn properties.
headerstringrequiredDisplay text shown in column header (e.g., “Task ID”, “RC ID”, “Mitigation Task”).
headerGroupstringoptionalGroups multiple columns under a single header section (e.g., “Risk Control”, “Mitigations”).
headerCssstringoptionalCSS class for styling the column header cell.
headerGroupCssstringoptionalCSS class for styling the header group section.
widthnumberoptionalFixed column width in pixels. Numeric values are converted automatically.
minWidthnumberoptionalMinimum column width in pixels when resizing.
readOnlybooleantrueTask link columns are read-only by default. Set to false if editing is required (requires configuration in dataTypes).
formatstringoptionalDisplay format string for the linked item ID or title.
sortablebooleantrueWhether column values can be sorted alphabetically.
filterablebooleantrueWhether users can filter the Risksheet by task link values.
collapseTostringoptionalColumn ID to collapse this column into for compact display mode.
canCreatebooleantrueAllows users to create new task items directly from the cell.
showEnumDescriptionbooleanfalseIf task type is enumerated, shows descriptions in dropdown menus.

​
Column Type Definition

Task link columns require "type": "taskLink" in the column configuration: 
{
  "headerGroup": "Risk Control",
  "headerGroupCss": "headMitigations",
  "headerCss": "headMitigations",
  "header": "RC ID",
  "type": "taskLink",
  "id": "task",
  "width": 100
}

​
Data Type Configuration

Task link columns require corresponding dataTypes configuration to define the downstream work item type:
PropertyTypeDefaultDescription
dataTypes.task.typestringrequiredPolarion work item type(s) for downstream items (e.g., "task", "riskControl", or comma-separated multiple types: "task,issue,customType").
dataTypes.task.rolestringrequiredLink role name used when creating relationships (e.g., "mitigates", "relatedTo").
dataTypes.task.namestringoptionalDisplay name for task items shown in menus and UI labels (e.g., “Risk Mit. Measure”, “Mitigation Task”).
dataTypes.task.zoomColumnstringrequiredColumn ID that displays the task item’s title or identifier for zoom operations.
dataTypes.task.showInMenubooleantrueControls whether task creation options appear in context menus.
dataTypes.task.documentstringoptionalDocument folder path and name to load task items from (e.g., "Risks/Tasks", "Requirements/All"). Use full path notation.
dataTypes.task.projectstringoptionalProject ID or comma-separated list of projects to load task items from (e.g., "myProject", "proj1,proj2,proj3").
dataTypes.task.projectsstringoptionalAlias for project - comma-separated list of projects for loading items from multiple projects. Available from version 23.7.0+.
dataTypes.task.querystringoptionalCustom Polarion query to filter which task items are displayed (e.g., "status:released", "severity:high").
dataTypes.task.createInCurrentDocumentbooleanfalseWhen true, new task items are created in the current Risksheet document instead of the default location. Available from version 23.1.0+.
dataTypes.task.createInDocumentstringoptionalSpecifies a target document for newly created task items (e.g., "Risks/Tasks"). Overrides createInCurrentDocument. Available from version 24.8.1+.

​
Data Type Example

"dataTypes": {
  "risk": {
    "type": "risk"
  },
  "task": {
    "type": "riskControl",
    "role": "mitigates",
    "name": "Risk Mit. Measure",
    "zoomColumn": "taskTitle",
    "document": "Risks/mitigations",
    "project": "med_library",
    "query": "status:released"
  }
}
Once a task link column is defined with id: "task", other columns can display task properties using dot notation:
BindingTypeDescription
task.titlestringTask item title or name field.
task.statusstringCurrent workflow status of the task.
task.idstringUnique identifier of the task work item.
task.severityenumSeverity rating or custom enum field from task.
task.typestringWork item type ID of the task.
task.projectstringProject ID where the task is stored.
task.dueDatedateDue date or target completion date for the task.
task.assigneestringUser assigned to the task.
task.<customField>anyAny custom field defined on the task work item type.

​
Display Task Properties Example

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

​
Multi-Project Task Loading

Starting with version 23.7.0, task items can be loaded from multiple projects: 
"dataTypes": {
  "task": {
    "type": "task,issue,customTypeTestID",
    "role": "mitigates",
    "name": "Mitigation",
    "zoomColumn": "taskTitle",
    "projects": "RiskFMEA,TestRisk1"
  }
}
Separate multiple project IDs with commas. When creating new task items in multi-project configurations, users can select which project to use via a project type picker.

​
Task Item Creation

​
Create in Current Document

New task items are created in the current Risksheet document: 
"dataTypes": {
  "task": {
    "type": "task",
    "role": "mitigates",
    "name": "Task",
    "zoomColumn": "taskTitle",
    "createInCurrentDocument": true
  }
}
Available from version 23.1.0+.

​
Create in Specified Document

New task items are created in a specific target document: 
"dataTypes": {
  "task": {
    "type": "task",
    "role": "mitigates",
    "name": "Task",
    "zoomColumn": "taskTitle",
    "createInDocument": "Risks/Tasks"
  }
}
Available from version 24.8.1+. This property takes precedence over createInCurrentDocument.

​
Cross-Project Type Configuration

When loading task items from multiple projects with different work item types, configure both projects and types: 
"dataTypes": {
  "task": {
    "type": "task,issue,riskControl",
    "role": "mitigates",
    "name": "Mitigation",
    "zoomColumn": "taskTitle",
    "project": "RiskFMEA,TestRisk1"
  }
}
Available from version 25.3.1+. The system displays the work item type name in type columns even when types are aggregated from multiple projects. Users can select which project and type to use when creating new items.
When no explicit selection is made, the first project and type in the list are selected by default.

​
Context Menu Integration

Task link columns integrate with the Risksheet context menu. Users can:
  • Open Task Item - Right-click a task link to open the linked work item in Polarion
  • New Task - Create new task items directly from the context menu (if showInMenu: true)
  • Remove Task - Unlink a task from the current risk item (removes the relationship, does not delete the task)
Menu labels use the dataTypes.task.name property for display.

​
Property Display and Sorting

Columns displaying task properties (via bindings: "task.<property>") inherit standard column behavior:
  • Sortable - Rows can be sorted by task property values
  • Filterable - Users can filter by task property values
  • Read-Only - Most task property columns are read-only unless explicitly configured
  • Formatting - Values are formatted according to their data type (dates, enums, etc.)

​
Configuration Properties Summary

Use CaseConfiguration KeyValueNotes
Set column header textheaderstringDisplay name in grid header
Set task column IDidstringUsed in bindings: task.*
Set task typedataTypes.task.typestring or comma-separatedSupports single or multiple types
Set link roledataTypes.task.rolestringRole name used for linking
Set task display namedataTypes.task.namestringLabel shown in menus and UI
Load from specific documentdataTypes.task.documentstringFull path: "Folder/Document"
Load from specific projectdataTypes.task.projectstring or comma-separatedSingle or multiple projects
Filter tasks by querydataTypes.task.querystringPolarion query syntax
Create in current documentdataTypes.task.createInCurrentDocumentbooleanVersion 23.1.0+
Create in target documentdataTypes.task.createInDocumentstringVersion 24.8.1+
Display task titlebindings"task.title"Shows task name in column
Display task statusbindings"task.status"Shows workflow status
Display task typebindings"task.type"Shows work item type (version 25.3.1+ for multi-project)
Task link columns are always read-only for display purposes. To modify the task links themselves, users must create/remove them through the context menu or separate task management interfaces. The relationship is managed through the role property in the configuration.
Use minWidth property to ensure task property columns (title, status, etc.) have sufficient width for readable content. Typical widths: ID columns 80-100px, title columns 170-250px, status columns 100-120px.
KB ArticlesSupport TicketsSource Code
  • SheetConstants.ts
  • RemoveTaskCommand.ts
  • RiskSheetContextMenu.ts
  • CellEditorFormatter.ts
  • RisksheetViewServlet.java