Display Sub-Columns

​

Standard Sub-Columns with Dot Notation

{
  "header": "Harm Severity",
  "bindings": "harm.harmSeverity",
  "type": "enum:harm_severity_5",
  "width": 110,
  "filterable": true,
  "level": 3,
  "id": "severity"
}

• Upstream links — harm.severity (item linked to current row)
• Downstream links — task.status (task item linked from current row)

​

Sub-Columns for Multi-Item Links

​

Upstream Multi-Item Sub-Columns

{
  "header": "Severity",
  "width": 120,
  "serverRender": "<ol style='margin-block-start: -16px;margin-block-end: -16px;padding-inline-start: 16px;'>#foreach($linkedWorkItem in $item.fields().linkedWorkItems()) #set($sysReq = $linkedWorkItem.fields().workItem().get()) #set($typeId = $sysReq.fields().type().get().id()) #if($typeId.equals(\"systemrequirement\")) <li> $sysReq.fields().severity().render().withIcon(true).htmlFor().forFrame() </li>  #end #end</ol>"
}

​

Downstream Multi-Item Sub-Columns

{
  "header": "Issue Severity",
  "width": 120,
  "serverRender": "<ol style='margin-block-start: -16px;margin-block-end: -16px;padding-inline-start: 16px;'>#foreach($issueWi in $item.transaction().workItems().search().query(\"type:issue AND linkedWorkItems:${item.getReference().projectId()}/${item.getReference().id()}\").sort(\"id\")) <li> $issueWi.fields().severity().render().withIcon(true).htmlFor().forFrame() </li>   #end</ol>"
}

​

Sub-Column Configuration Workflow

​

Understanding the ServerRender Template

1. Iterates through linked items using #foreach
2. Filters by work item type using #if($typeId.equals("..."))
3. Renders each field value as a list item <li>
4. Formats output with inline CSS to control margins and padding

​

Key Velocity Methods for Sub-Columns

• $item.fields().linkedWorkItems() — Get all upstream linked items
• $linkedWorkItem.fields().workItem().get() — Get the actual work item object
• $sysReq.fields().type().get().id() — Get work item type ID for filtering
• $sysReq.fields().severity().render() — Render field value with Polarion formatting
• .withIcon(true) — Include field type icon in rendering
• .htmlFor().forFrame() — Format for RISKSHEET display

• $item.transaction().workItems().search().query("...") — Query downstream items
• type:issue AND linkedWorkItems:${item.getReference()} — Find items linking to current row
• .sort("id") — Sort results by work item ID

​

Inline Display Alternative

"typeProperties": {
  "itemTemplate": "<span>$item.fields().title().render().htmlFor().forFrame()</span><span style=\"color:#666;font-size:0.9em;\">[S:$item.fields().severity().render().htmlFor().forFrame()]</span>"
}

​

Verification

1. Save your risksheet.json configuration
2. Refresh the RISKSHEET widget
3. For dot notation sub-columns: You should see a separate column displaying the linked item property with the same data type as the source field
4. For serverRender sub-columns: You should see a read-only column displaying a formatted list of values from all linked items, sorted by ID

​

See Also

• Enable Editing of Upstream Columns — Make dot notation sub-columns editable
• Configure Upstream Traceability Columns — Set up upstream item links
• Configure Downstream Traceability Columns — Set up downstream task links
• Show Multiple Linked Items — Configure multiItemLink columns
• Render Custom Data — Complete serverRender guide
• Customize Link Rendering — Inline property display with links
• Server Render Columns — Column type reference
• Velocity Templates — Complete Velocity syntax reference