Default Configuration Values - Nextedy Documentation

Top-Level Properties

Property	Type	Default	Description
`columns`	`array`	`[]`	Column definitions for the grid. An empty array results in no visible data columns.
`dataTypes`	`object`	`{}`	Risk and task data type configuration including work item types, link roles, and menu visibility.
`readonly`	`boolean`	`false`	Makes the entire grid read-only. Automatically forced to `true` when viewing a historical revision.
`levels`	`array`	`[]`	Hierarchical level definitions with control columns for zoom navigation.
`headers`	`object`	`{}`	Row header and column header sizing and rendering configuration.
`formulas`	`object`	`{}`	Named JavaScript formula definitions referenced by column `formula` properties.
`styles`	`object`	`{}`	Named CSS class definitions for conditional cell formatting.
`cellDecorators`	`object`	`{}`	Named JavaScript functions that apply conditional CSS classes to cells.
`enums`	`object`	`{}`	Enumeration option definitions for `enum` and `multiEnum` column types.
`ratings`	`object`	`{}`	Rating scale definitions for `rating` column types. Structurally identical to `enums`.
`relations`	`array`	`[]`	Dependent enum relationships for cascading selections between columns.
`views`	`array`	`[]`	Saved column visibility presets.
`global`	`object`	`{}`	Global settings including culture/locale, help URL, and menu organization.
`reviews`	`object`	`{}`	Review workflow configuration.
`sortBy`	`array`	`[]`	Default sort order. Column IDs with optional tilde prefix for descending.
`canAdmin`	`boolean`	`false`	Whether the current user has admin privileges. Set at runtime, not in configuration.
`reviewer`	`boolean`	`false`	Enables reviewer mode with restricted editing and review-specific UI.
`downstreamReadonly`	`boolean`	`false`	Makes downstream linked items read-only.
`source`	`string`	`null`	Path to configuration source file. Set at runtime.
`templateName`	`string`	`null`	Name of the template when config is loaded from a global template.

Column Property Defaults

When a column entry in the columns array omits optional properties, these defaults apply:

Property	Type	Default	Description
`id`	`string`	Auto-generated from `header` or `binding`	Unique column identifier. If omitted, generated from the header text or binding name.
`type`	`string`	Auto-detected from Polarion field type	Column data type. Inferred from the bound Polarion field when not specified.
`level`	`number`	`1`	Hierarchical level. Defaults to top level. Not set for task-level columns.
`readOnly`	`boolean`	`false`	Editability. Automatically set to `true` for formula columns, server-rendered columns, reference columns, and protected system fields.
`filterable`	`boolean`	`true`	Whether column values can be filtered.
`canCreate`	`boolean`	`true`	For `itemLink` and `multiItemLink` columns, allows creation of new linked items.
`formula`	`string`	None	No formula. When set, column becomes read-only.
`serverRender`	`string`	None	No server render script. When set, column becomes `text` type and read-only.
`multiLine`	`boolean`	`true`	Multi-line editing enabled by default.
`wordWrap`	`boolean`	`true`	Word wrap enabled by default.

When you omit the type property, Risksheet queries the Polarion field definition and maps it to the corresponding column type. For example, a Polarion Integer field becomes int, a Date field becomes date, and a native Enum field becomes enum. See Data Types for the complete mapping.

Levels Property Defaults

Each entry in the levels array receives these defaults when properties are omitted:

Property	Type	Default	Description
`showInMenu`	`boolean`	`true`	Level appears in the row creation menu.
`controlColumn`	`string`	`systemItemId`	Column that controls hierarchy navigation and zoom for this level.

{
  "levels": [
    {
      "showInMenu": true,
      "controlColumn": "systemItemId"
    },
    {
      "showInMenu": true,
      "controlColumn": "systemItemId"
    }
  ]
}

See Levels Configuration for detailed level hierarchy setup.

DataTypes Property Defaults

The dataTypes object configures risk and task work item types. Each data type entry has its own defaults:

Risk Data Type Defaults

Property	Type	Default	Description
`dataTypes.risk.type`	`string`	None (required)	Polarion work item type ID for risk items. Evaluated through expression evaluator for dynamic values.
`dataTypes.risk.role`	`string`	None	Link role for relationships to risk items. Evaluated through expression evaluator.
`dataTypes.risk.removeStrategy`	`string`	`delete`	Strategy when removing risk items: `delete` removes permanently.
`dataTypes.risk.rejectedAction`	`string`	`reject`	Workflow action executed when a risk item is rejected during review.
`dataTypes.risk.rejectedStatus`	`string`	`rejected`	Status value set when a risk item is rejected.
`dataTypes.risk.rejectedResolution`	`string`	`invalid`	Resolution value set when a risk item is rejected.

The dataTypes.risk.type property has no usable default — you must define the Polarion work item type for risk items. Without it, Risksheet cannot query or create risk items, producing the error: "No type attribute is defined for dataType".

Task Data Type Defaults

Property	Type	Default	Description
`dataTypes.task.type`	`string`	None	Polarion work item type ID for task/mitigation items. Evaluated through expression evaluator.
`dataTypes.task.role`	`string`	None	Link role for relationships to task items. Evaluated through expression evaluator.
`dataTypes.task.showInMenu`	`boolean`	`true`	Task creation options appear in context menus.

Header Property Defaults

Property	Type	Default	Description
`headers.columnHeader.height`	`number`	`32`	Column header row height in pixels.
`headers.columnGroupHeader.height`	`number`	`32`	Column group header row height in pixels.
`headers.rowHeader.renderer`	`string`	None	Custom renderer function for row headers. When set, applies conditional styling (e.g., RPN-based color coding).

{
  "headers": {
    "rowHeader": {
      "renderer": "rowHeaderRpnNew"
    },
    "columnHeader": {
      "height": 32
    },
    "columnGroupHeader": {
      "height": 32
    }
  }
}

Global Settings Defaults

Property	Type	Default	Description
`global.culture`	`string`	`en`	Culture/locale code affecting date formats, number formats, and localization. See Culture and Localization Codes.

Additional global properties (help URL, refresh behavior, menu organization) have defaults that may vary by Risksheet version. Consult the Configuration Properties Index for the complete list.

Review Configuration Defaults

Property	Type	Default	Description
`reviews.reviewManager`	`string`	`CommentBased`	Review workflow mechanism. Determines how reviews and approvals are handled.

Auto-Read-Only Rules

Risksheet automatically overrides the readOnly default (false) to true for columns matching these conditions, regardless of your explicit configuration:

Condition	Applied To	Reason
`formula` is set	Column	Calculated values cannot be manually edited
`serverRender` is set	Column	Server-rendered content is display-only
Reference column	Column	Cross-project referenced items are read-only
System field binding	Column	Fields `author`, `resolution`, `created`, `updated`, `type`
Permission denied	Column	User lacks write access to the bound field
Historical revision	Entire grid	Viewing a past revision forces `readonly: true` on the entire config

Configuration File Location

The configuration file is always named risksheet.json (constant: CONFIG_FILENAME) and is stored as an attachment on the Polarion LiveDoc document. The configuration resolution order is:

Document-specific risksheet.json — attached directly to the LiveDoc
Template-based — loaded from a global template if templateName is set
Defaults applied — factory defaults fill in any missing properties

See Document Configuration Override and Template Path Configuration for inheritance details.

Complete Minimal Example

The smallest valid risksheet.json that produces a working FMEA risksheet. All other properties use their documented defaults:

{
  "dataTypes": {
    "risk": {
      "type": "risk"
    }
  },
  "levels": [
    {},
    {}
  ],
  "columns": [
    {
      "binding": "title",
      "header": "Failure Mode"
    },
    {
      "binding": "sev",
      "header": "Severity",
      "type": "rating:severity"
    },
    {
      "binding": "occ",
      "header": "Occurrence",
      "type": "rating:occurrence"
    }
  ],
  "ratings": {
    "severity": [
      { "id": "1", "name": "Negligible" },
      { "id": "2", "name": "Minor" },
      { "id": "3", "name": "Moderate" },
      { "id": "4", "name": "Significant" },
      { "id": "5", "name": "Catastrophic" }
    ],
    "occurrence": [
      { "id": "1", "name": "Remote" },
      { "id": "2", "name": "Low" },
      { "id": "3", "name": "Moderate" },
      { "id": "4", "name": "High" },
      { "id": "5", "name": "Very High" }
    ]
  }
}

In this example:

columns[].id is auto-generated from binding (e.g., title, sev, occ)
columns[].type is auto-detected for the title column (becomes text) and explicitly set for rating columns
columns[].level defaults to 1 for all columns
columns[].readOnly defaults to false
columns[].filterable defaults to true
levels[].showInMenu defaults to true for both levels
levels[].controlColumn defaults to systemItemId
dataTypes.risk.removeStrategy defaults to delete
dataTypes.risk.rejectedAction defaults to reject
global.culture defaults to en
reviews.reviewManager defaults to CommentBased

Risksheet.json Format — full configuration file format reference
Configuration Properties Index — alphabetical property listing
Configuration Validation Rules — validation rules and error messages
Document Configuration Override — document-level config overrides
Template Path Configuration — template inheritance
Column Type Reference — column definition properties
Data Types — data type behavior and OData mapping
Levels Configuration — hierarchical level setup

Sources

KB Articles

Risksheet Configuration Properties

Source Code

PolarionAppConfigManager.java
RisksheetViewServlet.java
ShowConfigurationCommand.ts
AppConfigParser.ts
SystemConsts.java

​Top-Level Properties

​Column Property Defaults

​Levels Property Defaults

​DataTypes Property Defaults

​Risk Data Type Defaults

​Task Data Type Defaults

​Header Property Defaults

​Global Settings Defaults

​Review Configuration Defaults

​Auto-Read-Only Rules

​Configuration File Location

​Complete Minimal Example

​Related Pages

Top-Level Properties

Column Property Defaults

Levels Property Defaults

DataTypes Property Defaults

Risk Data Type Defaults

Task Data Type Defaults

Header Property Defaults

Global Settings Defaults

Review Configuration Defaults

Auto-Read-Only Rules

Configuration File Location

Complete Minimal Example

Related Pages