# Module Fill

> 根据简单的工件 ID 和层级列表，一步构建空模块的完整结构。

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

- 领域: 模块结构
- 适用于: IBM DOORS Next 模块
- 支持的产品: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- 更改数据
- Keywords: 填充模块, 构建模块结构, 工件 ID 列表, 数据迁移, 从 CSV 创建模块, 插入工件, 模块层次结构
- 版本: 2.17 (发布日期 2026-10-06)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)

## 它是什么，为何存在
从其他工具迁移之后、重组项目时，或者需要用现有需求组装文档时，工件已经存在于 DOORS Next 中，但本应包含它们的模块却是空的。手动将数百个工件按正确的顺序和层级放入模块，既缓慢又容易出错。

Module Fill 正是为这一步而设计的。您只需以简单的配对列表形式提供结构，例如 `[231,1][3513,1.1][67452,1.1.1]`，该列表可以在 Excel 中准备，也可以从源工具中导出，然后由小部件构建模块。

## 解决的问题
- 空模块需要按精确的顺序和层次结构填入数百个现有工件。
- 在迁移中，源工具里的文档结构是已知的，但必须在 DOORS Next 中重建。
- 手动拖放，顺序或层级出错的风险很高。
- 手动工作中断后留下的只构建了一部分的模块。

## 优势
- **几分钟而不是几天**，即可完成大型文档结构的构建。
- **运行前先检查：** 在您输入时即验证列表，逐一查找每个 ID，并以表格形式显示计划的模块。
- **全有或全无：** 结构在一次更改中创建，因此模块绝不会只填充一半。
- **可重复：** 同一列表可以再次使用，例如先在测试项目中试用。
- **自动识别标题**：根据工件类型识别。

## 使用方法
1. 打开一个**空**模块。
2. 按模块顺序粘贴 `[ID,level]` 配对列表。层级写作 1、1.1、1.1.1，依此类推。在您输入时会显示错误和警告。
3. 单击 **Find artifacts (N)**（查找工件）。小部件会查找每个工件，并列出当前配置中不存在的所有 ID。
4. 在表格中检查计划的结构。
5. 单击 **Fill module (N)**（填充模块）并确认。完成后，重新加载模块即可查看结果。

## 须知
- Module Fill 只适用于空模块，因此绝不会将新结构与现有内容混在一起。
- 这些工件必须已经存在于您所工作的项目和配置中。
- 哪些工件类型作为标题添加由设置决定（默认为 *Heading*）。