IBM DOORS / DOORS Next integration
Topology
Rendering diagram…
Version & protocol support
| SKU | Primary | Secondary |
|---|---|---|
| DOORS 9 classics | DXL / Incose export | ReqIF |
| DOORS Next | OSLC 2.0 | Reportable REST, ReqIF |
| DOORS Next 7.0.3+ | Enhanced RM REST | — |
Feature matrix
| Capability | DOORS 9 | DOORS Next |
|---|---|---|
| Project/module discovery | ✅ | ✅ |
| Requirement CRUD | ✅ | ✅ |
| Trace/links | ✅ | ✅ |
| Baseline compare | ✅ | ✅ |
| Bulk import/export | ✅ | ✅ |
| Field introspection | ⚠️ scripted | ✅ |
Prerequisites
DOORS Next
- Rational server root (often
/rm) - JTS base URL (
/jts) - Service credential or OAuth Consumer with RM scope
- Target Project Area name
DOORS 9 classic
- DOORS Web Access URL + TCP port — or
- Periodic ReqIF handoffs for offline ingestion
- Admin assistance unlocking DWA/REST gateways
Configuration (DOORS Next)
Create credential record
Console → Integrations → ALM → Add:
oauth2(preferred) orbasic- Base URL
https://dng.customer.com/rm - Jazz
https://dng.customer.com/jts - Project Area slug from
/oslc_rm/catalog - Registered Consumer keys
OAuth redirect target: https://<combo-agent>/v1/credential/callback/doors_next.
Bind agents
Smoke test
Initial KB ingestion
Agents can likewise accept natural-language commands (“Sync Functional module into this session’s KB …”).
DOORS 9 ReqIF pathway
Many customers block DWA. Workflow:
- Export
.reqifzbundles from DOORS 9 GUI - Console → Integrations → ALM → ReqIF ingestion
- Platform unpacks artefacts + linkage graph into KB
Day‑2 workflows
| Task | Invocation |
|---|---|
| Incremental pulls | Cron / webhook / manual |
| Reverse sync | Approved links push back via alm-integration |
| Delta baselines | Natural language prompts (“Compare v1.0 vs v1.2…” ) |
| Change impact traversals | “If REQ‑001 edits, downstream scope?” prompts |
Common pitfalls
| Symptom | Mitigation |
|---|---|
| Persistent 401 after OAuth | Incomplete Project Area path |
| Incremental behaving like bulk | Inspect dcterms:modified—older gateways lack support; revert to baseline diffs |
| Missing custom ReqIF attrs | Teach KB mapping manifests |
| Write storms timing out | Batch ≤50 artefacts or migrate to Reportable REST |
References
- Automotive AI requirements overview
- ALM solution brief
- Skill catalogue entry:
alm-integration