在 Excel 中使用查找和替换文本 n8n 行动
PDF4me 在 Excel 中替换文本 通过以下方式在 Excel 文档中实现全面的搜索和替换操作 n8n 自动化工作流程,可选配格式化应用程序。通过以下方式处理 Excel 文件 n8n 触发器、二进制数据、base64 字符串或公共 URLs 可使用文本匹配或正则表达式 (regex) 替换文本,支持区分大小写匹配、全单元格或部分匹配、单次操作替换多个短语,以及可选的格式更改(字体、颜色、大小、粗体、斜体、下划线、删除线、下标、上标)。此解决方案非常适合数据标准化、内容更新、错误纠正、自动文本转换和隐私掩码工作流程,这些工作流程需要在所有工作表中进行文本替换,并提供全面的格式控制和无缝集成。
相关博客文章
目前尚无关于此功能的博客文章——敬请期待。
在此期间,您可以浏览 PDF4me 博客,查看适用于各平台的教程和工作流程。
访问博客 →
设置
添加 PDF4me 将您的“替换文本”节点添加到您的 n8n 工作流程并配置所需参数。有关初始设置说明,请参阅我们的 n8n 集成指南。
先决条件:
- PDF4me API 证书
- n8n 工作流访问
配置:
- 添加 PDF4me 节点到工作流
- 选择“查找和替换文本”操作
- 配置输入参数(见下文)

参数
以下是“替换文本”操作的完整参数列表。配置这些参数可以控制文本替换。
重要的: 标有星号 (***) 的参数为必填项。此操作会处理 所有工作表 在Excel文件中。
| 范围 | 类型 | 描述 | 例子 |
|---|---|---|---|
| 输入数据类型*** | String | Excel 输入格式选择 • 选择 Excel 数据输入格式 • PDF4me 支持多种输入类型 • 选项:二进制数据, Base64 字符串,或 URL | Binary Data |
| 输入二进制字段*** | 二进制 | 二进制Excel文件输入 (二进制数据必填) • 参考之前的 Excel 文件(.xlsx、.xls)。 n8n 节点或文件上传 • PDF4me 处理具有自动格式检测功能的二进制 Excel 文件 • 当输入数据类型为“二进制数据”时为必填项 | {{ $binary.data }} |
| Base64 Excel 内容*** | String | Base64 编码后的 Excel 输入 (如果是 Base64 字符串则为必填项) • 提供以 base64 编码字符串形式保存的 Excel 内容(.xlsx、.xls)。 • PDF4me 自动解码和处理 Excel 内容 • 当输入数据类型为“Base64 字符串”时为必填项 | UEsDBBQABgAI... |
| Excel URL*** | String | 公共 Excel URL 输入 (如果是 URL,则为必填项) • 提供公开/开放权限 URL 导出到 Excel 文件(.xlsx、.xls) • PDF4me 从提供的目录中下载并处理 Excel 文件。 URL • 当输入数据类型为“URL”时为必填项 | https://abc.com/data.xlsx |
| Excel 名称*** | String | Excel 输入文件名 • 请指定输入Excel文件的名称,并带有正确的扩展名(.xlsx、.xls)。 • PDF4me 此功能用于格式检测和处理优化 | data.xlsx |
| 短语*** | String | JSON 替换操作数组 • JSON 包含 ReplacementPhrase 对象数组的字符串 • 每个对象: 搜索文本* (细绳), 替换文本* (字符串,可以为空以删除) IsExpression (布尔值,默认值:false - true = 正则表达式,false = 字面文本) 区分大小写 (布尔值,默认值:false), 匹配整个单元格 (布尔值,默认值:false - true 表示整个单元格匹配,false 表示部分匹配), 格式化 (文本格式对象 - 可选:字体名称、字体颜色、字体大小、粗体/斜体、下划线类型、删除线类型、脚本类型等。) • 必须至少包含一个短语 • 按数组顺序依次处理 • 匹配:字面文本使用字符串比较;正则表达式支持模式和分组($1,$2) | [{"SearchText":"old","ReplacementText":"new"}] |
| 二进制数据输出名称*** | String | 二进制数据输出映射 • 定义用于访问生成的 Excel 二进制数据的变量名 • 用于后续工作流程操作 • 对工作流程自动化至关重要 | document |
输出
输出参数
| 范围 | 类型 | 描述 | 例子 |
|---|---|---|---|
| 文件名 | String | 替换文本后的 Excel 文档文件名 - 文本替换后输出的 Excel 文档文件名 | excel_replaced.xlsx |
| 文件大小 | 数字 | 文件大小(字节) - 文本替换后 Excel 文档的大小(以字节为单位) | 212808 |
| 成功 | Boolean | PDF4me 运行状态 - Boolean 指示文本替换过程成功或失败的标志。 PDF4me 返回 true 为了成功运营和 false 任何错误 | true |
| 原始文件名 | String | 原始 Excel 文档文件名 - 输入的 Excel 文档文件名 | myExcelFile.xlsx |
| 操作计数 | 数字 | 更换手术次数 - 已处理的替换操作总数 | 1 |
| 运营 | Array | Array 替换操作 - Array 包含有关每次替换操作的详细信息的对象,包括 searchText、replacementText、isExpression、matchEntireCell、caseSensitive 和 formattingApplied。 | [{"searchText": "old ", "replacementText": "New", "isExpression": false, "matchEntireCell": false, "caseSensitive": false, "formattingApplied": false}] |
| 文化名称 | String | 文化/地方规范 - 用于文档处理的区域代码(例如,“en-US”、“de-DE”、“fr-FR”) | en-US |
| 信息 | String | 操作消息 - 描述性消息,指示文本替换操作的结果,包括已完成的操作次数。 | Text replacement completed successfully with 1 operation(s) |
N8N 行动反应
这 PDF4me 查找并替换文本 API 返回的结果可以以多种格式查看。请选择最符合您需求的视图:
- JSON
- Table
- Schema
- Binary
JSON 回复格式
原始 JSON 来自……的回应 API:
[
{
"fileName": "excel_replaced.xlsx",
"fileSize": 212808,
"success": true,
"originalFileName": "myExcelFile.xlsx",
"operationsCount": 1,
"operations": [
{
"searchText": "old ",
"replacementText": "New",
"isExpression": false,
"matchEntireCell": false,
"caseSensitive": false,
"formattingApplied": false
}
],
"cultureName": "en-US",
"message": "Text replacement completed successfully with 1 operation(s)"
}
]
表格视图
以结构化表格格式呈现的响应数据:
| 范围 | 价值 |
|---|---|
| 文件名 | excel_replaced.xlsx |
| 文件大小 | 212808 |
| 成功 | true |
| 原始文件名 | myExcelFile.xlsx |
| 操作计数 | 1 |
| 运营 | Array 替换操作对象 |
| 文化名称 | en-US |
| 信息 | Text replacement completed successfully with 1 operation(s) |
操作数组详情:
| 范围 | 价值 |
|---|---|
| 搜索文本 | old |
| 替换文本 | New |
| isExpression | false |
| 匹配整个单元格 | false |
| 区分大小写 | false |
| 应用格式 | false |
架构视图
响应的数据结构和类型:
1 item
fileName: T excel_replaced.xlsx
fileSize: # 212808
success: ☑ true
originalFileName: T myExcelFile.xlsx
operationsCount: # 1
operations: [] Array
[0]: {} Object
searchText: T old
replacementText: T New
isExpression: ☑ false
matchEntireCell: ☑ false
caseSensitive: ☑ false
formattingApplied: ☑ false
cultureName: T en-US
message: T Text replacement completed successfully with 1 operation(s)
类型指示器:
T= String (文本)#= 数字☑= Boolean[]= Array
二进制数据视图
实际的Excel文档文件数据和元数据:
data
─────────────────────────────
File Name: excel_replaced.xlsx
File Extension: xlsx
Mime Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
File Size: 212.8 kB
二进制数据访问:
- n8n 二进制对象:
$binary.data.data - Base64 内容可直接使用
- 文件操作可供下载、通过电子邮件发送或存储
笔记: 无效短语会被记录为警告,但不会停止处理。其他有效短语仍会继续处理。
用例
数据标准化和格式转换
- 将 Excel 文档中不一致的值替换为标准格式
- 将日期、电话号码或标识符转换为标准格式
- 规范货币符号和数字格式
错误更正和内容更新
- 自动修复拼写错误和数据录入错误
- 更新多个工作表中的产品名称、价格或状态值
- 修正常见的拼写错误和格式不一致之处
隐私掩蔽和数据保护
- 为对外共享,请将敏感数据替换为掩码值。
- 面具 PII 使用正则表达式模式的(个人身份信息)
- 应用数据匿名化技术以满足合规性和隐私要求