读取文件

在 RRPA 自动化流程中，有时您需要从本地或网络上的文件中获取数据，例如读取配置信息、列表数据或文本内容。“读取文件”功能就是为此而设计，它能让您的自动化流程与外部文件进行交互，从而处理更多样化的任务。

读取文件

1. 什么是“读取文件”功能？

“读取文件”功能允许您的 RPA 流程访问并读取指定路径下的文件内容。您可以选择不同的文件类型，插件会根据您的设置，将文件内容转换为适合在流程中处理的数据格式（如文本、JSON 对象或数据列表）。

在您的自动化工作流程中，找到并拖拽或点击添加“读取文件”模块到您的流程图中。

添加该模块后,点击模块之后，右侧会弹出“读取文件”的主配置面板。

在“读取文件”模块的配置面板中，默认选中“设置”选项卡。您需要在这里定义文件的基本信息。

名称

在“名称”输入框中，系统会自动为这个模块生成一个唯一 ID（例如：F-TGT6S）。这个 ID 就是这个文件变量的名称，您可以在后续的流程中通过 {{@file.F-TGT6S}} 的方式来引用它所读取的文件内容。

建议：您可以将其修改为一个更具描述性的名称，但请确保其唯一性。

类型

点击“类型”下拉菜单，选择您要读取的文件类型以及希望将文件内容转换为的数据格式。

支持的文件格式和对应类型：

JSON：将 JSON 文件内容解析为一个 JavaScript 对象或数组。您可以像操作普通对象或数组那样访问其内部数据（例如：{{@file.F-TGT6S}}或{{@file.F-TGT6S.key}} 或 {{@file.F-TGT6S.0.key}}）。

文件路径

查看本地文件路径：
- 在 Windows 系统中，您可以找到目标文件，右键点击选择“属性”，在“常规”选项卡中复制“位置”和“文件名+扩展名”，然后将它们拼接起来（例如：C:\Users\您的用户名\Documents\myfile.txt）。
- 或者，按住 Shift 键，右键点击文件，选择“复制为路径(Copy as path)”，然后粘贴到输入框中。
如何读取本地文件
- 对于本地文件，您需要使用 file:/// 协议作为前缀，后跟文件的完整路径。例如：file:///C:/MyData/config.json (Windows 系统) 或 file:///home/user/documents/list.txt (Linux/macOS 系统)。
- 提示：在大多数情况下，当您通过右键复制文件路径并粘贴到输入框时，插件可能会自动为您添加 file:// 前缀。如果未自动添加，请手动补全。
如何读取远程文件：
- 对于远程文件，您需要使用 http:// 或 https:// 协议作为前缀，后跟文件的完整 URL。例如：https://example.com/data.json。
- 如果文件位于网络共享路径，您也可以直接输入网络路径，例如：\\Server\Share\data.xlsx。
支持变量和模板语法：
- 文件路径也支持使用变量和模板语法进行动态指定。您可以引用其他变量来构建文件路径。例如：{{@var.下载文件夹}}\{{@var.文件名}}。有关变量引用的详细信息，请参阅 动态变量。

当您完成文件路径和类型的设置后，点击“预览（小眼睛图标）”按钮。系统会尝试读取文件并显示其内容。

对于 TXT 类型，会直接显示文本内容。

对于 JSON 类型，会显示解析后的 JSON 结构。

对于 excel转为JSON 或 excel转为Array，会显示转换后的JSON或数组结构。

为了安全考虑，浏览器插件默认情况下不允许直接访问本地文件路径（即 file:/// 开头的 URL）。如果您的 RPA 插件需要读取本地文件，您需要在浏览器扩展管理中开启“允许访问文件 URL”的权限。

允许访问文件 URL

扩展管理 -> 九头虫 -> 详细信息 -> 允许访问文件 URL

操作步骤：