Configure Variant Management

​

Use Case

• Filter Risksheet views to show only risks relevant to a specific release
• Link mitigation tasks to the correct product variant
• Maintain separate risk matrices for different configurations while sharing common work items

​

Configure Release Field

​

Create Multi-Enum Field

1. Navigate to Administration > Work Items > Custom Fields
2. Create a new custom field:
   • Field ID: assignedReleases
   • Field Type: Multi-Enum
   • Allowed Values: Release_1.0, Release_2.0, Release_3.0, etc.
3. Apply the field to relevant work item types (Risk, Mitigation, etc.)

​

Add Release Column to Risksheet

{
  "header": "Assigned Releases",
  "bindings": "assignedReleases",
  "type": "multiEnum",
  "minWidth": 180,
  "level": 1
}

​

Filter by Target Release

​

Option 1: Branched Documents (Recommended)

1. Create a baseline for each release (e.g., v1.0-baseline)
2. Branch your Risksheet document from that baseline
3. Each branched document automatically contains only the work items from that release snapshot

​

Option 2: Query Configuration

{
  "query": "assignedReleases:Release_2.0",
  "dataTypes": {
    "risk": {
      "type": "risk",
      "role": "relates_to"
    }
  }
}

/polarion/#/project/MyProject/risksheet?query=assignedReleases:Release_3.0

​

Known Limitations

​

Advanced: Conditional Link Rendering

{
  "header": "Mitigations (Filtered)",
  "bindings": "task.$item",
  "serverRender": "#set($targetRelease = 'Release_2.0')#foreach($task in $item.getLinkedWorkItems())#if($task.getCustomField('assignedReleases').contains($targetRelease))$task.getId() - $task.getTitle()<br/>#end#end"
}

1. Sets $targetRelease to the desired release version
2. Loops through linked work items
3. Checks if assignedReleases contains the target release
4. Renders only matching items

​

Verification

1. Open your Risksheet document
2. You should see the Assigned Releases column showing multi-select enum values
3. If using query filtering, verify that only work items matching the query appear
4. If using branched documents, verify that the branch contains only items from the baseline snapshot

​

See Also

• Branched Documents - Recommended approach for release-based variant management
• Query Configuration - Advanced query filtering techniques
• Multi-Enum Columns - Configuring multi-select enumeration fields
• URL Parameters - Dynamic filtering via URL parameters
• Conditional Linking - Control which items appear in link columns