Skip to main content

Binding Path Syntax

Binding paths specify which work item fields appear in columns. The binding syntax varies by work item type and hierarchy level.
Binding PatternTypeDescriptionExample
fieldIdMaster fieldDirect field access on risk itemtitle, description, customField1
task.fieldIdTask-level fieldField access on linked mitigation tasktask.title, task.status
task.link.roleTask link roleName of the link relationship between risk and tasktask.link.mitigates
task.assigneeTask assigneeUser assigned to the mitigation tasktask.assignee
upstream.fieldIdUpstream linkField from upstream-linked work itemupstream.requirement
downstream.fieldIdDownstream linkField from downstream-linked work itemdownstream.issue

Master-Level Field Access

Master-level bindings access fields directly on the risk item without any prefix.
Field CategoryBindingData TypeRead-OnlyNotes
IdentifiersidStringYesUnique work item identifier
IdentifierskeyStringYesDeprecated; use id
ContenttitleStringNoWork item title/summary
ContentdescriptionTextNoRich text description field
ContentlongDescriptionTextNoExtended description field
StatusstatusEnumNoCurrent workflow status
StatusresolutionEnumYesResolution enumeration
StatustypeEnumYesWork item type (risk, task, issue, etc.)
MetadataauthorUserYesUser who created the item
MetadatacreatedDateTimeYesCreation timestamp
MetadataupdatedDateTimeYesLast modification timestamp
MetadataobsoleteBooleanNoMarks item as obsolete/archived
CustomcustomField[N]VariableNoCustom project fields (1-indexed)

Task-Level Field Access

Task-level bindings require the task. prefix and access fields on linked mitigation items.
BindingData TypeDescriptionConfiguration
task.idStringIdentifier of the linked taskRead-only
task.titleStringTitle of the linked taskEditable
task.statusEnumCurrent status of the taskEditable
task.typeEnumWork item type of the taskRead-only after creation
task.assigneeUserUser assigned to the taskEditable
task.priorityEnumPriority level of the taskEditable
task.dueDateDateDue date for task completionEditable
task.effortIntEstimated effort in work unitsEditable

Upstream and Downstream Field Access

Upstream bindings reference fields on work items that link TO the current risk. Downstream bindings reference fields on work items that the risk links TO.

Upstream Pattern

upstream.bindingPath
Used for traceability columns showing requirements or parent items.
BindingMeaningExample
upstream.idID of upstream-linked itemView requirement identifier
upstream.titleTitle of upstream-linked itemShow requirement title
upstream.statusStatus of upstream itemDisplay requirement status

Downstream Pattern

downstream.bindingPath
Used for traceability columns showing derived tasks or test cases.
BindingMeaningExample
downstream.idID of downstream-linked itemView verification task
downstream.titleTitle of downstream itemShow test case name
downstream.resultCustom field on downstream itemDisplay test result

Hierarchical Level Binding

RISKSHEET supports multi-level hierarchies where different columns appear at different levels.
{
  "level": 1,
  "bindings": "title"
}
PropertyTypeDefaultPurpose
levelNumber1Which hierarchy level (1=top, 2=sub-item, etc.)
bindingsStringNoneField binding path for this level

Field Type Inference

When no explicit type is specified, RISKSHEET infers the column type from the Polarion field definition.
Polarion Field TypeRISKSHEET Column Type
Texttext
TextMultiLinetext (multiLine: true)
Enumerationenum:enumId
Referenceref:refId
Datedate
DateTimedatetime
Integerint
Floating Pointfloat
Booleanboolean

Binding Validation

Binding paths are validated at load time. Invalid bindings result in configuration warnings.

Valid Binding Examples

{
  "header": "Risk Title",
  "bindings": "title",
  "type": "text"
}
{
  "header": "Mitigation Status",
  "bindings": "task.status",
  "type": "enum:workflowStatus"
}
{
  "header": "Requirement",
  "bindings": "upstream.title",
  "readOnly": true
}

Multi-Binding Columns

Some column types support multiple bindings to display data from different sources.
Column TypeBinding PatternPurpose
Multi-Enumfield1,field2Combine multiple enum fields
Consolidated Linkupstream.id|downstream.idShow both upstream and downstream links
Calculatedfield1+field2Formula-based calculation

System Field Binding

System fields are read-only Polarion fields that cannot be modified through RISKSHEET.
Bindings to author, created, updated, type, and resolution create read-only columns. These fields are protected by Polarion and cannot be edited through the grid interface.
{
  "header": "Created By",
  "bindings": "author",
  "readOnly": true
}

Binding Path Resolution Flow

diagram

Binding Prefix Matching

When configuring dependent enumerations or relationship rules, binding prefixes must match. Master fields cannot have relationships with task fields.
Relationship mappings require both ‘from’ and ‘to’ columns to use the same binding prefix (both master-level or both task-level). Cross-level relationships are not supported.
Valid RelationshipInvalid RelationshipReason
categorytype (both master)categorytask.typeDifferent levels
task.prioritytask.effort (both task)prioritytask.effortMixed levels

Reference to Available Pages

For detailed information about specific field types and how they behave in columns, see:
Source Code
  • AppConfigParser.ts
  • RelationActionController.ts
  • AppConfigHelper.ts