# Find and Replace

> 在整个模块中查找词语或短语，显示每处位置及新文本，并一次性全部替换。

Source: https://widgets.doorsnext.com/zh/widgets/find-and-replace/

- 学科: 内容质量
- 适用于: IBM DOORS Next 模块
- 支持的产品: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- 更改数据
- Keywords: DOORS Next 查找替换, 替换需求文本, 批量替换文本, 在模块中重命名术语, 全局替换, 搜索并替换需求, DOORS Next 批量编辑
- 版本: 2.10 (发布日期 2026-10-28)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- 工作流程: 1. 输入要查找的内容和替换内容 → 2. 搜索模块并显示每处位置 → 3. 检查列表并确认 (如有需要: 仅部分工件：选中它们并使用 Selection) → 4. 所有位置的文本均已替换 → 5. Excel 变更报告

## 它是什么，为何存在
产品名称变更、术语重命名、"TBD" 之类的占位符终于有了值，或者需要去掉旧的单位。在包含数百条需求的规格说明中，同一段文本需要在许多工件中同时修改。

DOORS Next 一次只能编辑一个工件。Find and Replace 搜索整个模块或所选工件，显示文本所在的每处位置以及修改后的样子，只需确认一次即可全部替换。只有可见文本会改变：格式、链接、图片和表格保持不变。

## 解决的问题
- 为修改同一个词或短语而逐个打开数百个工件。
- 遗漏的位置：旧术语仍留在没人发现的几条需求中。
- 批量修改因盲目编辑存储的文本而破坏格式或链接。
- 没有记录批量修改做了什么，也没有简单的回退方法。

## 优势
- **先看再改：**列出每个包含该文本的工件，每处位置都显示被删除线标记的旧文本和其后的新文本。
- **精确匹配：**Match case 和 Whole words only，除非您需要，否则 "pump" 不会改动 "pumps" 或 "Pump"。
- **保留格式：**粗体、列表、链接和图片都会保留，只改变要查找的文本。
- **也可搜索名称：**如有需要，除主文本外还可搜索工件名称。
- **一次运行处理整个模块，**不受所选工件 200 个的限制，并生成包含每段修改前后文本的 Excel 变更报告。

## 使用方法
1. 在 **Settings** 中（折叠时先点击 **Change**），在 **Find what** 中输入文本，在 **Replace with** 中输入新文本（留空则删除该文本）。选择 **Match case**、**Whole words only** 以及搜索位置：**Primary text**、**Name** 或两者。**Done** 会把 Settings 折叠为一行。
2. 打开一个模块，在 **Replace** 下选择 **Whole module**，然后点击 **Find**。结果会显示有多少工件包含该文本以及出现次数；展开一行即可查看每处位置：旧文本带删除线，新文本紧随其后。
3. 点击 **Replace**，阅读确认信息，然后点击 **Replace in N artifacts**。进度卡片显示运行情况，您可以随时点击 **Stop** 停止。点击结果中的 **Log** 可下载变更报告。
4. 若只修改部分工件，请在 DOORS Next 中选中它们，然后选择 **Selection · N**：小部件会立即搜索这些工件。点击 **Replace** 并确认。

## 须知
- 请在 change set 中运行 Find and Replace，如结果不符合预期可以将其丢弃。
- 文本按输入内容精确查找，包括空格；不支持通配符。空格也能找到不间断空格。
- 被格式拆分的文本（单词的一部分为粗体）不会被替换；搜索会统计这些位置，方便您手动修正。
- 图片和其他文件的内容保持不变；选择 Name 时只会修改其名称。
- 在整个模块上，**Replace** 也可以不先搜索直接运行：每个工件都会被读取，文本在出现处被替换，结束时才知道数字。
- 在非常大的模块上，浏览器可能会变慢。请点击 **Stop** 停止运行，重新加载页面并再次打开模块：**Continue from …** 会以相同设置从停止处继续。