业务流编排变量赋值及函数处理场景

1.      场景描述

将输入的参数值和系统内置的变量通过函数方法进行处理,将处理后的结果按照指定格式返回。

2.      场景分析

服务集成的服务编排可以通过画布的方式,在页面利用拖拉拽将Rest API组件、变量赋值组件、函数处理组件以及HTTP响应组件组合到一起,实现对输入参数和内置变量的函数处理,并通过HTTP响应组件封装返回结果。

3.      示例详细步骤

  1. [服务集成/API工厂/服务编排]页面,单击<新增>按钮,填写服务名称、描述,单击<确定>跳转到设计页面。

  1. 添加工作空间组件。

在设计页面,需要首先拖入左侧基础组件或者单击添加工作空间来开始一个业务流编排,单击画布中基础组件,页面右侧弹出工作空间配置项,在工作空间下拉列表选择一个工作空间来进行关联,如-1所示。

图-1 添加工作空间组件

 

  1. 添加Rest API组件、变量赋值组件、函数处理组件以及HTTP响应组件。

Rest API作为业务流的入口,用来接收外部的输入,变量赋值组件用于添加变量并设置变量值,函数处理组件可以使用函数管理内置的方法对请求体进行处理,HTTP响应组件可以设置响应头和响应体。

  1. 单击Rest API组件,页面右侧弹出配置项,可以配置组件的名称、请求路径、请求方式、请求参数格式、请求头参数、输入参数等。这里配置Rest API组件为POST请求,设置body请求参数,请求参数为一个age参数,如-2所示。

图-2 Rest API组件配置

 

  1. 单击变量赋值组件,页面右侧弹出配置项,可以添加变量名称、表达式类型以及表达式,表达式类型分为简易表达式、JsonPath表达式和XPath表达式。表达式内容可以填写常量,也可以引用前序组件的数据。数据引用请参考联机帮助中数据引用说明。变量赋值的配置如-3所示。

图-3 变量赋值组件配置

 

  1. 单击函数处理组件,页面右侧弹出配置项,可以配置函数表达式和请求数据,单击<编辑>按钮弹出选择函数表达式窗口,可以看到系统中内置的各种函数方法,包括字符串函数、运算函数、日期函数等等,用户也可以在函数管理模块自定义函数来引用。函数表达式窗口如-4所示。

图-4 函数表达式选择窗口

 

  1. 函数处理组件的配置如-5所示,请求数据引用了body体中的参数age以及变量赋值组件的变量name,函数表达式使用了字符串拼接函数。此处需要注意的是,请求体数据必须为JSON格式,且请求体数据中参数名称需要和函数表达式中参数名称对应。

图-5 函数处理组件配置

 

  1. 单击HTTP响应组件,页面右侧弹出配置项,可以配置响应头和响应体,响应体默认返回文本格式,响应体可随意输入,如果需要返回JSON格式,需要在响应头设置Content-Type=application/json,且响应体要符合JSON格式。HTTP响应组件的配置如-6所示。

图-6 HTTP响应组件配置

 

  1. 保存业务流。

在画布的右上角有一个实时告警的图标,图标上带数字,当数字不为0时,表示画布中存在配置不正确的组件。单击该图标,可以查看具体的错误信息。当配置都正确时,可以单击右上角<保存>按钮保存业务流,如-7所示。

图-7 保存业务流

 

  1. 启动业务流

在服务编排列表页面,单击操作列的<启动>按钮,可以启动刚才创建的业务流,启动成功后,业务流的状态变为启动成功,如-8所示。

图-8 启动业务流

 

  1. 业务流在线测试

上面设计了变量赋值和函数处理场景的业务流,将请求体数据和变量赋值的变量通过函数表达式进行处理,通过HTTP响应设置响应体并返回。单击操作列<测试>按钮,进入测试页面,配置请求头,输入参数,单击<调用接口>按钮,查看返回结果,如-9所示。

图-9 业务流测试

 

  1. 业务流注册

业务流测试通过后,状态变为待注册,可以单击操作列<注册>按钮,将业务流注册到[API工厂/API管理]列表中,注册时可以选择API所属目录、是否开启认证以及是否开启健康检查,单击<确定>按钮,完成业务流的注册,如-10所示。

图-10 业务流注册

 

  1. 业务流注册成功后,状态变为已注册,如-11,并且在[API工厂/API管理]列表可以查看该API,如-12所示。

图-11 业务流注册成功状态

 

图-12 API管理列表查看业务流API