Understanding Link Roles
TestAuto2 uses specific link roles to establish traceability relationships:
| Link Role | Direction | Example |
|---|
refines | Downstream → Upstream | Design Requirement refines System Requirement |
verifies | Test → Requirement | Test Case verifies System Requirement |
validates | Test → Need | Validation Test validates Customer Requirement |
mitigates | Control → Risk | Risk Control mitigates Failure Mode |
assesses | Risk → Element | Failure Mode assesses Characteristic |
causes | Downstream → Upstream | PFMEA Cause causes SFMEA Failure Mode |
Link Creation Methods
- Open the source work item (e.g., a Design Requirement)
- Navigate to the Linked Work Items section in the form
- Click ➕ Add Link
- Select the link role from dropdown (e.g., “refines”)
- Search for or select the target work item
- Save the work item
You can add multiple links of the same role in one operation by selecting multiple target items before saving.
Method 2: PowerSheet Inline Linking
PowerSheet configurations provide dedicated traceability columns with inline pickers:
- Open the relevant PowerSheet (e.g., Component RTM for Design Requirements)
- Locate the upstream traceability column (e.g., “Subsystem Requirements” column)
- Click the empty cell in the link column
- Select work items from the filtered dropdown picker
- The link is created immediately (no explicit save needed)
Traceability Flow Visualization:
Method 3: Risksheet Task Linking
For FMEA-to-Risk Control traceability:
- Open the FMEA risksheet document
- Expand to the Failure Mode or Cause level
- In the “Risk Controls” column, click
- Create a new Risk Control or link to existing
- The
mitigates relationship is established automatically
Polarion link roles are bidirectional by definition. When you create a refines link from Design Req → System Req, Polarion automatically creates the backlink. However, coverage macros may query forward or backward links depending on analysis direction.
Establishing Requirements Refinement Links
Scenario: Link Design Requirements to their parent System Requirements
- Navigate to Design Space → Component RTM PowerSheet
- Locate your design requirement row
- In the System Requirements column group:
- Click the cell under the relevant subsystem column
- Select the parent system requirement from the picker
- Verify the link appears in the cell with work item ID
Expected Traceability:
Establishing Verification Links
Scenario: Link Test Cases to Requirements they verify
- Open System Verification Sheet PowerSheet
- Locate the system requirement row
- In the Test Cases column:
- Click ➕ to open the entity factory inline creator
- Create a new verification test case, OR
- Select existing test cases from the picker
- The
verifies link is created automatically
Alternatively, from the Test Case work item form:
- Open the Test Case
- In Linked Work Items, add a
verifies link
- Select the requirement(s) being verified
After establishing verification links, check the Requirements Space Dashboard to see updated coverage percentages. Gaps are identified by queries like: type:sysReq AND NOT backlinkedWorkItems:verifies=TA*
Establishing FMEA Traceability Links
SC/CC Requirements → Characteristics → Failure Modes
This three-hop chain is critical for ISO 26262 compliance:
-
Link Requirement → Characteristic:
- Open the Characteristic work item
- Add
refines link to the Design Requirement
-
Link Characteristic → Failure Mode:
- Open the DFMEA risksheet for the component
- In the Failure Mode row, set the Characteristic field
- This creates the
assesses relationship
-
Verify Chain:
- Navigate to Design Space Dashboard
- Check “SC/CC Design Reqs → Failure Modes” coverage bar
- Gap query:
(classification:SC OR classification:CC) AND NOT linkedWorkItems.characteristic.backlinkedWorkItems.assesses.failureMode:*
Upstream SFMEA → DFMEA Linking
Link Design FMEA causes to System FMEA failure modes:
-
Open the Component DFMEA risksheet
-
Expand to the Cause level (Level 3)
-
In the Upstream Risks column:
- Click the cell to open the multi-item picker
- Search for the System FMEA failure mode
- Select and save
-
The
causes link is established (Cause → Failure Mode)
Traceability Visualization:
Establishing Risk Control Traceability
Risk Control → Requirement → Test Case Chain
This chain demonstrates risk mitigation verification:
-
Create Risk Control from FMEA:
- In the FMEA risksheet, click in the Risk Controls column
- Create the risk control work item (automatically creates
mitigates link)
-
Link Risk Control → Requirement:
- Open the Risk Control work item form
- Add
linkedWorkItems link to the implementing requirement(s)
-
Link Requirement → Test Case:
- Follow verification linking steps above
-
Verify Chain in FMEA:
- Return to the FMEA risksheet
- The “Verification Traceability” column (server-rendered) will show the complete chain:
- Risk Control ID
- → Linked Requirements
- → → Linked Test Cases
If the Verification Traceability column shows “No requirements linked” or “No test cases linked,” the chain is incomplete. Use the FMEA Coverage Report to identify gaps: type:riskControl AND NOT linkedWorkItems:*
Verifying Traceability
Space Dashboard Coverage Bars
Each space dashboard (Requirements, Design, Risks, Testing) displays coverage bars:
- Green percentage: Items with complete traceability
- Red gap count: Items missing required links
- Click the gap count to open a query showing uncovered items
Requirements Traceability Report
- Navigate to Documentation Space → Requirements Traceability Report
- Review the V-model matrix showing all traceability chains
- Identify red cells (coverage < 80%) requiring attention
Safety Readiness Scorecard
- Open Home Dashboard → Standards Compliance
- Click Safety Readiness Scorecard
- Review “Traceability %” column for each standard part
- Drill down to gap queries by clicking percentage values
Verification Checklist
You should now see:
Common Issues
Using wrong link roles breaks coverage calculations. Always use refines for requirement decomposition, not related to or custom roles. The RTM model validates against specific role enumerations.
Avoid creating circular traceability (e.g., A refines B, B refines A). The PowerSheet expansion algorithm may fail with “Max depth exceeded” errors.
See Also