运用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),对定位信息进行统一处理后,一次性输出对应参数。

4.字段数据对应

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

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

5.子表记录创建

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

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

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

二、更新运输单状态

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

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

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

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

总结

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

关于明道云

明道云(www.mingdao.com)成立于2013年,位于上海,创始人为互联网知名人士任向晖先生。明道云是一个APaaS平台,帮助企业快速搭建个性化业务应用。用户不需要代码开发就能够搭建出用户体验上佳的销售、运营、人事、采购等核心业务应用,打通企业内部数据,也能够通过API和Webhook和其他系统对接。

明道云的自动化工作流还可以实现审批、填写等控制流程和业务自动化。如果用户企业使用钉钉或企业微信,也可以将明道云搭建的应用直接对接到工作台上。

明道云可以帮助企业大大节省软件费用、降低定制开发的成本和时间,拥有一个极度灵活和易用的数据中台,并提高整体数字化和智能化水平。目前已有上百万用户使用,付费企业超过4000家,典型客户包括:中铁三局、佛山地铁、普华永道、艾瑞咨询、迪卡侬、北京大学、四川航空、上海静安区街道、艾默生电子、西门子、杭州建筑设计研究院、七天四季酒店、希尔顿、凯宾斯基酒店、可口可乐等知名机构。了解更多