运用API，实现跨组织应用数据自动同步

文/刘明菲

编辑/麦壁瑜

前言

明道云APaaS平台为具有开发能力的用户提供了API接口，可以将工作表和其他系统进行数据对接，将外部数据写入到工作表中或读取工作表中的数据。

如果您和您的合作伙伴恰好都在使用明道云来管理公司业务，那么明道云开放、标准的API接口将为您和您的业务伙伴带来极大的便利。即使是开发小白，也可以借助明道云API，快速实现两个不同组织下应用简单的数据同步与更新，节省人力沟通成本，提高效率。

本文将从一个实际场景切入，带您了解明道云API的使用及工作流的配置方法。只要您了解明道云的基础功能，不需要开发能力，也能快速掌握！

场景例举

某设备销售公司有固定合作的运输公司，发货时需要创建设备运输单，派单至运输公司。运输公司接单后完成设备运输，并将运输过程的相关信息返回至设备销售方。具体流程见下图。

图中标红的几个流程需要用到API接口。明道云提供了10种数据接口，基本满足数据的所有操作场景。上述场景的数据流转里，我们主要用到“新建行记录POST”和“更新行记录详情POST”两个接口。

表单及工作流配置

一、派单创建运输单

1.工作表搭建

首先需要在两个应用中搭建结构基本一致及字段相对应的工作表，包含运输信息及运输设备明细（子表）。

为了后续数据同步及更新，在运输公司的运输单中可增加一个字段存储源数据记录ID（设备销售公司应用中的记录ID）。

在表单配置中，为字段设置别名，方便后续发送API请求节点使用中进行识别对应，可一键批量生成。

2.工作流webhook节点配置

在设备销售公司的应用中配置相关工作流，点击按钮，向运输公司应用的工作表中新增一条记录。我们先来创建运输单主表记录。

按钮触发后添加发送API请求节点，发送自定义请求(POST方式)，在运输公司应用的API开发文档中找到对应表单的新建行记录请求URL地址，填写进去。

Body中的参数提交格式选择raw(application/json)，下方参数可直接复制API文档右侧提供的值，保留需要的部分即可。

3.特殊数据处理

根据字段说明，需要对先对定位、附件字段做一下数据处理。

若附件通过url地址写入，需要获取附件的url链接，此处要用到代码块节点，具体操作方式可参考社区文章：如何获取附件中图片、文件的URL。涉及多个附件时，可将返回的url链接数组拆分写入到文本字段中再进行使用。

定位信息可直接通过工作流中的函数运算节点获得，此处可借助封装业务流程(PBP)，对定位信息进行统一处理后，一次性输出对应参数。

将发送API请求节点中字段参数的值修改为我们想要对应的数据或字段值即可。

现在我们来测试一下。点击按钮后，运输公司的对应工作表中会增加一条由API创建的运输单。

5.子表记录创建

接下来我们还需要创建运输设备明细。在工作流中批量获取明细后添加子流程，通过API在运输公司应用中创建运输设备明细。这里需要将上一步发送API请求节点返回的data值作为子流程参数（此处的data值即为运输公司应用中新增运输单的行记录ID），以便将新增的运输明细与运输单关联对应。

子流程中添加发送API请求节点，向运输明细工作表中新增行记录。配置方法与前文相同，注意将关联字段参数的值设为流程参数。

至此，整个流程就配置完成了。再次测试，运输单就通过API完整创建过来。

二、更新运输单状态

运输公司接单后，设备销售方的运输单原始单据状态发生变更，这里用到“更新行记录详情POST”接口。

工作流触发后，添加发送API请求节点填写相应信息即可。注意此处行记录ID值的设置：前文中我们已经将原始单据的记录ID创建到运输单中，此处直接取用即可，同时对应好需要更新的字段值。

我们来看一下效果。点击接单按钮后，设备销售方应用中的原始单据状态会发生相应改变。

第三个流程配置方法与第二种类似，此处不再赘述。

总结

通过明道云开放API实现跨组织应用数据实时同步，帮助企业快速链接上下游业务，节省人力沟通成本，降低人工录入数据出错的可能性，提高业务数据更新的时效性，如果您和您的合作伙伴都在使用明道云，不妨找一些业务场景来尝试一下吧！

API 封装业务流程