Word 操作
Word 自动化功能使您能够与本地或云中存储的 Word 文件无缝交互。 首先，您需要使用“启动 Word”或“附加到正在运行的 Word”操作创建一个 Word 实例。 该实例用作组中其余操作的输入参数，使您可以轻松地对所需的 Word 文件执行操作。
目前，以下操作可用：
- 启动 Word：在 Power Automate 桌面版中触发此操作时，会打开一个 Word 文档并创建一个可在同一桌面流中的后续 Word 操作中使用的 Word 实例。 用户可以选择打开新的空白 Word 文档，也可以选择打开位于本地计算机或云中的现有文档（通过 OneDrive 或 SharePoint）。 根据操作的配置，可以采用可见或不可见方式启动 Word 应用程序，并且可以采用只读模式打开文档。 请务必注意，如果文档采用只读模式打开，则无法通过 Power Automate 桌面版操作或手动对其进行编辑。
- 附加到正在运行的 Word：此操作提供附加当前打开的现有 Word 文档的功能，并创建可在同一桌面流中的后续 Word 操作中使用的 Word 实例。 用户可以选择通过下拉菜单插入设计时已在同一计算机上打开的 Word 文档，或者选择位于本地计算机或云端的现有 Word 文档（通过 OneDrive 或 SharePoint）。
- 保存 Word：此操作使用户能够以当前 Word 应用程序支持的任何格式保存 Word 文档。 默认文档格式为“Default (From Extension)”，这意味着用户必须在文档路径参数中设置文档格式，例如将值设置为 C:\TestWord.pdf，以便将其另存为 PDF。
- 关闭 Word：此操作将关闭 Word 文档并使 Power Automate 中的特定 Word 实例处于停用状态。 用户可以在关闭 Word 文档之前将其保存为 Word 应用程序当前支持的任何格式。 注意，默认文档格式为“Default (From Extension)”，这意味着用户必须在文档路径参数中设置文档格式，例如将值设置为 C:\TestWord.pdf，以便将其另存为 PDF。
- 从 Word 文档中读取：此操作使用户能够从 Word 文档中检索内容并在流的后续操作中使用。 您可以灵活地阅读整个文档、特定页面或书签内容。 对于页面，您可以指定特定页面或页面列表。 例如，您可以在相应的页面参数中插入值 2-5，以检索第二至第五页的内容，例如第 2、3、4 和 5 页，或者插入值 3、5、6、7 以检索相应页面的内容，或者结合使用这两种方法，例如 2-4、6、8、9。 需要注意的是，Word 文档格式无法检索，输出参数是纯文本格式。
- 在 Word 文档中查找和替换单词：用户可以通过此操作应用一项新功能，即在 Word 文档中查找和替换特定文本的能力。 用户可以选择只替换第一次出现的文本或所有匹配。 此外，使用通配符可以进行动态文本查找，在文本查找输入参数中插入通配符。 要进一步细化搜索，请配置该工具以匹配文本的大小写或仅匹配整个单词。 当使用通配符参数设置为关闭时，这些设置可用。
- 写入 Word 文档：此操作使用户能够在 Word 文档中的特定位置插入文本。 这可以在文件的开头或结尾完成，也可以在特定书签之前或之后完成。 此外，用户可以根据自己的喜好选择是否在插入的文本前添加新行。
- 在 Word 文档中插入图像：此操作允许用户在 Word 文档中的特定位置插入图像。 这可以在文件的开头或结尾、特定书签之前或之后、特定文本之前或之后进行。 请注意，没有添加空格或新行。 用户可以选择将图像作为存储在本地计算机中的文件或剪贴板中的内容进行检索。
备注
Power Automate 桌面版的 Word 操作与 Microsoft Word 2013 或更高版本兼容。
启动 Word
打开新的 Word 实例或打开 Word 文档。
输入参数
| 参数 | 可选 | 接受 | 默认值 | Description |
|---|---|---|---|---|
| 启动 Word | 不可用 | 使用空白文档、并打开以下文档 | 使用空白文档 | 指定是打开新的 Word 文档还是现有文档 |
| Document path | 否 | 文件 | 要打开的现有 Word 文档的完整路径 | |
| Make instance visible | 不可用 | 布尔值 | TRUE | 指定是显示还是隐藏 Word 窗口 |
| Open as ReadOnly | 不可用 | 布尔值 | 错误 | 指定是否以只读模式打开存储的文档 |
| 读取保护密码 | 是 | 直接加密的输入或文本值 | Word 文档的读取保护密码（如果受密码保护） | |
| 写入保护密码 | 是 | 直接加密的输入或文本值 | Word 文档的写入保护密码（如果受密码保护） |
生成的变量
| 参数 | 类型 | Description |
|---|---|---|
WordInstance |
Word 实例 | 用于后续 Word 操作的特定 Word 实例。 这允许用户指定要访问几个 Word 文档中的哪一个 |
异常
| 例外 | Description |
|---|---|
| 无法启动 Word | 表示启动 Word 实例时出现问题 |
| 找不到 Word 文档 | 指示在提供的位置找不到特定的 Word 文档 |
| 无法打开现有的 Word 文档 | 表示打开指定的 Word 文档时出现问题 |
| 无法启动 Word 应用程序 | 表示由于内部错误，Word 应用程序无法启动 |
| Word 应用程序未安装 | 指示特定计算机上未安装 Word 应用程序 |
附加到正在运行的 Word
附加到已打开的 Word 文档。
输入参数
| 参数 | 可选 | 接受 | 默认值 | Description |
|---|---|---|---|---|
| Document name | 否 | 文件 | 要附加到的 Word 文档的名称或路径 |
生成的变量
| 参数 | 类型 | Description |
|---|---|---|
WordInstance |
Word 实例 | 此操作附加到的 Word 实例，用于以后的 Word 操作 |
异常
| 例外 | Description |
|---|---|
| 无法附加到 Word 文档 | 指示附加到指定 Word 文档时出现问题 |
| 找不到指定的 Word 文档 | 表示在提供的位置找不到特定的 Word 文档 |
| 无法启动 Word | 表示由于内部错误，Word 应用程序无法启动 |
保存 Word
保存以前启动的 Word 实例。
输入参数
| 参数 | 可选 | 接受 | 默认值 | Description |
|---|---|---|---|---|
| Word 实例 | 否 | Word 实例 | 要保存的 Word 实例。 此变量必须已在启动 Word 或附加到正在运行的 Word 操作中指定。 | |
| 保存模式 | 不可用 | 保存文档、文档另存为 | 保存文档 | 如何保存此实例的文档。 |
| Document format | 不可用 | Word 应用程序中所有可用的格式 | 默认值(来自扩展名) | 文档的格式。 |
| Document path | 否 | 文件 | 文档的完整路径。 根据文档格式参数中的选择插入所需的文档文件扩展名。 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 | Description |
|---|---|
| 未能保存 Word | 表示保存 Word 文档时出现问题 |
| Word 实例或 Word 文档未初始化 | 表示操作中指定的 Word 实例或 Word 文档未初始化 |
| 无法在只读文档上执行该操作 | 表示 Word 文档无法保存，因为该文档是以只读方式打开的 |
关闭 Word
关闭 Word 实例。
输入参数
| 参数 | 可选 | 接受 | 默认值 | Description |
|---|---|---|---|---|
| Word 实例 | 否 | Word 实例 | 要关闭的 Word 实例。 此变量必须已在启动 Word 或附加到正在运行的 Word 操作中指定。 | |
| 关闭 Word 前 | 不可用 | 不保存文档、保存文档、文档另存为 | 不保存文档 | 指定在关闭该实例之前，是否以及如何保存该实例的文档。 |
| Document format | 不可用 | Word 应用程序中所有可用的格式 | 默认值(来自扩展名) | 文档的格式。 |
| Document path | 否 | 文件 | 文档的完整路径。 根据文档格式参数中的选择插入所需的文档文件扩展名。 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 | Description |
|---|---|
| 无法关闭 Word | 表示关闭 Word 文档时出现问题 |
| 未能保存 Word | 表示保存 Word 文档时出现问题 |
| 无法在只读文档上执行该操作 | 表示 Word 文档无法保存，因为该文档是以只读方式打开的 |
从 Word 文档中读取
从 Word 实例的文档中读取文本内容。
输入参数
| 参数 | 可选 | 接受 | 默认值 | Description |
|---|---|---|---|---|
| Word 实例 | 否 | Word 实例 | 要使用的 Word 实例 | 此变量必须已在启动 Word 或附加到正在运行的 Word 操作中指定 |
| Retrieve | 不可用 | 整个文档/页面/书签 | 整个文档 | 是检索整个文档的内容、特定页面的内容还是书签的内容 |
| 页面 | 否 | 数值 | 1 | 要阅读的 Word 文档的页面。 页面范围或列表可提供为 2-5，这将从第 2 页到第 5 页或第 2、3、7 页检索内容，从第 2、3、7 页检索内容 |
| 书签 | 否 | 文本值 | 要读取的 Word 文档的书签 |
生成的变量
| 参数 | 类型 | Description |
|---|---|---|
| WordData | 文本值 | 检索内容的值 |
异常
| 例外 | Description |
|---|---|
| 无法从 Word 文档中读取内容 | 表示从指定的 Word 文档中检索内容时出现问题 |
| Word 实例或 Word 文档未初始化 | 表示操作中指定的 Word 实例或 Word 文档未初始化 |
写入 Word 文档
向 Word 文件写入或追加文本。
输入参数
| 参数 | 可选 | 接受 | 默认值 | Description |
|---|---|---|---|---|
| Word 实例 | 否 | Word 实例 | 要使用的 Word 实例 | 此变量必须已在启动 Word 或附加到正在运行的 Word 操作中指定 |
| Text to write | 是 | 常规值 | 要在指定 Word 文档中写入的文本 | |
| Append new line | 不可用 | 布尔值 | TRUE | 指定是否在要写入文档的整个文本的开头追加一个新行 |
| 将文本写入 | 不可用 | Word 文件开头/Word 文件结尾/书签之前/书签之后 | Word 文件开头 | 指定 Word 文档中将附加文本的位置 |
| 书签 | 否 | 文本值 | Word 文档中文本将附加到的目标书签 | 此操作会在 Word 文件中指定书签的前后附加文字 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 | Description |
|---|---|
| Word 实例或 Word 文档未初始化 | 表示操作中指定的 Word 实例或 Word 文档未初始化 |
| 无法在只读文档上执行该操作 | 表示 Word 文档无法编辑，因为是以只读方式打开的 |
| 对 Word 文档实例的写入操作失败 | 指示在指定的 Word 文档中写入内容时出现问题 |
在 Word 文档中插入图像
将图像插入到 Word 文件中。
输入参数
| 参数 | 可选 | 接受 | 默认值 | Description |
|---|---|---|---|---|
| Word 实例 | 否 | Word 实例 | 要使用的 Word 实例 | 此变量必须已在启动 Word 或附加到正在运行的 Word 操作中指定 |
| 将图像插入 | 不可用 | Word 文件开头/Word 文件结尾/书签之前/书签之后/特定文本之前/特定文本之后 | Word 文件开头 | 指定将附加图像的 Word 文档的位置 |
| 插入图像自 | 不可用 | 文件/剪贴板 | 文件 | 要插入指定 Word 文档中的图像的位置 |
| 图像路径 | 否 | 文件 | 要插入的图像的完整路径 | |
| Text to find | 否 | 文本值 | 要在 Word 文档中查找以插入图像的文本 | 图像将附加到指定文本出现的前后 |
| 书签 | 否 | 文本值 | Word 文档中将附加图像的目标书签 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 | Description |
|---|---|
| Word 实例或 Word 文档未初始化 | 表示操作中指定的 Word 实例或 Word 文档未初始化 |
| 无法在只读文档上执行该操作 | 表示 Word 文档无法编辑，因为是以只读方式打开的 |
| 无法插入图像 | 表示在指定的 Word 文档中插入图像时出现问题 |
查找并替换此 Word 文档中字词
查找文本并将其替换为 Excel 实例的活动工作表中的另一文本。
输入参数
| 参数 | 可选 | 接受 | 默认值 | Description |
|---|---|---|---|---|
| Word 实例 | 否 | Word 实例 | 要使用的 Word 实例 | 此变量必须已在启动 Word 或附加到正在运行的 Word 操作中指定 |
| 所有匹配项 | 不可用 | 布尔值 | 错误 | 是在找到的所有匹配项中查找/和替换文本还是仅在第一个匹配项中查找/和替换文本 |
| Text to find | 否 | 文本值 | 要在工作表中查找的文本 | |
| 要替换为的文本 | 否 | 文本值 | 用于替换匹配单元格的文本 | |
| 使用通配符 | 不可用 | 布尔值 | 错误 | 是否对要查找的文本使用通配符 |
| 区分大小写 | 不可用 | 布尔值 | 错误 | 是否搜索区分大小写的数据 |
| 仅匹配整个单词 | 不可用 | 布尔值 | 错误 | 是否搜索与指定文本相同的单词 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 | Description |
|---|---|
| 无法替换 Word 文档中的文本 | 指示用提供的输入替换指定文本时出现问题 |
| Word 实例或 Word 文档未初始化 | 表示操作中指定的 Word 实例或 Word 文档未初始化 |
| 无法在只读文档上执行该操作 | 表示 Word 文档无法编辑，因为是以只读方式打开的 |
已知限制
使用通过 OneDrive 或 SharePoint 同步的 Word 文件
与 OneDrive 或 SharePoint 中同步的文件夹中包含的 Microsoft Word 文件的交互可能会导致错误的流。 Power Automate 桌面版利用 COM 对象进行 Word 交互。 OneDrive 和 SharePoint 与通过 COM 启动的 Word 实例不完全兼容。
因此，当您尝试打开存储在 OneDrive 或 SharePoint 目录中的 Word 文件时，可能会遇到找不到文件错误。 要解决此问题，请使用以下解决方法之一：
解决方法 1
- 制作相应 Word 文件的本地副本。
- 使用 Power Automate 桌面版 Word 自动化操作，修改 Word 文件的本地副本。
- 用包含最新更改的本地副本覆盖通过 OneDrive 或 Sharepoint 同步的 Word 文件副本。
解决方法 2
- 使用运行应用程序操作打开一个新的 Word 实例。 确保在操作之间提供足够的等待时间，允许 Word 进程完全加载，包括任何加载项。
- 使用操作附加到运行中的 Word 来附加到新流程。
备注
当启动 Word 操作无法执行时，通常可以使用此解决方法。