Purpose and Context
Validation answers the question: Are we building the right system? — confirming that the final product satisfies the original customer requirements. The User Need Validation Sheet provides a three-tier Requirements Traceability Matrix (RTM) view connecting:
- User Needs (CustomerRequirement entities) — what stakeholders require
- Validation Test Cases (ValidationTestCase entities) — how we prove the system meets those needs
- Validation Evidence (external references) — artifacts demonstrating test passage
This sheet is essential for safety-critical projects where ISO 26262 requires closed-loop validation evidence linking back to source requirements, and for quality initiatives (IATF 16949, APQP) demanding customer-centric verification.
Sheet Configuration Properties
Core RTM Query
| Property | Value | Description |
|---|
| Source Entity | CustomerRequirement | RTM model queries user need (customer requirement) work items as the root dataset |
| Order By | title | Sorts requirements alphabetically by title for predictable navigation |
| Order Direction | asc | Ascending alphabetical order (A → Z) |
| Document Filter | (empty) | No document scope constraint; shows all customer requirements in the project |
The RTM model query form:
source:
entity: CustomerRequirement
orderBy: title
orderDirection: asc
parameters: {}
Relationship Expansion Hierarchy
| Level | Expansion Path | Target Entity | Link Role | Cardinality |
|---|
| 1 | validationTestCases.validationTestCase | ValidationTestCase | validationTestCases | 1 → N |
| 2 | validationTestCases.validationTestCase.externalReferences | External Evidence | externalReferences | 1 → N |
The PowerSheet creates Cartesian product rows: one user need can expand to multiple validation test cases, and each test case can expand to multiple evidence artifacts. For example:
| Level | Entity | Link Role | Expanded From |
|---|
| Root | User Need | — | Query result |
| Level 1 | Validation Activity | validates | User Need |
| Level 2 | Validation Evidence | has_evidence | Validation Activity |
Column Group Architecture
The sheet organizes columns into three color-coded sections for visual workflow clarity:
User Needs Column Group (Green Theme)
Displays customer requirement metadata with read-only formatting to enforce requirements governance.
| Column | Type | Width | Format | Notes |
|---|
| Requirement ID | objectId | 80px | readOnly | Unique identifier for the customer requirement; stable across versions |
| Requirement Title | title | 300px | boldReadOnly | Primary navigation column (hasFocus = true); bold text + grey background indicates read-only master data |
| Requirement Description | description | 400px | readOnly | Full text of the customer requirement; collapse target for this group |
Formatting Notes:
isReadOnly: true prevents accidental edits; validation engineers may view but not modify source requirements
hasFocus: true on title column places keyboard cursor here when entering the requirements section
collapseTo: title minimizes the entire group to show only requirement title when user toggles collapse
Validation Tests Column Group (Orange Theme)
Displays linked validation test case information; editable for test case creation and linking.
| Column | Type | Width | Format | Notes |
|---|
| Test Case ID | validationTestCases.validationTestCase.objectId | 100px | default | ID of the linked validation test case; links to test case work item |
| Test Case Title | validationTestCases.validationTestCase.title | 350px | bold | Test case name/description; bold formatting for visual hierarchy; hasFocus = true |
Relationship Syntax:
validationTestCases.validationTestCase — dot notation traverses the RTM expansion: first validationTestCases is the link role, second validationTestCase is the entity type reached
- Each user need can have multiple test cases; PowerSheet creates sub-rows for each
Validation Evidence Column Group (Red Theme)
Displays external reference artifacts (test reports, videos, logs) linked to test cases.
| Column | Type | Width | Format | Notes |
|---|
| Evidence Reference | validationTestCases.validationTestCase.externalReferences | 400px | link | External artifact reference (URL or Polarion attachment); renders as clickable link |
| Evidence Type | validationTestCases.validationTestCase.externalReferences.type | 100px | default | Classification of evidence (e.g., Test Report, Video, Data File) |
Two-Level Expansion:
- Traverses through validation test case to its external evidence links
- Supports nested expansion (2 hops) to reach evidence artifacts not directly attached to requirements
- Evidence may include: PDF test reports, video recordings, data logs, inspection photos, audit trails
Column Group Collapse Behavior
| Group | Collapse To | Behavior | Use Case |
|---|
| User Needs | title | Shows only requirement title; hides ID and description | Summary view for executive reporting |
| Validation Tests | validationTestCases.validationTestCase.title | Shows only test case title | Reduced-width display on narrow screens |
| Evidence | (default visible) | Cannot collapse; evidence section stays expanded | Evidence artifacts require inspection |
Use collapse to reduce visual clutter when reviewing 50+ requirements. Expand only the requirement groups needing detailed evidence review. The collapse state is preserved within your browser session.
View Configurations
Default View
| Property | Setting | Purpose |
|---|
| Visible Columns | All | Full requirements → tests → evidence traceability |
| Sort Order | Title (asc) | Alphabetical requirement ordering |
| Document Grouping | By module | Organize requirements by source specification document |
| Row Height | Standard | Balanced space for multi-line requirement titles |
Configuration example:
views:
default:
visibleColumns: [objectId, title, description, testCaseId, testCaseTitle, evidenceRef]
sortBy: title
sortDirection: asc
expanded: true
Evidence-Focused View (Optional)
Hides user need details to emphasize evidence artifacts and test results:
views:
evidenceFocus:
hiddenColumns: [description]
expandedGroups: [validationTests, validationEvidence]
collapsedGroups: [userNeeds]
visibleColumns: [testCaseTitle, evidenceRef, evidenceType]
Read-Only Requirement Fields
Applied to: Requirement ID, title, description
formatter:
type: readOnly
style:
backgroundColor: grey100
fontColor: grey700
fontWeight: normal
Effect: Grey background with disabled text prevents accidental editing; requirements remain source-of-truth under requirements management governance.
Applied to: Requirement title
formatter:
type: boldReadOnly
style:
backgroundColor: grey100
fontWeight: 600
fontColor: grey700
Effect: Requirement titles stand out visually while remaining immutable; helps readers identify primary requirement statements.
Applied to: Test case title
formatter:
type: conditional
condition: true
style:
fontWeight: 600
Effect: Test case titles display in bold to differentiate the expanded relationship section from root requirement columns; remains editable for test case refinements.
Applied to: External evidence references
formatter:
type: link
style:
color: blue600
textDecoration: underline
onClick: openExternalReference
Effect: Evidence references render as clickable hyperlinks; click opens test report, video, or document in new tab/window.
Configuration File Location
PowerSheet YAML configuration:
.polarion/nextedy/sheet-configurations/User Need Validation Sheet.yaml
Workflow Integration
The User Need Validation Sheet fits into the validation workflow phase of the V-model:
Typical Usage Sequence
- Enter the sheet — Navigate to User Need Validation Sheet from Design space home dashboard
- Review requirement details — Expand requirement titles to read full context and rationale
- Link validation test cases — Add VTC work items to
validationTestCases relationship
- Attach evidence — Link test reports, videos, logs via
externalReferences
- Validate coverage — Use dashboard coverage bars to confirm all customer requirements are tested
- Export for audit — Print sheet or export as PDF for ISO 26262 Part 4 §8 compliance evidence
- Track acceptance — Update test case status as evidence is collected and reviewed
Link Role Requirements
For this PowerSheet to function, the RTM domain model must define:
| Link Role | From | To | Multiplicity | Purpose |
|---|
| validationTestCases | CustomerRequirement | ValidationTestCase | 1:N | Identifies which validation test cases prove the user need |
| externalReferences | ValidationTestCase | External (URL/Attachment) | 1:N | Attaches evidence artifacts (reports, logs, videos) to test cases |
If link roles validationTestCases or externalReferences are missing or misconfigured in .polarion/nextedy/models/rtm-domain-model.yaml, the PowerSheet will display empty columns. Consult RTM Domain Model reference to verify link role definitions.
Sheet Version: TestAuto2 v2.1+
Standards Reference: ISO 26262-4 §8 (Validation), ISO 26262-8 §6 (Traceability)