This page has limited source coverage. The lightbox field list and behavior described below should be verified against your Risksheet version. Specific field availability may vary depending on your Polarion configuration and work item type definitions.
Overview
The lightbox provides a quick-view panel for inspecting work item details without leaving the Risksheet grid. It displays fields that are configured on the work item type definition in Polarion, including fields that may not be visible as grid columns. This enables risk analysts to review the full context of a risk item — its description, metadata, links, and custom properties — without navigating away to the Polarion work item editor.
Lightbox Field Behavior
The lightbox renders fields from the Polarion work item data model. Fields displayed in the lightbox follow specific rules that distinguish the lightbox view from the grid:
| Behavior | Description |
|---|
| Read-only display | All fields in the lightbox are always read-only — edits are made in the grid or the Polarion work item editor |
| Field source | Values come directly from the Polarion work item storage, not from formula calculations or cell decorators |
| Rich text rendering | Fields with HTML content (such as description) render as formatted text with links, lists, and styling |
| Link display | Item link fields display as clickable hyperlinks that open the linked work item in Polarion |
| System fields | Identity and metadata fields (ID, status, type, author) are always included |
| Custom fields | Any custom fields defined on the work item type appear in the lightbox |
For columns that use formulas (such as calculated RPN values), the lightbox shows the raw stored field value from Polarion, while the grid shows the calculated result. This is because formulas are evaluated client-side in the grid and do not write back to Polarion fields unless explicitly configured to do so.
Field Categories
Identity Fields
These fields identify the work item in the Polarion system and are always present in the lightbox regardless of configuration.
| Field | Type | Description |
|---|
ID | string | The Polarion work item identifier (e.g., RS-001, RISK-042). Always read-only. |
title | string | The work item title text. Displayed prominently at the top of the lightbox. |
type | enum | The work item type (e.g., Risk, RiskRecord, FailureMode). Always read-only. |
status | workflow | Current workflow status of the item. Read-only in lightbox; can be changed via grid workflow columns. |
outlineNumber | string | Document outline number indicating the item’s position in the LiveDoc structure. Always read-only. |
project | string | The Polarion project identifier where this work item resides. Always read-only. |
| Field | Type | Description |
|---|
author | user reference | The user who created the work item. Always read-only. |
created | datetime | Timestamp when the item was created. Format follows the global.culture locale setting. |
updated | datetime | Timestamp of the last modification to the work item. |
resolution | enum | The resolution value, typically set during workflow transitions (e.g., invalid, fixed, done). |
assignee | user reference | The currently assigned user(s). Displayed as user ID in the lightbox. |
The resolution field cannot be edited directly from Risksheet. It is typically a mandatory field during status transitions in Polarion workflows. Status changes from Risksheet only work when all workflow transition conditions are met without requiring additional mandatory field input.
Content Fields
Content fields hold the descriptive and analytical data of the work item.
| Field | Type | Description |
|---|
description | rich text | Rich text description of the work item. Renders with full HTML formatting in the lightbox including images, tables, and links. |
| Custom fields | varies | Any custom fields defined on the work item type in Polarion (e.g., severity, occurrence, detection, rpn). Field type determines rendering behavior. |
Link Fields
Link fields display traceability relationships to other work items.
| Field | Type | Description |
|---|
| Upstream links | item link | Links to upstream items (requirements, safety goals, hazards). Displayed as clickable references. |
| Downstream links | task link | Links to downstream items (mitigations, verifications). Displayed as clickable references. |
| Backlinks | item link | Reverse links from items that reference this work item. |
System Fields That Are Always Read-Only
The following fields are protected from modification in both the lightbox and the grid. Risksheet silently ignores any save attempts to these fields:
| Field | Binding | Reason |
|---|
| Work item ID | id | System-generated identifier |
| Status | status | Controlled by workflow transitions only |
| Type | type | Immutable after creation |
| Project | project | Determined by document location |
| Outline number | outlineNumber | Managed by document structure |
systemReadOnly and systemReadOnlyFields properties that Risksheet evaluates for each work item.
Relationship to Grid Columns
The lightbox and grid columns operate independently but display data from the same underlying Polarion work item:
| Aspect | Grid Column | Lightbox |
|---|
| Data source | Polarion field or formula calculation | Polarion field only (no formulas) |
| Editability | Configurable per column (readonly, canEdit) | Always read-only |
| Formatting | Cell decorators, conditional CSS, custom renderers | Standard Polarion field rendering |
| Visibility | Controlled by columns[] configuration and saved views | Shows all configured fields on the work item type |
| Rich text | Converted to plain text in grid (unless serverRender is used) | Rendered as formatted HTML |
- A field can appear in the lightbox even if it is not configured as a grid column
- Grid columns with formulas display calculated values in the grid but show the raw stored Polarion field value in the lightbox
- Fields rendered via
serverRender in the grid (using Velocity templates) may appear differently in the lightbox, which uses Polarion’s standard field rendering
- The lightbox respects field-level permissions (
systemReadOnlyFields) from the Polarion work item
The lightbox is most useful for reviewing rich text descriptions, examining custom field values not shown in the grid, and quickly checking work item metadata. For editing, use the grid columns directly or open the full Polarion work item editor via the context menu’s Open Row Item action.
Accessing the Lightbox
The lightbox can be opened in the following ways:
| Action | Behavior |
|---|
| Click on a work item ID in the row header | Opens the lightbox detail view for that item |
| Context menu > Open Row Item | Opens the work item in the full Polarion editor (not the lightbox) |
The exact activation method for the lightbox may vary by Risksheet version and Polarion configuration. Verify in your environment which click action triggers the lightbox panel versus the full Polarion editor.
Lightbox Field Rendering by Type
Different Polarion field types render differently in the lightbox:
| Polarion Field Type | Lightbox Rendering |
|---|
| String | Plain text |
| Text (rich text) | HTML-formatted content with images and links |
| Integer / Float | Numeric value |
| Boolean | ”true” / “false” text |
| Enum | Display name of the selected option |
| Multi-enum | Comma-separated display names |
| Date | Formatted according to global.culture locale |
| DateTime | Formatted with date and time according to locale |
| User reference | User display name or ID |
| Duration | Formatted duration string |
| Currency | Formatted with appropriate precision |
| Item link | Clickable hyperlink to the linked work item |
Related Pages
