Skip to main content
Link rendering issues typically manifest in one of these patterns:
SymptomLikely CauseQuick Check
Links display as plain textMissing _link property renderingVerify column type configuration
Links break after cell editSave operation refresh issueCheck refreshOnSave setting
Asterisk prefix appearsNewly created linked itemsExpected behavior until save
HTML tags visible in cellsServer render configuration errorReview serverRender snippet
Support tickets show that link rendering can break intermittently during save operations (approximately once per 15 saves). This often correlates with the refreshOnSave configuration property triggering page reloads that interrupt link rendering state.

​
Fix Plain Text Link Display

​
Step 1: Verify Column Type Configuration

Item link columns require proper type configuration to render as clickable links: 
{
  "columns": [
    {
      "binding": "linkedRequirement",
      "header": "Linked Requirement",
      "type": "itemLink:requirement",
      "width": 200
    }
  ]
}
The system automatically generates the _link property (e.g., linkedRequirement_link) containing HTML-formatted link content.

​
Step 2: Check Server Render Configuration

If you need custom link rendering from rich text fields, use serverRender with proper Velocity syntax: 
{
  "binding": "customLinks",
  "header": "Custom Links",
  "serverRender": "$item.fields().description().render().htmlFor().forFrame()"
}
This extracts and renders HTML links from the description field as clickable hyperlinks.
You can construct custom clickable links using HTML anchor tags in serverRender snippets:
<a href='/polarion/redirect/project/$project/workitem?id=$item.id()' target='_blank'>$item.id()</a>
The target='_blank' attribute opens links in new tabs.

​
Step 1: Disable Automatic Page Refresh

The refreshOnSave configuration property can cause link rendering to break when the page reloads after save operations. Add this to your risksheet.json: 
{
  "gridProperties": {
    "refreshOnSave": false
  }
}
With refreshOnSave disabled, Nextedy RISKSHEET updates the grid in-place without reloading the page, preserving link rendering state.

​
Step 2: Verify Cell Focus Preservation

Version 25.5 introduced a fix for preserving cell selection and scroll position after save. If you’re using an earlier version, update to 25.5 or later to resolve view position loss issues that can affect link interaction. Multi-item link columns display multiple linked work items as a formatted list: Each link shows as a separate <div> element with title tooltip. Items pending creation (ID starting with *) display with asterisk prefix and special CSS class unsaved-item.
Asterisk prefixes on linked items indicate the target item hasn’t been saved to Polarion yet. This is expected behavior and will resolve automatically after you save the parent work item and the linked item is created.

​
Troubleshoot Custom Renderer Issues

If you’ve configured custom cell renderers that manipulate link display:

​
Step 1: Verify Renderer Registration

Custom renderers must be registered in risksheet.cellDecorators: 
risksheet.cellDecorators.customLinkRenderer = function(grid, cell, item, value) {
  // Custom rendering logic
  cell.innerHTML = '<a href="...">' + value + '</a>';
};

​
Step 2: Configure Renderer Binding

Reference the renderer in your column configuration: 
{
  "binding": "linkedItem",
  "cellRenderer": "customLinkRenderer"
}
Custom cell renderers are not applied during comparison mode (when viewing baseline diffs). The system uses default rendering logic to ensure accurate change highlighting.
  1. Save Configuration: Save your risksheet.json configuration changes
  2. Refresh Page: Reload the Nextedy RISKSHEET page completely (Ctrl+F5)
  3. Check Link Display: Item link columns should display as blue underlined hyperlinks
  4. Test Click Behavior: Clicking links should navigate to the target work item
  5. Verify Tooltips: Hovering over multi-item links should show full ID and title tooltips
You should now see properly formatted, clickable links in your item link columns. If links still fail to render after following these steps, check browser console for JavaScript errors and verify that your Polarion user has read permissions for the linked work items.

​
See Also

Support TicketsSource Code
  • ExportToPdf.ts
  • CellPreviewFormatter.ts
  • ExportToExcel.ts
  • RiskSheetContextMenu.ts