Why a Structured Data Model Matters
In traditional safety engineering, teams often manage requirements in Word, FMEA in Excel, and test cases in specialized tools. These silos create several problems:- Traceability gaps: Manual linking between documents becomes outdated as projects evolve
- Duplicate data entry: The same information (like a system element or failure mode) appears in multiple spreadsheets
- Inconsistent terminology: Different teams use different names for the same concept
- Compliance risk: Auditors struggle to verify complete traceability chains
The Data Model Architecture
The TestAuto2 data model has three layers:- Entity Layer: 20+ work item types representing requirements, system architecture, risks, and tests
- Relationship Layer: Typed links (RTM domain model) defining how entities connect
- View Layer: Risksheets, PowerSheets, and dashboards that query and display the underlying graph
Entity Types: The Building Blocks
TestAuto2 defines 20 specialized work item types organized into six functional domains:Requirements Hierarchy
- Customer Requirement: Stakeholder needs and regulatory mandates (top of V-model)
- System Requirement: System-level functional requirements derived from customer needs
- Subsystem Requirement: Component-scoped requirements refining system requirements
- Design Requirement: Implementation-level specifications (hardware or software)
System Architecture
- System Element: Physical or logical product components (System → Subsystem → Component hierarchy)
- Function: Operational capabilities or behaviors of system elements
- Characteristic: Measurable properties with target values and tolerances
Risk and Safety Analysis
- Hazard: Potential sources of harm in operational scenarios (ISO 26262)
- Harm: Consequences of hazards to persons or property
- Safety Goal: Top-level safety requirements derived from HARA
- Failure Mode: Ways a function or element can fail (DFMEA)
- Process Failure Mode: Ways a manufacturing process can fail (PFMEA)
- Risk Record: Generic risk item for ISO 14971 or other frameworks
- Risk Control: Mitigation actions to reduce failure likelihood or severity
Verification and Validation
- Test Case: Generic test specification
- Verification Test Case: Tests that verify requirements are correctly implemented
- Validation Test Case: Tests that validate customer needs are met
Process Engineering
- Process Step: Manufacturing or assembly operation
- Control Plan Item: Inspection or measurement controls for characteristics
Each work item type has custom fields specific to its role. For example, Failure Mode has severity/occurrence/detection ratings and Action Priority calculations, while Test Case has test steps and expected results. Using typed entities ensures data integrity and enables specialized Risksheet/PowerSheet views.
Relationship Types: How Entities Connect
The RTM (Requirements Traceability Matrix) domain model defines how entities relate. Key relationship types:| Link Role | From → To | Meaning | Example |
|---|---|---|---|
refines | Lower requirement → Higher requirement | ”Breaks down into more detail” | System Req refines Customer Req |
implements | System Element → Requirement | ”Realizes the functionality” | ECU implements System Req |
allocatedTo | Function → System Element | ”Assigned to component” | Braking function allocatedTo Brake ECU |
verifies | Test Case → Requirement | ”Confirms correct implementation” | Test Case verifies Design Req |
validates | Validation Test → Customer Req | ”Confirms customer need is met” | Validation Test validates Customer Req |
hasHazard | Operational Situation → Hazard | ”Can lead to hazard” | Night driving hasHazard Obstacle misdetection |
assesses | Failure Mode → Characteristic | ”Analyzes risk for characteristic” | FM assesses Sensor accuracy |
mitigates | Risk Control → Failure Mode | ”Reduces risk from failure” | Design change mitigates FM |
parent | Work Item → Work Item | ”Hierarchical decomposition” | Subsystem parent System |
How Data Flows Through the Model
Here’s a concrete example showing how a single customer need flows through the entire model:Document Types and Their Role
While the data model is entity-centric, Polarion still organizes work items into documents (LiveDocs). TestAuto2 uses document types to categorize modules:- customerSpecification: Customer requirements documents
- systemRequirementsSpecification: System-level requirements
- designRequirementsSpecification: Design requirements
- testsSpecification: Test case documents
- functionsSpecification: Functional architecture
- characteristicsSpecification: Product characteristics
- riskSpecification: HARA, FMEA, HAZID documents (with Risksheet attachments)
- powersheet: Traceability matrix views (driven by RTM model)
Custom Fields: Extending the Model
Each work item type has custom fields specific to its purpose. For example: Failure Mode custom fields:fmSeverity(1-10),fmOccurrence(0-10),fmDetection(0-10): AIAG-VDA FMEA ratingsfmSevNew,fmOccNew,fmDetNew: Post-mitigation ratingsfmActionPriority,fmAPNew: Action Priority (H/M/L) calculated from S/O/DnextPreventiveAction: Recommended risk reduction measure
classification: SC (Safety Critical) or CC (Conformance Critical)iso26262Part: Which part of ISO 26262 the requirement addresses
testSteps: Step-by-step test procedureexpectedResults: Pass/fail criteria
How This Enables Key Features
The unified data model unlocks powerful capabilities:- Automatic traceability coverage: Dashboards query link relationships to calculate ”% of requirements verified by tests” without manual updates
- Multi-level FMEA: System/Subsystem/Component FMEAs share the same Failure Mode type but filter by linked System Element hierarchy
- Cross-product references: PowerSheets expand from Requirements through System Elements to Failure Modes to Risk Controls in a single view
- Standards compliance metrics: Safety Readiness Scorecard counts work items by type, checks link completeness, and maps to ISO 26262 parts
- Impact analysis: Changing a System Element shows all linked Functions, Failure Modes, and Risk Controls affected
Common Misconceptions
“Work items are just rows in a spreadsheet.”No — work items are persistent entities with IDs, revision history, and workflow states. Risksheets and PowerSheets are views that query and display them, but the underlying data lives in Polarion’s repository. “Traceability links are manually maintained.”
Partially true — users create links (via Risksheet context menus or PowerSheet multi-select pickers), but once established, coverage metrics and traceability reports update automatically. No copy-paste needed. “Each FMEA document is independent.”
No — all Failure Modes share the same work item type. The multi-level FMEA hierarchy comes from linking Failure Modes to different System Elements (System/Subsystem/Component) and filtering Risksheet views accordingly.
Next Steps
Now that you understand the data model structure, explore how it’s applied:- RTM Domain Model: Deep dive into relationship definitions and cardinality constraints
- Traceability Model: How link roles implement ISO 26262 traceability requirements
- Work Item Types Reference: Detailed specifications for each entity type
- Establish Traceability Links: Practical guide to creating links in Risksheet and PowerSheet
- Use Whole RTM Sheet: See the entire V-model graph in one interactive view
- Check Traceability Coverage: Learn how to identify and fix missing links