Skip to main content

​
Why Upstream Columns Are Read-Only by Default

By default, upstream sub-columns (columns showing linked item properties) are marked as read-only to prevent unintended changes:
  • Linked items are referenced in multiple places across Polarion
  • Users may not realize that editing these values affects other work items and documents
  • Changes to upstream items can impact traceability and compliance requirements
diagram

​
Enable Editing for Individual Columns

To allow editing of a specific upstream column, add the readOnly property set to false in your column configuration: 
{
  "headerGroup": "Potential risks",
  "headerGroupCss": "headPotentialRisks",
  "headerCss": "headPotentialRisks",
  "header": "Harm Severity",
  "bindings": "harm.harmSeverity",
  "type": "enum:harm_severity_5",
  "width": 110,
  "readOnly": false,
  "filterable": true,
  "level": 3,
  "id": "severity"
}
The property must be written as readOnly (camelCase), not readonly (lowercase). Using incorrect casing will cause the configuration to be ignored, and the column will remain read-only.
After applying this configuration, users can edit the upstream column values directly in the Risksheet. Changes are saved to the linked work item and reflected everywhere that item appears.

​
Change the Global Default Behavior

To make all upstream columns editable by default across your entire Polarion instance:
  1. Navigate to Administration → Configuration Properties
  2. Add or modify the following property:
nextedy.risksheet.upstreamSubColumnsReadonly=false
  1. Save the configuration
  2. Restart Polarion or reload the Risksheet widget
You can set the global property to false to make all upstream columns editable by default, then use "readOnly": true on specific columns to selectively restrict editing.

​
Configuration for Date Fields

When enabling editing for upstream date columns, ensure proper type configuration: 
{
  "header": "Target Date",
  "bindings": "requirement.dueDate",
  "type": "date",
  "format": "yyyy-MM-dd",
  "readOnly": false,
  "level": 2,
  "id": "targetDate"
}
The date format must match Polarion’s expected date format for the field type.

​
Verification

After configuring editable upstream columns, verify the behavior:
  1. Open a Risksheet with upstream traceability columns
  2. Click on a cell in the configured upstream column
  3. You should now see an editable field instead of read-only text
  4. Modify the value and save the Risksheet
  5. Navigate to the linked work item in Polarion to confirm the change was applied

​
See Also

KB ArticlesSupport TicketsSource Code
  • RisksheetProjectProperties.java
  • CellPreviewFormatter.ts
  • PolarionAppConfigManager.java
  • TextEditor.ts
  • AppConfig.ts