Skip to main content

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

NameIDPurposeModule FolderTypical Work Item TypesNotes
customerSpecificationcust-specCustomer-originated specifications forming the foundation of requirements cascadeRequirementsCustomer RequirementTop-level V-model document; traces down to System Requirements; validates via User Need test cases
systemRequirementsSpecificationsys-specSystem-level requirements derived from customer specificationsRequirementsSystem RequirementDefault document type; refines Customer Requirements; refined by Subsystem Requirements; verifies via System Verification test cases
subsystemRequirementsSpecificationsubsys-specSubsystem-level requirements decomposing system requirements by engineering subsystemRequirementsSubsystem RequirementBridges system and design levels; scoped by system element; enables parallel team development
designRequirementsSpecificationdesign-specDetailed design requirements translating subsystem requirements into implementation specificationsDesignDesign RequirementLowest requirements level; linked to Characteristics; verified by Design Verification test cases; traces to FMEA analysis
testsSpecificationtest-specTest specifications defining verification and validation test casesTestingVerification Test Case, Validation Test CaseVerification/validation tier; establishes right-side of V-model; traces back to requirements at all levels
characteristicsSpecificationchar-specProduct characteristics defining measurable properties, tolerances, and acceptance criteriaDesignCharacteristicEngineering characteristics catalog; links to Design Requirements via ‘refines’ relationship; assessed by Failure Modes in FMEA
functionsSpecificationfunc-specSystem/subsystem functions describing behavioral capabilities and operational modesDesignFunctionFunctional architecture document; functions assessed by Failure Modes (SFMEA/DFMEA); supports function-based FMEA analysis
riskSpecificationrisk-specRisk assessment modules containing HAZOP, HAZID, FMEA, or HARA analysis tablesRisksHazard, Harm, Failure Mode, Risk RecordRisksheet-enabled documents; attachment configures Risksheet view, columns, formulas, cell decorators; supports multiple risk workflows in single document
powersheetpsPowerSheet traceability matrix modules visualizing cross-project RTM relationshipsSolution Template(none — read-only visualization)Nextedy PowerSheet module type; renders dynamic traceability views driven by RTM model expansion queries; no direct work item creation
genericgenericGeneral-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) customDocumentcustomDeprecated 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

PropertyTypeDescriptionUsage
polarionDocumentTypestringMachine-readable document type identifier (e.g., systemRequirementsSpecification)Internal Polarion field; immutable once document created
displayNamestringHuman-readable label (e.g., “System Requirements Specification”)Shown in document selectors, PowerSheet headers, reports
vModelPhaseenumV-model lifecycle phase: concept, design, implementation, verification, productionControls document placement and workflow routing
workItemTypeConstraintsarrayAllowed work item types; empty array = any type allowedEnforces data integrity; prevents invalid work items in wrong document
moduleFolderstringAuto-placement folder (e.g., Requirements, Design, Risks, Testing)Organizes documents by space; used by PowerSheet entity factory
defaultModuleNamestringAuto-generated module name pattern (e.g., CUSTOMER-REQS, DESIGN-REQS)Applied when creating documents via create dialog; can be overridden
risksheetAttachmentreferenceJSON configuration key (e.g., hazid-risksheet, sfmea-risksheet)Links document to Risksheet view; null for non-risk documents
powerSheetQueryablebooleanWhether document participates in PowerSheet expansion pathsEnables/disables RTM traceability queries filtering by this doc type
traceabilityRoleenumPrimary traceability role in V-model: specifies, verifies, validatesGuides valid link relationships to other documents

V-Model Document Flow

diagram

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 TypeAllowed Work Item Types
customerSpecificationCustomerRequirement
systemRequirementsSpecificationSystemRequirement
subsystemRequirementsSpecificationSubsystemRequirement
designRequirementsSpecificationDesignRequirement
testsSpecificationVerificationTestCase, ValidationTestCase
characteristicsSpecificationCharacteristic
functionsSpecificationFunction
riskSpecificationHazard, 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:
  1. Selects the target document type (testsSpecification)
  2. Navigates to the configured module folder (Testing)
  3. 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”)