# Module Diff

> 快速显示模块自某个基线以来的变化，集中在一个列表中，新旧文本并排显示。

Source: https://widgets.doorsnext.com/zh/widgets/module-diff/

- 学科: 配置与治理
- 适用于: IBM DOORS Next 模块
- 支持的产品: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- 只读
- Keywords: 模块比较, 与基线比较, 需求变更, 改了什么, 变更评审, 差异, 流比较, 配置管理, 审计
- 版本: 1.14 (发布日期 2026-10-28)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- 工作流程: 1. 打开模块 → 2. 在 To 下选择基线或流，并选择属性 → 3. 将模块与该配置进行比较 → 4. 汇总数字和差异列表 → 5. 打开需求：前后版本并排显示 → 6. 用于评审或审计的 Excel 日志

## 它是什么，为什么需要它
“自上一个基线以来，这个模块改了什么？”是评审、发布或审计之前最常见的问题之一。DOORS Next 可以比较配置，但对于大型模块，比较耗时很长，结果也难以浏览。

Module Diff 直接在模块旁的 ELM Mini Dashboard 中回答这个问题。选择当前流的一个基线，或同一组件的其他流或基线，小组件就会列出每一条新增、删除、修改或移动的需求，并显示前后文本。小组件只读取数据。DOORS Next 中不会有任何改动。

## 它解决的问题
- 将大型模块与基线比较耗时太长，因此常被跳过或拖到最后。
- 评审人员必须在成千上万条未变化的需求中找出少数几条修改过的需求。
- 被移动的需求和大纲的变化很容易被忽略。
- 变更评审和审计需要变更记录，而手工整理很困难。

## 带来的好处
- **快速：**另一配置分批读取，文本只保留简短的指纹，因此即使是大型模块也能很快比较完毕。
- **一个列表：**按模块顺序列出新增、删除和修改的需求，并附上所属标题便于定位；也可用 **All artifacts**（所有工件）列出全部需求。
- **修改前后：**打开一条需求，即可逐行查看新旧文本，以及名称、工件类型、在模块中的位置和您选择比较的内容：按链接类型区分的链接、标签、评论和属性。
- **便于浏览：**标题在列表中醒目显示，并可用 +/− 方框折叠；列表上方的搜索和列表可按文本、工件类型或标题缩小范围。
- **双向比较：**使用 **Swap**（交换）可立即反转比较方向，无需重新读取。
- **结构也在内：**被移到其他章节、顺序或层级发生变化的需求会被标记出来。
- **可直接用于评审或审计：**比较结果导出到 Excel，版式与所有 SmarterWidgets 日志相同，包含统计数字和两个配置的名称。
- **人人可放心使用：**小组件只读取数据，任何人随时都可以使用。

## 使用方法
1. 打开模块。在 **Compare**（比较）下，**From**（从）显示您当前工作的配置。在 **To**（到）下选择要比较的基线或流：先是本流的基线，然后是组件的其他流和基线。**Swap** 可反转比较方向。
2. 在 **Attributes to compare**（要比较的属性）下单击 **Change**（更改），勾选要比较的内容：Primary Text (Contents)、Tags、Comments、状态或优先级等属性以及链接类型，或 **Select all**（全选）。名称、工件类型和在模块中的位置始终会被比较。
3. 单击 **Compare module**。进度条显示进展，您可以随时停止。
4. 结果统计新增（仅在 To 中）、删除（仅在 From 中）、修改和未变化的需求。**Differences**（差异）在各自的标题下列出变化；上方的搜索框和列表可按文本、工件类型或标题缩小列表，**All artifacts** 列出全部需求。
5. 打开一条需求，即可逐行查看前后文本，并并排查看其属性。**Show in module**（在模块中显示）会带您定位到该需求。
6. 结果旁的 **Log**（日志）（或 **Differences** 处的下载图标）将比较结果保存到 Excel，供评审或审计使用。

## 需要知道的
- 文本按纯文本比较：仅格式上的变化（粗体、颜色）不算作修改。
- 链接、标签和评论在两个配置中以相同方式读取，因此只列出真正的差异。
- 在全局配置中，模块在其所属组件内进行比较，使用该组件的流和基线。
- 非常大的模块可以分段比较：停止运行、重新加载页面、再次打开模块，然后单击 **Continue**（继续）从停止处继续。
- 在另一配置中无法读取的需求会被列为“未比较”，并说明原因。