数据转换

数据转换操作，用于对集合进行筛选、映射和分组。

使用各种操作转换数据。“数据转换”节点及其各个操作节点（筛选、映射、分组依据）在节点面板中作为单独的可选节点提供。

何时使用数据转换与脚本

当要对集合进行字段级操作的转换时，请使用数据转换操作。可用操作包括：

• 筛选
• 映射
• 分组

当转换需要条件逻辑、算术或字符串操作，或者没有专用操作涵盖该案例时，请使用“脚本” 。两者可以结合使用：数据转换操作可以筛选或调整集合形状，然后将结果传递给脚本节点。

输出

所有数据转换操作节点均将其结果输出为output ，下游可通过$vars.<nodeName>.output访问。

筛选

仅保留集合中符合您的条件的条目。

配置

字段	必填	描述
输入	是	要筛选的集合 (数组)。引用为$vars.<nodeName>.output 。
条件	是	一个或多个条件。仅当所有条件都满足时，才会保留条目。

示例

仅保留status为"completed"的订单：

• 输入：$vars.fetchOrders1.output.body
• 条件： status等于completed

输出可用作$vars.filter1.output 。

Map

通过修改或调整集合中的每个条目的字段，来转换集合中的每个条目。

配置

字段	必填	描述
输入	是	要转换的集合（数组）。
字段映射	是	对于每个目标字段，请定义名称以及源字段或表达式。

示例

将firstName和lastName字段重命名为first和last ：

目标字段	来源映射
first	firstName
last	lastName

输出可用作$vars.map1.output 。

分组依据

按共享字段对集合进行分组，并聚合总计、平均值或计数等值。

配置

字段	必填	描述
输入	是	要分组的集合（数组）。
按字段分组	是	其值决定了该字段所属的组。
聚合	否	每组的其他计算字段（计数、总和、平均值、最小值、最大值、第一个、最后一个、集合）。

示例

按region对订单列表进行分组，并计算每个区域的订单数：

• 输入：$vars.fetchOrders1.output.body
• 分组依据： region
• 聚合： orderCount = 计数

输出可用作$vars.groupBy1.output 。

常见问题

问题	分辨率
筛选后输出为空	条件与任何条目均不匹配。检查执行追踪记录中的输入集合，以验证字段名称和值。
映射输出包含undefined字段	输入条目中不存在源字段路径。使用执行追踪记录来确认输入结构。