Overview
System Requirements occupy the second level of the requirements V-model cascade:
System Requirements are managed in systemRequirementsSpecification LiveDocs within the Requirements space and participate in bidirectional traceability with verification test cases, design requirements, and FMEA failure modes.
System Requirements describe system-level functionality applicable across all subsystems (e.g., “System shall detect obstacles within 100m”). Subsystem Requirements add component-specific constraints (e.g., “Camera subsystem shall provide 100m detection range”). The Polarion RTM model enforces this decomposition via the SubsystemRequirement entity type, which uses the same polarion type (sysReq) but constrains to subsystemRequirementsSpecification documents.
Standard Properties
| Property | Type | Default | Description |
|---|
| ID | Text | Auto-generated | Unique system requirement identifier within the project prefix (e.g., TST2-SR-001). Assigned by Polarion on work item creation. |
| Title | Text | Required | Concise, single-sentence requirement statement using imperative mood. Example: “System shall detect obstacles within specified range”. |
| Description | Rich Text | Empty | Detailed requirement specification including rationale, constraints, exceptions, and references to customer requirements or standards. Supports formatted text, tables, and embedded images. |
| Status | Enumeration | Draft | Work item lifecycle state: Draft (authoring), In Review (awaiting approval), Approved (accepted), Obsolete (superseded). Managed via document workflow transitions. |
| Outline Number | Auto-generated | Hierarchical | Numeric outline position within the parent document (e.g., 1, 1.1, 1.1.1). Enables logical navigation and reference in traceability reports. |
| Severity | Enumeration | None | Optional field indicating criticality for prioritization. Values depend on project configuration. |
- Use imperative voice: “System shall detect…” not “Detection capability…”
- Quantify objectives where possible: “within 100m range” not “at long range”
- One requirement per work item—avoid compound statements with “and”
- Keep under 100 characters for readability in PowerSheet and list views
Classification Properties
System Requirements use classification fields to support ISO 26262, AIAG-VDA FMEA, and IATF workflows:
| Property | Type | Default | Description |
|---|
classification | Enumeration | None | SC/CC (Special Characteristic) categorization per IATF 16949 APQP. Values: SC (Special Characteristic—critical to safety/function), CC (Critical Characteristic—key performance), None (standard requirement). Used to prioritize characteristics linked to this requirement for design verification and control plan inclusion. |
subType | Enumeration | Functional | Design Requirement subtype (used when requirement is later refined into design requirements). Values: Functional, Non-Functional, Interface, Performance, Constraint. Inherited by refined Design Requirements; allows filtering by engineering discipline. |
Example classification workflow:
- Customer Requirement: “Vehicle shall brake safely” (unclassified)
- System Requirement: “System shall apply proportional braking force to all wheels” (SC—safety-critical)
- Design Requirements (refined): “ECU shall compute brake pressure” (SC, Functional), “CAN interface shall transmit brake command within 50ms” (SC, Interface)
Traceability Links
System Requirements participate in the following link relationships within the RTM domain model:
Upstream Links
| Link Role | Target Type | Description | Cardinality |
|---|
refines | Customer Requirement | Flows from customer needs into system-level detail. Each system requirement refines one or more customer requirements to provide specific measurable targets. Bidirectional traceability. | Many-to-Many |
refinesFrom | Customer Requirement | Reverse view of refines link. Queried in RTM PowerSheets to show parent customer requirements. | Many-to-Many |
Downstream Links
| Link Role | Target Type | Description | Cardinality |
|---|
refined by | Subsystem Requirement | Decomposes system requirement across subsystems. Each subsystem adds constraints and allocates functionality to hardware/software components. Enables multi-team parallel development. | One-to-Many |
refinesInto | Subsystem Requirement | Reverse view of refined by. Used in RTM PowerSheets to show child requirements. | One-to-Many |
refined by | Design Requirement | Direct refinement when system-level design requirements exist (bypass subsystem level). | One-to-Many |
Verification Links
| Link Role | Target Type | Description | Cardinality |
|---|
verifies | Test Case | Backward link from verification test cases to system requirements. Test cases marked with verifies link role verify one system requirement per test case. Used in System Verification PowerSheet to track coverage. | One-to-Many |
verified by | Test Case | Forward link showing which test cases verify this requirement. Central to V-model traceability and safety compliance reporting. | One-to-Many |
Standards & Safety Analysis Links
| Link Role | Target Type | Description | Cardinality |
|---|
assessedBy | Failure Mode | FMEA failure modes assessing this requirement’s potential failures. Used to ensure FMEA covers all system requirements at appropriate decomposition level. | One-to-Many |
assesses | Safety Goal | Safety Goals derived from system requirements in ISO 26262 HARA. System requirement may flow to multiple safety goals. | One-to-Many |
linkedWorkItems | Any | General-purpose link for cross-references (e.g., to design documents, standards clauses, regulatory notes). | Many-to-Many |
Document Constraints
System Requirements are created exclusively within systemRequirementsSpecification LiveDocs. The Polarion RTM model enforces this via:
SystemRequirement:
polarionType: "sysReq"
constraint: "pick"
documentType: "systemRequirementsSpecification"
moduleFolder: "Requirements"
description: "System-level requirement. Must be placed in an SRS document."
Constraint Behavior:
- When creating a new System Requirement, Polarion presents a picker dialog filtered to show only LiveDocs of type
systemRequirementsSpecification
- Existing System Requirements cannot be moved to other document types via drag-and-drop (Risksheet or direct edit)
- Bulk operations that would violate document type constraint are rejected
If you encounter a System Requirement appearing in a non-SRS document (e.g., riskSpecification), this indicates either:
- A data migration error during project import
- Manual manipulation via SVN (not recommended)
- A configuration inconsistency
Always use the Consistency Checker to validate RTM model integrity before reporting the issue.
Custom Fields
System Requirements support custom fields to capture safety and quality metadata:
| Custom Field | Type | Values | Used By | Description |
|---|
requirementPriority | Enumeration | High, Medium, Low | Roadmap planning | Priority for phased implementation or MVP scope |
traceabilityStatus | Read-only | Traced, Partial, Untraced | Coverage reports | Auto-set based on presence of refines/refined-by/verified-by links |
safetyRelevant | Boolean | True / False | Verification planning | Flags requirements linked (direct or via Safety Goal) to ASIL hazards for enhanced V&V rigor |
releaseTarget | Enumeration | v1.0, v1.1, v2.0, etc. | Release planning | Maps requirement to product release version for scheduling |
Access custom fields via System Requirement Custom Fields Reference for detailed enumeration values and usage rules.
Verification and Test Traceability
System Requirements are verified at the System Verification phase of the V-model. Each requirement must have:
- At least one System Verification Test Case linked via
verified by
- Test case execution evidence (test run results, pass/fail status)
- Coverage closure before document approval
System Verification PowerSheet
The System Verification PowerSheet provides interactive traceability matrix:
- System Requirement (from SRS)
- Test Case ID (from Testing/SystemVerificationSpec)
- Test Title
- Test Status
- Verification Evidence
- Test Run Result (PASS/FAIL/BLOCKED)
- Attachment (test report, log, measurement data)
- Verification Owner
Query Example:
SELECT SystemRequirement
WHERE document.type = "systemRequirementsSpecification"
AND verified_by count = 0
ORDER BY id
This query identifies unverified system requirements—top candidates for coverage closure in safety readiness audits.
FMEA Integration
System Requirements participate in FMEA at multiple levels:
| FMEA Level | Assessment | Link Pattern | Purpose |
|---|
| System FMEA | Functions (derived from system requirements) | Failure Mode assesses Function | Identify how system-level functions can fail; trace back to requirements impact |
| Subsystem FMEA | Subsystem Requirements (refined from system reqs) | Failure Mode assesses Subsystem Requirement | Decomposed FMEA following system decomposition |
| Design FMEA | Design Requirements (refined from system reqs) | Failure Mode assesses Characteristic | Component-level FMEA tied to measurable design criteria |
Example Traceability Chain:
- SR-001: “System shall detect obstacles within 100m range”
- refines: CR-001 (Customer Requirement)
- refined by: SubsystemReq (Camera subsystem detection requirement)
- verified by: Test Case (System Verification — Range Test)
- assesses Failure Mode: “Object detection fails due to camera malfunction”
- Control: “Add redundant sensor fusion”
- Pre-Mitigation AP: High
- Post-Mitigation AP: Medium (detection coverage reduced to 90%)
- assesses Safety Goal: SG-02 “Ensure obstacle detection reliability” (ASIL B)
RTM Model Integration
System Requirements are the anchor point for the whole system V-model:
┌─────────────────────────────────┐
│ System Requirement (CENTER) │
└─────────────────────────────────┘
↙ ↓ ↖
Upstream Lateral Downstream
↙ ↓ ↖
Customer Safety Goal Subsystem
Requirement (HARA) Requirement
↓ ↓
Function Design
(FMEA) Requirement
↓ ↓
Failure Mode Characteristic
(RPN calc) (Meas. target)
↓ ↓
Risk Control Test Case (SV)
(Mitigation) (Verification)
See RTM Domain Model for complete entity relationship diagram and Traceability Model for detailed link semantics.
Common Workflows
Creating a System Requirement
- Open or create a systemRequirementsSpecification LiveDoc in the Requirements space
- Right-click → “Create Work Item” → Select
SystemRequirement type
- Enter Title (imperative: “System shall…”)
- Add Description with acceptance criteria and rationale
- Set Classification (SC/CC if safety-critical per IATF 16949)
- Save and link upstream to Customer Requirement via
refines
- Create System Verification Test Case and link via
verified by
Related Guide: Create System Requirements
Deriving Subsystem Requirements
- Open System Requirement in RTM PowerSheet or work item view
- In “Refined By” section, create Subsystem Requirements for each subsystem
- Each Subsystem Requirement inherits classification and adds subsystem-specific constraints
- Link each Subsystem Requirement
refines the System Requirement (auto-created)
- Continue decomposition to Design Requirements as needed
Related Guide: Refine Requirements Across Levels
Verifying System Requirements
- Open System Verification PowerSheet
- System Requirements appear in left column (read-only)
- For each requirement, add Test Cases in center column
- For each Test Case, add Verification Evidence in right column
- System coverage report auto-calculates: (Verified Requirements / Total Requirements) × 100%
Related Guide: Check Verification Coverage
Enumerations and Allowed Values
Status Enumeration
| Value | Meaning | Transition Rules |
|---|
| Draft | Authoring in progress | → In Review (submit) |
| In Review | Awaiting approval from safety engineer or design lead | → Approved (approve) or → Draft (reject) |
| Approved | Accepted and baselined | → Obsolete (supersede) |
| Obsolete | Replaced by newer requirement | Read-only; cannot transition back |
Severity Enumeration (Optional)
| Value | Meaning | Used For |
|---|
| Critical | Safety-critical; ASIL ≥ A or SC characteristic | Highlights in verification planning |
| High | Performance-critical; affects user experience | Medium priority for test execution |
| Medium | Standard functional requirement | Standard priority |
| Low | Nice-to-have or future consideration | Backlog/phase-2 candidates |
Common Questions
Q: What’s the difference between System Requirements and Subsystem Requirements?
A: System Requirements describe end-to-end system capabilities (e.g., “detect obstacles”). Subsystem Requirements add component-specific constraints (e.g., “camera subsystem shall provide 100m range”). Both use the same Polarion type (sysReq) but different document types to enforce separation of concerns and enable multi-team parallel work.
Q: Can I move a System Requirement between documents?
A: No. The document type constraint enforces that System Requirements stay in systemRequirementsSpecification documents. To restructure requirements, delete the work item and recreate it in the target document, then re-establish all links.
Q: How do I track requirement status changes?
A: Use the Traceability Status read-only field (auto-set by Polarion) and enable change history auditing via Document Workflow. Approval workflows integrate with Polarion’s built-in change notification system.
Q: What happens if a system requirement is never refined?
A: Unrefined System Requirements are flagged in the Requirements Traceability Report as coverage gaps. They remain valid (may represent system-level qualities not decomposed further) but should be explicitly reviewed during safety readiness audits to confirm intentionality.