如何在服务流程中进行API集成

栏目：云苍穹知识作者：金蝶来源：金蝶云社区发布：2024-09-23浏览：1

如何在服务流程中进行API集成

服务流程是集成云推出的面向复杂集成场景的低代码服务编排工具，把已有的集成对象、集成方案、消息服务、API接口等集成资源，通过流程化设计编排成全新的应用服务，以支持更加复杂的业务场景。

例如基础数据分发到多个系统、数据消费需要从多源取数、基于某个数据参数处理不同的集成过程等等。

为了帮助大家快速掌握服务流程的使用方法，我们将推出系列文章，通过11个典型案例向大家介绍服务流程的高级技巧。

本期，小编先为大家介绍第1个案例：如何在服务流程中进行API集成，包括以下3个要点：

整体业务实现流程
如何注册外部API
服务流程调用API节点的配置方法

1 整体业务流程说明

从源系统的表/实体/视图中定期取数，根据数据类型不同，推送到相应的外部系统API中，数据需要实现增量同步。

整体业务流程图

2 操作流程解析

2.1 如何注册外部API

首先，准备系统连接以及API接口。

在【API集成】→【API登记】→【外部系统API登记】菜单目录下新增外部API。此处登记的API接口URL为“/erp/zb/ajax”。

接着，填写输入参数和输出参数，然后将API启用（API启用后方可使用）。

更多外部API 的使用指南可参考下方资料：

集成服务云_外部系统API使用说明

外部API基本信息

输入参数定义

输出参数定义

2.2 配置服务流程属性和变量

注册好外部API后，需建立编码为“HR_V_BD_PSNDOC_TO_OTHRES”的服务流程。由于需要定期同步数据到外部系统，服务流程的启动方式需设置为“定时启动”。

服务流程基本信息配置

将不同类型的数据推送到不同系统，需要定义变量以接收从数据库表获取的数据，例如定义为：“t_v_bd_psndoc_erp_lg”。

流程变量定义

在【依赖资源】下将数据表(V_BD_PSNDOC)、外部API(erp_webapi_zb)作为资源引入服务流程中，如图所示。

依赖资源引入

2.3 配置服务流程节点

完成服务流程属性和变量的配置后，需配置服务流程节点。配置的整体服务流程图如下，包含定时配置、数据获取节点、API调用节点。

整体服务流程图

2.4 设置定时任务

双击流程图中的“开始节点”，根据实际需求配置指定的定时频率，如“每天”，如下图所示。

定时配置节点

2.5 配置服务流程取数节点

根据数据类型的不同，将相应数据推送到外部API。首先，配置取数字段，然后在【过滤条件】页签配置类似“NOW-1小时”的条件来实现增量数据的过滤。

数据表取数

2.6 添加API调用节点

API调用通过脚本实现，脚本中的“erp_webapi_zh”为外部API的别名，也将作为函数名在脚本中调用。外部API的输入参数包括data, controller, action，将参数依次填入，通过返回结果的code判断是否成功。

参考脚本

具体代码如下：

var data = t_v_bd_psndoc_erp_lg;
var controller="zbjcDu01Func";
var action="S";
if(data.length > 0) {
    result_erp_lg=erp_webapi_zb(data, controller, action);// 调用外部API
    if(result_erp_lg.code == "ERROR") {
        throw result_erp_lg;
    } 
} else {
    result_erp_lg = "没有数据更新"；
}