Overview
TestAuto2 uses eleven document types to structure the automotive safety lifecycle. Documents serve as containers for work items, with each type defining a specific purpose in the ISO 26262 / ISO 14971 workflows. Document types control:
- Work item creation constraints — which work item types are allowed in each document
- Module folder location — automatic placement in Requirements, Design, Risks, or Testing spaces
- PowerSheet querying — document filters enable selective RTM traceability views
- Risksheet attachment — risk analysis modules reference risksheet.json configurations by document type
- Traceability relationships — document type drives valid link roles between work items
Document types directly map to the ISO 26262 V-model phases: Customer Specification → System Requirements Specification → Subsystem Requirements Specification → Design Requirements Specification → Tests Specification. Each level documents requirements and accepts verification/validation evidence at the appropriate tier.
Document Type Enumeration
| Name | ID | Purpose | Module Folder | Typical Work Item Types | Notes |
|---|
customerSpecification | cust-spec | Customer-originated specifications forming the foundation of requirements cascade | Requirements | Customer Requirement | Top-level V-model document; traces down to System Requirements; validates via User Need test cases |
systemRequirementsSpecification | sys-spec | System-level requirements derived from customer specifications | Requirements | System Requirement | Default document type; refines Customer Requirements; refined by Subsystem Requirements; verifies via System Verification test cases |
subsystemRequirementsSpecification | subsys-spec | Subsystem-level requirements decomposing system requirements by engineering subsystem | Requirements | Subsystem Requirement | Bridges system and design levels; scoped by system element; enables parallel team development |
designRequirementsSpecification | design-spec | Detailed design requirements translating subsystem requirements into implementation specifications | Design | Design Requirement | Lowest requirements level; linked to Characteristics; verified by Design Verification test cases; traces to FMEA analysis |
testsSpecification | test-spec | Test specifications defining verification and validation test cases | Testing | Verification Test Case, Validation Test Case | Verification/validation tier; establishes right-side of V-model; traces back to requirements at all levels |
characteristicsSpecification | char-spec | Product characteristics defining measurable properties, tolerances, and acceptance criteria | Design | Characteristic | Engineering characteristics catalog; links to Design Requirements via ‘refines’ relationship; assessed by Failure Modes in FMEA |
functionsSpecification | func-spec | System/subsystem functions describing behavioral capabilities and operational modes | Design | Function | Functional architecture document; functions assessed by Failure Modes (SFMEA/DFMEA); supports function-based FMEA analysis |
riskSpecification | risk-spec | Risk assessment modules containing HAZOP, HAZID, FMEA, or HARA analysis tables | Risks | Hazard, Harm, Failure Mode, Risk Record | Risksheet-enabled documents; attachment configures Risksheet view, columns, formulas, cell decorators; supports multiple risk workflows in single document |
powersheet | ps | PowerSheet traceability matrix modules visualizing cross-project RTM relationships | Solution Template | (none — read-only visualization) | Nextedy PowerSheet module type; renders dynamic traceability views driven by RTM model expansion queries; no direct work item creation |
generic | generic | General-purpose LiveDoc modules for unstructured content not fitting structured categories | (any) | (any) | Catch-all document type; doesn’t participate in PowerSheet queries or Risksheet risk workflows; useful for guides, process documentation, meeting notes |
(Legacy) customDocument | custom | Deprecated custom document types from pre-standardized projects | (varies) | (varies) | Do not use in new projects; migrate to appropriate standard document type per V-model role |
Property Table
| Property | Type | Description | Usage |
|---|
polarionDocumentType | string | Machine-readable document type identifier (e.g., systemRequirementsSpecification) | Internal Polarion field; immutable once document created |
displayName | string | Human-readable label (e.g., “System Requirements Specification”) | Shown in document selectors, PowerSheet headers, reports |
vModelPhase | enum | V-model lifecycle phase: concept, design, implementation, verification, production | Controls document placement and workflow routing |
workItemTypeConstraints | array | Allowed work item types; empty array = any type allowed | Enforces data integrity; prevents invalid work items in wrong document |
moduleFolder | string | Auto-placement folder (e.g., Requirements, Design, Risks, Testing) | Organizes documents by space; used by PowerSheet entity factory |
defaultModuleName | string | Auto-generated module name pattern (e.g., CUSTOMER-REQS, DESIGN-REQS) | Applied when creating documents via create dialog; can be overridden |
risksheetAttachment | reference | JSON configuration key (e.g., hazid-risksheet, sfmea-risksheet) | Links document to Risksheet view; null for non-risk documents |
powerSheetQueryable | boolean | Whether document participates in PowerSheet expansion paths | Enables/disables RTM traceability queries filtering by this doc type |
traceabilityRole | enum | Primary traceability role in V-model: specifies, verifies, validates | Guides valid link relationships to other documents |
V-Model Document Flow
Document Type Usage Patterns
Requirements Cascade (Top-Down Traceability)
The requirements specification types follow a strict hierarchy:
Customer Specification (customerSpecification)
- Contains: Customer Requirement work items
- Role: Voice of the customer; captures high-level needs and operational context
- Traces to: System Requirements (via ‘refines’ link role)
- Validated by: Validation Test Cases in Test Specifications
System Requirements Specification (systemRequirementsSpecification)
- Contains: System Requirement work items
- Role: System-level functional requirements derived from customer needs
- Default document type for all system requirements
- Traces: Refines Customer Requirements, refined by Subsystem Requirements
- Verified by: System Verification Test Cases in Test Specifications
Subsystem Requirements Specification (subsystemRequirementsSpecification)
- Contains: Subsystem Requirement work items (one per engineering subsystem)
- Role: Subsystem-level functional requirements enabling parallel team development
- Traces: Refined by Design Requirements
- Scoped by: System Element (subsystem or component)
- Verified by: Subsystem Verification Test Cases
Design Requirements Specification (designRequirementsSpecification)
- Contains: Design Requirement work items with subType classification (Electrical, Mechanical, Software, Labeling, Usability)
- Role: Implementation-level specifications; bridges requirements to design/test
- Traces: Refines Subsystem Requirements; refined by Characteristics
- Scoped by: System Element (component or subcomponent)
- Verified by: Design Verification Test Cases; assessed in FMEA analysis via Characteristics
Risk Analysis Documents (Risksheet-Enabled)
Risk Specification (riskSpecification)
- Contains: Hazard, Harm, Failure Mode, Risk Record, Risk Control work items
- Role: Central repository for all risk assessment tables (HAZID, FMEA, Control Plans)
- Risksheet attachment: Defines table structure, column formulas, cell decorators, progress tracking
- Usage: Multiple independent Risksheet modules can exist in one document (HAZID in rows 1-20, SFMEA in rows 21-50, etc.)
- Typical documents:
- “HAZID - AEB System” — initial hazard identification and ASIL allocation
- “System FMEA - ECU Processing Subsystem” — failure mode analysis at subsystem level
- “Component DFMEA - Camera Module” — design-level failure modes
- “Process FMEA - Sensor Assembly” — manufacturing/assembly process failures
- “Control Plan - Sensor Assembly” — measurement and reaction plan for characteristics
Traceability & Engineering Data Documents
Characteristics Specification (characteristicsSpecification)
- Contains: Characteristic work items with target values, tolerances, acceptance criteria
- Role: Engineering characteristics catalog; links to Design Requirements and assessed by Failure Modes
- Example: “Camera Module - Design Characteristics” contains 12 characteristics (lens focal length, sensor sensitivity, response time, etc.)
Functions Specification (functionsSpecification)
- Contains: Function work items describing system/subsystem behavioral capabilities
- Role: Functional decomposition; each function assessed by Failure Modes in FMEA
- Example: “AEB System Functions” contains obstacle detection, threat assessment, brake actuation, fallback functions
Tests Specification (testsSpecification)
- Contains: Verification Test Case and Validation Test Case work items
- Role: Right side of V-model; establishes verification/validation evidence
- Traces: Verifies Design/System/Subsystem/Customer Requirements
- Example: “System Verification Specification - AEB” contains test procedures for obstacle detection range, braking response time, sensor fusion accuracy
PowerSheet Matrices (Read-Only Views)
PowerSheet (powersheet)
- Contains: No work items — purely visualization layer
- Role: Dynamic traceability matrices rendered via RTM model expansion queries
- Examples:
- “Whole RTM Sheet” — complete system traceability from Customer Requirements to Test Cases
- “Component RTM - Camera Module” — filtered to single component’s requirements and tests
- “System Verification Sheet” — Design Requirements to Verification Test Cases
PowerSheet documents are auto-generated from configuration; editing the document content is not supported. To modify a PowerSheet, edit its YAML configuration in .polarion/nextedy/sheet-configurations/.
Generic & Legacy Documents
Generic (generic)
- Contains: Any work item type or unstructured content
- Role: Catch-all for guides, process documentation, meeting notes, legacy imports
- Traceability: Does not participate in RTM queries or Risksheet workflows
- Recommendation: Avoid for new projects; migrate legacy content to appropriate standard types
Document Type Constraints & Validation
Work Item Creation Constraints
When a user creates a work item within a document, Polarion validates the work item type against the document type’s allowed list:
| Document Type | Allowed Work Item Types |
|---|
| customerSpecification | CustomerRequirement |
| systemRequirementsSpecification | SystemRequirement |
| subsystemRequirementsSpecification | SubsystemRequirement |
| designRequirementsSpecification | DesignRequirement |
| testsSpecification | VerificationTestCase, ValidationTestCase |
| characteristicsSpecification | Characteristic |
| functionsSpecification | Function |
| riskSpecification | Hazard, Harm, FailureMode, RiskRecord, RiskControl |
| powersheet | (no direct creation) |
| generic | (any type allowed) |
Violation of these constraints is prevented at the UI level; attempts to create invalid work items are blocked with an error message.
Auto-Placement via Entity Factory
PowerSheet expansion queries use entity factories to auto-create work items in predefined locations:
# Example: Design Verification Sheet expansion creates new tests in Testing folder
expansion:
- path: "verificationTestCases"
entityFactory:
createIn: "Testing/DesignVerificationSpecification"
workItemType: "VerificationTestCase"
When a user creates a new verification test from a design requirement row, Polarion automatically:
- Selects the target document type (
testsSpecification)
- Navigates to the configured module folder (
Testing)
- Creates the work item in the correct document (
DesignVerificationSpecification)
This ensures consistent document organization and prevents manual navigation overhead.
Document Type Filtering in PowerSheet
PowerSheet configurations use document type filters to scope queries:
# Example: System Verification Sheet shows only tests from Testing/SystemVerificationSpecification
expansion:
- columns:
- field: "description"
- field: "linkedWorkItems"
documentFilters:
- documentType: "testsSpecification"
moduleName: "SystemVerificationSpecification"
The documentFilters constraint ensures that only test cases from the specified document type and module are displayed, preventing cross-contamination between verification levels (system vs. design vs. subsystem).
Risksheet Configuration Attachment
Risk Specification documents attach a risksheet.json configuration defining the table structure:
{
"name": "System FMEA - AEB Sensor Subsystem",
"documentType": "sfmea-risksheet",
"columns": [
{
"id": "systemElement",
"title": "System Element",
"type": "string",
"level": 1,
"expand": true
},
{
"id": "function",
"title": "Function",
"type": "workItemLink",
"level": 2,
"workItemType": "Function"
},
{
"id": "failureMode",
"title": "Failure Mode",
"type": "workItemLink",
"level": 2,
"workItemType": "FailureMode"
},
{
"id": "fmSeverity",
"title": "S",
"type": "enum",
"enum": "fmea-severity"
},
{
"id": "premitigationFMOccurrence",
"title": "O",
"type": "enum",
"enum": "fmea-occurrence"
},
{
"id": "premitigationDetection",
"title": "D",
"type": "enum",
"enum": "fmea-detection"
},
{
"id": "premitigationAP",
"title": "Action Priority",
"type": "calculated",
"formula": "calculateActionPriority(fmSeverity, premitigationFMOccurrence, premitigationDetection)"
}
]
}
Each document type (sfmea-risksheet, dfmea-risksheet, hazid-risksheet, etc.) maps to a pre-configured Risksheet template, ensuring consistent column structure and formulas across all FMEA documents.
Follow naming conventions when creating documents to maintain project organization:
- Requirements:
<Level> Specification - <System/Component> (e.g., “Design Specification - Camera Module”)
- Risk:
<AnalysisType> - <System Element> (e.g., “System FMEA - AEB Sensor Subsystem”)
- Tests:
<LevelType> Verification Specification - <System> (e.g., “System Verification Specification - AEB”)
- PowerSheet:
<SheetType> Sheet - <Scope> (e.g., “Whole RTM Sheet” or “Component RTM - Camera Module”)
Related Pages