IBM DOORS / DOORS Next 集成

对接拓扑

Rendering diagram…

版本与协议支持

DOORS 版本	主协议	辅助协议	说明
DOORS 9（经典版）	DXL / Incose Export	ReqIF	老牌客户存量环境多
DOORS Next（DNG）	OSLC 2.0	Reportable REST · ReqIF	新客户主力版本
DOORS Next 7.0.3+	OSLC 2.0 + RM API	—	支持更细粒度属性

能力矩阵

能力	DOORS 9	DOORS Next	说明
项目 / 模块发现	✅	✅	自动发现 project / folder / module
需求 CRUD	✅	✅	按 ID 读、写属性、建条目
追溯链（Links）	✅	✅	OSLC link + 自定义 linkType
Baselines（基线）	✅	✅	比对、创建、回滚
批量导入 / 导出	✅	✅	ReqIF / CSV / Reportable REST
模块属性发现	⚠️	✅	DOORS 9 需配合 DXL 脚本
变更影响分析	✅	✅	跨 Link 遍历 + LLM 解释

配置前置条件

DOORS Next：

DNG 服务器 URL（通常以 /rm 结尾）
JTS（Jazz Team Server）URL
具备 OSLC API 访问权限的账号，或 OAuth Consumer
需求要绑定的项目 Area 名称

DOORS 9：

DOORS Web Access（DWA）URL + 端口
或 InCOSE 导出的 ReqIF 文件（离线模式）
DOORS Admin 协助开启 DWA / REST 接口

配置步骤（DOORS Next）

步骤 1：管理台创建 Credential

管理台 → 集成 → ALM → 新增凭据，填入：

Type：oauth2（推荐）或 basic
Base URL：https://dng.example.com/rm
JTS URL：https://dng.example.com/jts
Project Area：/oslc_rm/catalog 中 project 的完整名称
Consumer Key / Secret：DNG 管理员在 Application Management → OAuth Consumers 创建

OAuth 回调 URL 填 https://<combo-agent>/v1/credential/callback/doors_next，一次授权长期有效。

步骤 2：绑定到 Agent / Session

在 Agent 配置里：

skills:
  - name: alm-integration
    config:
      adapter: doors_next
      credential_id: <上一步创建的 credential_id>
      default_project: "ABZ_Platform"

步骤 3：验证连接

combo-cli integration test --credential <credential_id>
# 期望输出：Discovery OK: 12 folders / 48 modules

步骤 4：首次同步需求到 KB

combo-cli import requirements \
  --credential <credential_id> \
  --module "ABZ/Requirements/Functional" \
  --kb <kb_id>

或在 Agent 对话里自然语言触发："把 ABZ 项目 Functional 模块同步到当前知识库"。

配置步骤（DOORS 9 离线 ReqIF 模式）

客户 IT 不开 DWA 很常见。走 ReqIF：

DOORS 9 侧导出 ReqIF（File → Export → ReqIF）
管理台 → 集成 → ALM → ReqIF 离线导入
上传 .reqifz 文件，选目标 KB
系统自动解析为需求条目 + 追溯链

日常操作

场景	触发方式
增量拉取	Cron 定时 / Webhook 订阅 / 手动按钮
回写链路到 DOORS	Agent 自然语言 → 平台调用 alm-integration
基线比对	`"比对 v1.0 和 v1.2 基线"`
变更影响分析	`"修改 REQ_001 会影响哪些下游?"`

常见坑位

问题	解决
OAuth 授权后仍然 401	检查 Project Area 是否填完整路径
增量拉取全量走	检查 `dcterms:modified` 字段；部分老版本 DNG 不支持，改成基线对比
ReqIF 导入属性丢失	自定义属性需要在 KB Mapping 里显式映射
批量写超时	按 batch_size=50 拆分，或走 Reportable REST