三方服务

1.简介

将外部各个分离的系统服务进行集成，集成后的服务以逻辑流调用的形式在低开平台的搭配下能彼此有机地和协调地工作， 以发挥整体效益，达到整体优化的目的。

2 服务集

三方服务以服务集的形式引入，服务集具备新建、删除、修改、刷新，导入，导出等功能。

2.1 创建服务集

在【三方服务】模块内，点击创建服务集。三方服务接口的读取有两种方式：

方式一：通过输入swagger的url读取三方服务接口信息。

输入swagger的url地址，点击下一步(注：这里输入的url是swagger的json文本地址)；

系统读取出swagger服务接口信息，在弹窗列表中展示出。

勾选需要导入进来的三方服务接口，点击下一步按钮。

输入必填项服务集编码与服务集名称，服务地址填写引入的三方服务的所在地址，地址格式为：http://{ip}:{port}。

创建服务集时，可选择配置依赖系统的认证方式，支持三种基本认证方式。

1.API Key认证：输入Key与value值添加进外部系统的Header或Query Params中完成系统认证

2.Bearer Token认证：输入Token值进行外部系统认证

3.Basic Auth认证：输入Username与Password值完成外部系统认证

填写完以上信息后，点击确定即可完成服务集的创建。

依次展开服务集中的服务和实体模块可以看到引入的三方服务的接口以及接口传参实体信息。

方式二：通过导入swagger的json文件引入三方服务接口信息。

创建服务集是选择以文件上传的形式，点击选择文件按钮上传三方服务的swagger接口json文件，上传完成后点击下一步

弹窗列表展示出三方服务接口信息后，剩余步骤与方式一一致。

2.2 导出服务集

右键服务集名称，点击导出服务集即可导出当前服务集。

2.3 导入服务集

点击创建服务集图标，选择导入服务集，导入服务集文件即可。

2.4 修改服务集

右键服务集，点击修改服务集，弹出服务集详细信息即可修改，点击确定保存修改信息。

2.5 删除服务集

右键服务集，点击删除服务集，确认删除后即可。

3 服务集使用

3.1 服务实体创建

打开构建包，在实体中创建一个数据集，将右侧服务集下的实体拖动到数据集编辑区中，三方服务的数据实体都是以服务实体的形式存在，点击保存当前数据集。

在构建包中的服务-通用服务模块，创建一个名称为教师新增服务的逻辑流，双击空白面板将入参设置为刚刚数据集中创建的teacher实体。

3.2 服务接口编排

将三方服务下教师服务集中的新增教师服务拖动至逻辑流编辑面板中，并配置好连线。

双击新增教师rest图元，打开rest图元配置弹窗，远程url是根据导入服务自动生成，无需修改，将接口入参填充为逻辑流中定义的入参teacher，值类别设置为变量，点击确定关闭弹窗，并保存逻辑流。

3.3 服务接口测试

点击执行图标，打开执行服务弹窗，填充入参后，点击执行，查看执行结果，返回中携带三方服务中定义好的返回值add success !表示三方服务调用成功。

4 服务参数变量替换

此外三方服务-服务集中服务地址，认证方式等参数支持变量替换，可以使用系统变量，应用系统变量，逻辑流内置变量来替换服务集配置参数。

右键服务集，点击修改服务集，打开服务集修改弹窗，将服务地址修改为系统变量中定义好的变量，写法是${systemVars.threeServiceUrl}, systemVars为系统变量对象，threeServiceUrl为变量编码; 应用系统变量和逻辑流内置变量与其一致，分别为${appSystemVars.应用系统变量编码}、${bizVars.逻辑流变量定义名称}。