通过HTTP触发同步外部订单数据

1. 简介

1.1 案例简介

本文以订单同步为例，通过 Apifox 工具来模拟演示外部系统与智能助手Pro 之间的数据交互过程。即，通过 Apifox 推送订单数据到智能助手Pro 后，智能助手Pro 会接收订单数据，并将其同步新增至简道云表单中。

1.2 设计思路

通过 Apifox 模拟外部系统时，Apifox 与 HTTP 触发方式 下的智能助手Pro 的交互过程下图中灰色部分所示。

主要涉及下述三个环节：

1.3 预期效果

通过 Apifox 向智能助手Pro 的触发地址 URL 推送一条订单数据后，智能助手Pro 便会被触发，接收订单数据并将其同步新增到「销售订单」表中。效果如下所示：

2. 表单设计

新建一张「销售订单」表，用于录入订单的基础信息，字段设置如下所示：

3. 设置智能助手Pro

3.1 新建智能助手Pro

进入「销售订单」表，切换至「扩展功能 >> 智能助手」处，新建一个名为「同步订单数据」的「智能助手Pro」，选择触发方式为「HTTP触发」。

3.2 配置触发地址URL

点击「复制」获取触发地址 URL，并将其配置到 Apifox 中。

3.3 推送测试数据

在 Apifox 中向触发地址 URL 推送一条测试订单数据，包括：订单编号（orderId）、客户编号（customerId）、下单时间（orderDate）、订单明细（items.[]）等信息，用于智能助手Pro 的后续配置。

3.4 获取触发数据列表

Apifox 推送测试数据后，便可在智能助手Pro 中点击「获取示例数据」，来获取测试数据并从中解析出参数列表。

3.5 配置执行节点

上述 3.4 节解析出的参数可用于后续执行节点的配置，以实现订单数据的同步。具体如下：

1）由于智能助手Pro 会将接收到的 “下单时间” 信息转换为文本格式。因此，在同步订单数据前，需要先通过 计算节点 将其转换为日期时间格式。

2）使用新增数据节点，将接收到的订单数据，与转换后的 “下单时间” 信息同步新增到「销售订单」表中。

4. 效果演示

效果参见本文【1.3 预期效果】。