Configuration Properties Index

Properties are organized by functional area. Use your browser’s search function (Ctrl+F / Cmd+F) to find specific properties. Many properties support PolarionExpressionEvaluator syntax for dynamic values—these are marked with 🔄.

Global Settings

Property	Type	Default	Description
`global.culture`	string	`en`	Localization culture code (e.g., `en-US`, `de-DE`) for interface language
`global.help`	string	`null`	URL or path to custom help documentation for this configuration
`global.refreshOnSave`	boolean	`false`	Automatically refresh risksheet after saving changes
`global.addAsSubmenu`	boolean	`false`	Display RISKSHEET as submenu item in Polarion navigation
`global.suggestTextFields`	boolean	`true`	Enable autocomplete suggester for text field columns

Suggester Configuration

The suggester provides autocomplete suggestions for text fields based on previous values in other risk documents.

Property	Type	Default	Description
`global.isSuggesterFuzzySearching`	boolean	`true`	Enable fuzzy/similarity search to find similar words
`global.isSuggesterWildcardSearching`	boolean	`true`	Enable wildcard searching for incomplete words (e.g., “risk*” finds “risksheet”)
`global.isSuggesterKeywordsMandatory`	boolean	`false`	Require all keywords to match (`true`) or find best match even with missing keywords (`false`)
`global.isSearchAllFieldsWhenSearchingLinkedItems`	boolean	`false`	Search all work item fields (not just ID/title) when searching in itemLink columns

Suggester Example

With default settings, searching for “risk mitigation” will:

Find similar words: “risk” matches “risks”, “mitigating” matches “mitigation”
Allow partial words: “mit” finds “mitigation”
Use OR logic: finds results with “risk” OR “mitigation” (not both required)

Risk and Task Configuration

Define work item types and linking behavior for risks and mitigation tasks.

Risk Item Types 🔄

Property	Type	Default	Description
`dataTypes.risk.type`	string	`risk`	Work item type ID for risk items (comma-separated for multiple types)
`dataTypes.risk.role`	string	`relates_to`	Link role when creating risk relationships
`dataTypes.risk.name`	string	`Risk`	Display name for risk items in UI
`dataTypes.risk.zoomColumn`	string	`null`	Column ID that identifies risks for zoom/focus operations
`dataTypes.risk.showInMenu`	boolean	`true`	Show risk creation option in navigation menu
`dataTypes.risk.removeStrategy`	string	`delete`	Strategy for removing risks: `delete` (permanent) or other custom method
`dataTypes.risk.rejectedAction`	string	`reject`	Workflow action to execute when risk is rejected during review
`dataTypes.risk.rejectedStatus`	string	`rejected`	Status value to set for rejected risks
`dataTypes.risk.rejectedResolution`	string	`invalid`	Resolution value to set for rejected risks

Task/Mitigation Item Types 🔄

Property	Type	Default	Description
`dataTypes.task.type`	string	`task`	Work item type ID for task/mitigation items (comma-separated for multiple types)
`dataTypes.task.role`	string	`relates_to`	Link role when creating task relationships
`dataTypes.task.name`	string	`Task`	Display name for task items in UI
`dataTypes.task.zoomColumn`	string	`null`	Column ID that identifies tasks for zoom/focus operations
`dataTypes.task.showInMenu`	boolean	`true`	Show task creation option in navigation menu

Example: Multiple Risk Types

{
  "dataTypes": {
    "risk": {
      "type": "hazard,failure",
      "name": "Risk Item"
    }
  }
}

Hierarchical Levels

Organize work items into collapsible hierarchies.

Property	Type	Default	Description
`levels[].name`	string	`Level {N}`	Display name for this hierarchical level
`levels[].controlColumn`	string	`systemItemId`	Column ID that controls expand/collapse behavior
`levels[].zoomColumn`	string	`null`	Column ID for identifying items at this level
`levels[].showInMenu`	boolean	`true`	Display this level in navigation menu

Example: Risk Categories

{
  "levels": [
    {
      "name": "Risk Category",
      "controlColumn": "category",
      "showInMenu": true
    },
    {
      "name": "Individual Risks",
      "controlColumn": "systemItemId",
      "showInMenu": false
    }
  ]
}

Column Properties

Column Definition 🔄

Property	Type	Default	Description
`columns[].id`	string	auto-generated	Unique column identifier (auto-generated from header/binding if not specified)
`columns[].header`	string	required	Display text for column header
`columns[].binding`	string	column.id	Data binding path for values
`columns[].type`	string	auto-detected	Column data type: `string`, `int`, `float`, `enum:{enumId}`, `workflow`, `itemLink`, `taskLink`, `multiItemLink`, `multiEnum:{enumId}`, `date`, `datetime`, `time`, `boolean`, `currency`, `calculated`
`columns[].level`	number	`1`	Hierarchical level (1=top level, 2=second, etc.)
`columns[].width`	number/string	`null`	Column width in pixels or star notation (e.g., “2*“)
`columns[].minWidth`	number	`null`	Minimum column width in pixels
`columns[].readOnly`	boolean	`false`	Make column non-editable
`columns[].canCreate`	boolean	`true`	Allow creating new items from itemLink/multiItemLink cells
`columns[].filterable`	boolean	`true`	Allow filtering by this column’s values
`columns[].format`	string	`null`	Format string for display (e.g., `#,##0.00` for currency)
`columns[].formula`	string	`null`	Client-side calculation formula (auto-sets readOnly=true)
`columns[].serverRender`	string	`null`	Server-side rendering script (auto-sets type=string, readOnly=true)
`columns[].cellRenderer`	string	`null`	Custom cell renderer identifier
`columns[].cellCss`	string	`null`	CSS class for cell styling
`columns[].headerGroup`	string	`null`	Group header text for column grouping
`columns[].collapseTo`	string	`null`	Collapse this column into another column ID
`columns[].multiLine`	boolean	`true`	Use textarea instead of single-line input for editing
`columns[].wordWrap`	boolean	`true`	Wrap text within cells
`columns[].showEnumDescription`	boolean	`false`	Show enum option descriptions in dropdown
`columns[].headerTooltip`	string	`null`	Tooltip text displayed on header hover

Column Type Examples

{
  "columns": [
    {
      "header": "Severity",
      "binding": "severity",
      "type": "enum:severityRating",
      "readOnly": false
    },
    {
      "header": "Risk Priority",
      "binding": "priority",
      "type": "calculated",
      "formula": "severity * occurrence"
    },
    {
      "header": "Related Requirement",
      "binding": "relatedReq",
      "type": "itemLink",
      "canCreate": true
    }
  ]
}

Header Configuration

Property	Type	Default	Description
`headers.rowHeader.width`	number	`90`	Width of row header column in pixels
`headers.rowHeader.renderer`	string	`null`	Custom renderer for row header cells
`headers.columnHeader.height`	number	`null`	Height of column header row in pixels
`headers.columnGroupHeader.height`	number	`null`	Height of column group header row in pixels

Review Management

Property	Type	Default	Description
`reviews.reviewManager`	string	`null`	Review type: `CommentBased`, `ApprovalBased`, or `WorkItemBased`
`reviews.typeProperties.linkTypes`	string	`null`	Link types for review items (WorkItemBased only)
`reviews.typeProperties.linkRole`	string	`null`	Link role for review relationships (WorkItemBased only)
`reviews.typeProperties.query`	string	`null`	Query to filter review items (WorkItemBased only)
`reviews.typeProperties.document`	string	`null`	Document path for creating/loading reviews (WorkItemBased only)
`reviews.typeProperties.project`	string	`null`	Project ID for reviews (WorkItemBased only, supports PolarionExpressionEvaluator)
`reviews.typeProperties.itemTemplate`	string	`null`	Velocity template for rendering reviews (WorkItemBased only)

Project-Level Configuration Properties

These settings are configured via Project Administration > Configuration Properties and apply to all risksheets in the project.

Property	Type	Default	Description
`nextedy.risksheet.riskDocumentType`	string	`riskSpecification`	Document type(s) representing risk analysis
`nextedy.risksheet.risksheetTemplatePath`	string	`Risks/Risk Specification`	Path to template document for creating new risk analyses
`nextedy.risksheet.upstreamSubColumnsReadonly`	boolean	`true`	Make upstream property columns read-only
`nextedy.risksheet.checkPrototypePermissions`	boolean	`true`	Check work item permissions (disable for custom permissions)
`nextedy.risksheet.branchingSupport`	boolean	`false`	Enable support for Polarion branched documents
`nextedy.risksheet.disable_admin_check`	boolean	`false`	Restrict Configure action to project administrators only
`nextedy.risksheet.editableReferencedWorkItems`	boolean	`false`	Allow editing referenced items on branched risksheets
`nextedy.risksheet.upstreamChains`	string	`null`	Enable extra chains between upstream items (e.g., `harm-relates_to-hazard`)
`nextedy.risksheet.checkInstanceFieldPermissions`	boolean	`false`	Enable field-level access control (beta)
`nextedy.risksheet.checkLinkRoleCompliance`	boolean	`false`	Support multiple link roles for the same column (v24.2.2+)
`nextedy.risksheet.downstreamFromRevision`	boolean	`false`	Freeze downstream items at baseline revision
`nextedy.risksheet.moduleOnlyPermissions`	boolean	`false`	Skip item-level permission checks for large risksheets (v24.8.5+)
`nextedy.risksheet.loadTasksFromDocument`	boolean	`false`	Load tasks only from specific document (v23.8.3+)
`nextedy.risksheet.includeProjectBaselines`	boolean	`false`	Load project baselines for comparison (v24.2.0+)

Configuration Lookup Diagram

Config not taking effect?

Verify risksheet.json is attached to the correct document (check hierarchy diagram above)
Confirm JSON syntax is valid (use Configuration Editor to validate)
Check if document-specific config is overriding your template settings
Refresh the browser cache (Ctrl+Shift+R or Cmd+Shift+R)

Unexpected values?

Properties that support PolarionExpressionEvaluator (marked 🔄) use dynamic values—check the expression
Verify no document-level config override exists
Check if Polarion custom fields are affecting the value

Getting Started

Concepts

Reference

Guides

Troubleshooting

FAQ

Global Settings

Suggester Configuration

Suggester Example

Risk and Task Configuration

Risk Item Types 🔄

Task/Mitigation Item Types 🔄

Example: Multiple Risk Types

Hierarchical Levels

Example: Risk Categories

Column Properties

Column Definition 🔄

Column Type Examples

Header Configuration

Review Management

Project-Level Configuration Properties

Configuration Lookup Diagram

See Also

Getting Started

Concepts

Reference

Guides

Troubleshooting

FAQ

​Global Settings

​Suggester Configuration

​Suggester Example

​Risk and Task Configuration

​Risk Item Types 🔄

​Task/Mitigation Item Types 🔄

​Example: Multiple Risk Types

​Hierarchical Levels

​Example: Risk Categories

​Column Properties

​Column Definition 🔄

​Column Type Examples

​Header Configuration

​Review Management

​Project-Level Configuration Properties

​Configuration Lookup Diagram

​See Also

Global Settings

Suggester Configuration

Suggester Example

Risk and Task Configuration

Risk Item Types 🔄

Task/Mitigation Item Types 🔄

Example: Multiple Risk Types

Hierarchical Levels

Example: Risk Categories

Column Properties

Column Definition 🔄

Column Type Examples

Header Configuration

Review Management

Project-Level Configuration Properties

Configuration Lookup Diagram

See Also