Structure Writer

它是什么，为何存在

在 DOORS Next 模块中，需求的位置（位于哪一章、编号是多少、在文档中的什么地方）只能在模块视图中看到。一旦工件出现在跨模块视图、导出、过滤器、报告或其他工具中，这种上下文就消失了。从 DOORS 9 迁移过来的团队也会怀念熟悉的文档 ID，例如“SRS-1234”。

Structure Writer 把结构复制到属性中，让它随工件一起流转。对于模块中的每个工件，它可以写入上级章节的路径（“1 引言 > 1.2 范围”）、由前缀、工件 ID 和后缀组成的格式化 ID（“SRS-001234-A”），以及按模块顺序递增、用于排序的编号。您可以选择需要三个值中的哪些，以及每个值写入哪个属性。

解决的问题

• 导出和跨模块视图会丢失需求所属的章节。
• 在模块之外无法按文档顺序对需求排序。
• 迁移后的项目需要带前缀的文档风格 ID，但手工输入既慢又容易出错。
• 旧的编号工具一次只修改一个工件，每一百个工件就要花几分钟。
• 移动或插入章节后，手工维护的路径和编号会悄无声息地出错。

优势

• 一次运行三个值： 层级路径、格式化 ID 和序号，每个都可选，并各自写入自己的属性。
• 灵活的路径： 每一级可显示为节号和名称、仅节号、仅名称、ID 或 ID 和名称，可自定义分隔符，可包含或不包含工件本身。
• 整个模块，速度快： 没有 200 个工件的限制；结构只读取一次，数值分批保存。
• 先检查：对于所选工件，Write 磁贴会显示有多少工件会改变，确认信息会说明将写入多少路径、ID 和编号；已正确的值绝不会再次保存。
• 始终正确： 结构调整后再次运行即可，只更新发生变化的值。
• 留有证据： Excel 变更报告列出每个值修改前后的内容。

使用方法

1. 在 Rules 中打开需要的值，并为每个值选择目标属性：层级路径（层级格式和分隔符）、格式化 ID（前缀、后缀、补零）和序号（起始值和步长）。
2. 如有需要，可将运行限定为一种工件类型、跳过标题，或只填写空的目标属性 (Additional settings)。
3. 打开模块，选择 Whole module（整个模块）并单击 Write（写入）：阅读确认信息并单击 Write values。值会一次性写入整个模块，只保存真正改变的值。
4. 也可以在模块中选中部分工件并选择 Selection（所选内容）：Write 磁贴会显示其中有多少会改变；单击 Write 并通过 Write values 确认。它们的路径和编号仍然来自整个模块。
5. 结果统计已写入、已正确、已跳过和保存失败的工件；如需记录，Log（日志）可保存变更报告。

须知

• 请始终在变更集中工作：默认情况下会覆盖现有值，因为这些值随结构而定。打开 “Only fill empty targets” 可保留手工输入的值。
• 属性值属于工件，而不是它在模块中的位置：在模块中使用两次的工件取其第一个位置的值；同时用于另一个模块的工件取最后一次运行该小部件的模块中的值。
• 顶层工件没有上级章节，因此只有在包含工件本身时才会得到路径。
• 序号只计算被写入的工件，按其在模块中出现的顺序编号。
• 对于非常大的模块，可以停止运行、重新加载页面，然后以相同设置从停止处继续。