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

关于HAP

HAP(Hyper Application Platform)超级应用平台可以帮助用户零代码构建企业应用,用户不需要代码开发就能够搭建出用户体验上佳的销售、运营、人事、采购等核心业务应用,打通企业内部数据。HAP还具备超自动化引擎,可以全面自动化复杂和重复的业务流程。运用HAP的集成中心与完整的API对接能力,用户可以轻松地将HAP与外部系统集成。除此之外,HAP还具备很高的可组合性,国际化支持,并支持云原生架构,实现了多云部署能力。通过插件架构,HAP正在逐步建立起繁荣的实施与开发生态。

HAP可以帮助企业大大节省软件费用、降低定制开发的成本和时间,拥有一个极度灵活和易用的数字化平台,是企业数字化建设的重要工具。目前已有上百万用户使用,付费企业超过4000家,包括可口可乐、复星集团、广汽本田、赛力斯汽车、中国移动、中石化、中铁集团、银鹭食品、民生银行、迪卡侬、艾默生电气、泰科电子、四川航空、东方证券、洲际酒店、科大讯飞、柳工集团、沃尔玛、中国烟草、三菱银行等知名客户。

2021年5月,明道云获得海纳亚洲近亿元投资。公司目前有超过130名员工,产品研发团队过半,总部位于上海漕河泾开发区,在北京、广州、深圳、成都、郑州、武汉、西安和宁波设有分支机构。公司为高新技术企业,上海市专新特精认定企业。