龙空技术网

8月iPaaS新功能上线,菜单结构与连接器迎来重大升级!

得帆云 60

前言:

今天小伙伴们对“菜单结构分析”大约比较关怀,看官们都需要了解一些“菜单结构分析”的相关资讯。那么小编也在网上汇集了一些有关“菜单结构分析””的相关文章,希望看官们能喜欢,小伙伴们一起来学习一下吧!

好久不见,8月得帆云iPaaS又发布了诸多新功能特性。

本次更新除了新增RabbitMQ消息集成管理等功能外,还大幅优化改进了菜单结构连接器功能,旨在进一步提升集成效率及用户使用体验。哪个功能最好用?哪个功能最有用?快来一起GET新体验!

01

菜单结构优化

为解决原有菜单结构较为“臃肿”、功能查找较为不便等问题,本期更新对后台管理菜单结构进行了精简化改造,根据使用场景和使用频率对菜单进行了合并重组,新菜单结构及定位如下:

管理门户:重要监控数据概览;集成中心:API需求、设计及开发等功能;运维监控:API日志及监控报表等功能;基础设置:API关联配置信息总览及设置,包括连接器资源、策略、数据字典等信息;插件中心:控制特色功能插件的开关和使用;系统设置:用户、角色等租户层配置设置,一般由租户管理员进行管理。

本次优化后菜单数量也从原来41个二级菜单精简为21个,对旧版本菜单的主要整合点如下。

异常维护:合并入「API日志」菜单;对于失败且未匹配到异常知识的日志,支持直接在日志列表操作中选择「添加异常知识」;业务状态管理:合并入「API策略」菜单;移入业务状态策略类型卡片,可通过「业务状态库」入口进入原管理页面;批量发布:合并入「API开发」菜单;通过顶部「定时批量发布」图标入口可进入原管理页面;API调用统计、统计报表、关系图、API编排引擎监控、服务器资源、控制台日志:合并入新菜单「API监控」,可通过顶部切换tab页查看不同维度的报表;路由管理:「透传至下游」功能合并入「API开发-代理透传-基本定义」配置项;证书管理:合并入「环境管理」;支持在环境详情抽屉中维护平台证书信息;编排模板管理、常用模板管理:合并入新菜单「模板管理」,可通过顶部切换tab页查看不同维度数据;请求头规范、系统编码规范、错误码规范:合并入新菜单「规范管理」,可通过顶部切换tab页查看不同维度数据。菜单管理、自开发资源:以「自定义菜单」插件形式融合至「插件中心」菜单,插件开启后出现菜单管理页面。

02

RabbitMQ消息集成管理

本次更新后,系统新增RabbitMQ消息集成管理功能,用户可以轻松地使用iPaaS系统实现RabbitMQ的集成与管理、可视化测试发布消息、以及订阅消息的应用效果,并无需借助第三方管理工具。

场景示例:

编排RabbitMQ消息订阅接口,在接口上线前通过系统测试监听效果。

1)进入消息队列管理:编排一个RabbitMQ订阅消息接口,选择监听目标RabbitMQ数据源后点击消息队列管理,进入管理页面。

「RabbitMQ订阅消息-消息队列管理入口」

2)新建队列、发布消息:在管理界面新建一个队列并将该队列绑定在某一个交换机上,再往该队列中发布消息,来测试订阅消息效果。

新建队列:切换至队列Tab页,点击添加,新建一个名称为Test的队列;

「队列-创建队列」

绑定队列:切换至交换机Tab页,将该队列绑定在已有交换机下;

「交换机-添加绑定」

发布消息:发布消息至目标队列,配置消息发送内容及Header等参数;

「消息队列管理-发布消息」

查看消息:展开Test队列,查看该队列下未被消费消息;内容过长时,支持点击“消息详情”查看完整内容。

「消息队列管理-查看消息」

3)配置RabbitMQ-订阅消息节点:订阅Test队列之后再使用日志记录组件打印前置节点订阅的消息;编排完成后发布该接口。

「API编排-RabbitMQ订阅消息接口」

4)查看日志:当队列存在待消费消息,API会被主动触发并执行后续业务流程,可在调用日志查看触发记录,点击某条记录可查看具体消费内容。

「API运行实例-监听内容」

5)查看消息数量:查看当前队列消息的消息数量(消息总数、待消费数量、待确认数量),确保消息已被消费。

「队列-查看消费数」

03

连接器功能升级

安全、复杂场景集成大提升

1)HTTP连接器

新增HTTPS认证设置

针对HTTPS接口,iPaaS支持在环境管理菜单中添加、管理客户端和受信任的外部证书。API编排HTTP连接器新增HTTPS认证设置,配置所需证书用于发送请求时启用身份验证。

场景示例:某公司需要在iPaaS系统中接入一批使用相互 TLS (mTLS) 的 API,接口所需的客户端和服务端证书都属于自签名证书,需要先在iPaaS添加客户端证书和受信任的外部证书。

注:相互 TLS 是一种身份验证方法,要求客户端和服务器都使用证书确认其身份。一旦双方的身份得到确认,就会建立加密连接。

(1)集成证书:在环境管理详情-证书中上传所需证书。为了防止出现自签名证书错误,该接口不仅需要在平台密钥库中上传客户端证书,还需上传外部证书。

平台密钥库:输入证书名称、域名、证书和密钥等。

「环境详情-添加平台密钥库」

外部证书:输入证书名称及证书内容,系统会自动解析颁发对象、颁发者、起始有效期和终止有效期字段展示在列表上。

「环境详情-添加外部证书」

(2)接口上配置证书:HTTP连接器-基础配置上填写接口信息后再点击「高级配置」,HTTPS证书配置-认证方式选择「双向认证」,再选择步骤一中上传的证书。

「HTTP连接器-高级配置-HTTPS证书设置」

(3)测试调用效果:发布API后,系统内点击调试查看效果。

「API调试效果」

2)RabbitMQ连接器优化

场景示例:订阅RabbitMQ消息调用一个下游API,当下游API执行成功后,消息确认出队;当下游API执行失败时,消息回滚重新入队。并将异常信息通过消息发布路由到另一个交换机中,方便后续异常信息的排查。

特殊要求:

订阅消息需支持多消费者订阅,确保多线程消费消息;异常信息在传输过程中不能丢失,需要保证消息能正确交付到队列。

(1)编排订阅RabbitMQ消息接口:

配置订阅消息节点:订阅消息需要手动ACK机制,所以自动ACK配置项需选择“否”。为确保多线程消费消息,按需配置消费者数量即可。

「订阅消息-高级配置」

下方添加HTTP连接器,用于调用下游API。通过异常捕获判断下游API执行情况,当下游API执行成功时,手动确认消息。下游API错误执行后,捕获该异常后手动拒绝消息,并选择重入队列。

「手动拒绝-基础配置」

异常信息发送至目标队列:基础配置中配置交换机名和路由及消息内容,高级配置中需要配置消息保证交付到队列保证异常信息的正常传输。确认超时时间可根据场景配置,本次使用系统默认值。

「发布消息-基础配置」

(2)测试效果:

当下游API正常执行时,消息已被成功消费。

「下游API正常-日志查看」

当下游API执行出现异常时消息重入队列,并发送至目标队列,查看日志及目标队列中的异常消息。

「下游API异常-日志查看」

「查看目标队列中异常消息」

3)数据库连接器支持

本地事务&分布式事务

数据库连接器如插入、更新、插入且更新、删除等连接器支持本地事务和分布式事务。本地事务针对单个组件,只有该组件报错时才支持将事务进行回滚。分布式事务针对整个编排,若编排中有组件发生异常,支持将事务进行回滚,保持事务一致性。

场景示例:某公司需要将A数据库中的数据删除,并调用已有接口将删除的数据备份至B数据库中。

「原数据」

(1)本地事务:本地事务默认启用,拖入MySQL-删除连接器,选择未启用分布式事务的数据源,并拖入HTTP连接器调用已有接口。

「未启用分布式事务」

「 MySQL-删除:本地事务」

此时HTTP连接器节点异常导致API调用报错,但MySQL-删除连接器调用正常,仍能正常删除数据。

「本地事务-调用结果」

(2)分布式事务:在基础设置-连接器资源中维护数据源时,打开「是否开启分布式事务」开关,编排时需选择已启用分布式事务的数据源。需确认维护的数据源在数据库端是否也已开启分布式事务。

「启用分布式事务」

「 MySQL-删除:分布式事务」

此时HTTP连接器发生错误导致API调用报错,MySQL-删除通过分布式事务实现数据库事务回滚,数据删除失败。

「分布式事务-调用结果」

4)Oracle存储过程优化

Oracle存储过程连接器支持调用内部自定义类型的存储包(PKG),如基于record的table类型、基于record嵌套record的table类型。

场景示例:

(1)基于record的table类型:选择已定义好的存储过程PK_PRO2,该存储过程为输入table1类型参数P1,从表WATER_LEVEL中获取ID、NAME的值,将其输出为table1类型的参数NN。

table1为基于record1的table类型。

「基于record的table类型」

「基于record的table类型-调用结果」

(2)基于record嵌套recoed的table类型:选择已定义好的存储过程PK_PRO4,该存储过程为将输入的table2类型参数P1赋值给同类型的参数NN直接输出。

table2为基于record2的table类型;record2为基于int型ID2和record1的recoed类型。

「record嵌套record的table类型」

「record嵌套record的table类型-调用结果」

5)数据映射新增变量收纳功能

数据映射新增变量收纳功能,用户主要聚焦body数据结构,若在场景中需要使用到前置节点变量,可通过“添加已有变量”、“自定义变量”方式添加目标变量,进行变量的结构映射。

「API编排-数据映射」

(1)添加已有变量:点击vars下方“添加已有变量”按钮,在编排已有变量中选择数据映射所需变量,支持全选。

「数据映射-添加已有变量」

(2)添加自定义变量:进行数据映射时,发现当前无满足的变量结构,可通过自定义变量在数据映射节点实现变量名称和结构定义。

添加完成后,变量名称置灰,标志为虚拟变量,需在前置节点通过「设置变量」组件实现变量的定义。

「数据映射-添加自定义变量」

「自定义变量-定义数据结构」

04

API编排优化

本次针对API编排的易用性和数据结构定义进行优化,提升接口编排的流畅度。

1)编排易用性提升

新增使用说明:降低连接器的使用难度,部分连接器新增使用说明,支持点击“更多帮助”跳转帮助文档。

「API编排-手动确认」

支持基于已有编排逻辑切换触发方式:点击头节点右侧icon,在弹出框中选择所需触发类型,支持搜索和分类筛选功能。

注:切换类型仅改变头节点,不影响中间编排流程。

「API编排-切换触发类型」

2)数据结构定义优化

支持定义基础数组:支持定义数组对象或基础数组,当类型选择array时,数组下方会自动生成items虚拟节点,通过定义items类型,表示当前数组结构。

「API编排-定义数据结构」

「API编排-数据结构显示」

支持定义xml标签:支持定义数据结构中body、items的XML标签。

点击右侧的“设置”icon,在界面弹出框中输入XML标签名,标签名会直接拼接在body和itmes右侧展示,效果如下图所示。

「定义数据结构-设置XML标签名」

点击确定后,数据结构会自动展示已设置的标签名。

「结构变量定义-节点输出」

API发布后,接口请求、响应示例及WSDL说明文件中XML标签名会作为单个层级。

「API运行列表-请求示例」

「wsdl文件地址」

05

策略模块优化

1)新增OAuth2认证策略

本次新增「OAuth2认证」策略,支持基于Token进行身份认证。

场景示例:某公司业务系统希望在不改变原有业务系统授权认证方式且不影响原有厂商调用的基础上,在iPaaS平台接入一批含OAuth2认证的接口,接入完成后希望通过iPaaS对该接口添加OAuth2鉴权,实现接口的统一管理。

(1)新建OAuth2认证策略:在策略管理菜单中新增OAuth2认证策略,定义OAuth2认证的Token参数名和Token过期时间。

新建应用系统时会预置一个Token参数名为Authorization、Toekn过期时间为7200s的OAuth2认证策略。

「策略管理-OAuth2认证策略」

「新建OAuth2认证策略」

(2)消费者调用凭证迁移:消费者管理-调用凭证中新增OAuth2凭证模块,支持将原有调用方系统及其调用凭证维护进iPaaS系统。

新建消费者时系统会自动为该消费者生成一个OAuth2认证的调用凭证,也支持用户自行新建凭证。

「调用凭证-OAuth2认证」

(3)实现效果为API绑定上述OAuth2认证策略,绑定后需要传输token才能成功调用该API。

可在「运行列表-调用方法」处查看OAuth2认证的调用方式、生成Token结果及调用代码示例。

「运行列表-OAuth2调用方法」

「绑定OAuth2认证策略:调用结果」

2)业务关键字策略

新增快速配置模式

为简化业务关键字策略配置,方便用户快速操作,本次业务关键字策略新增「快速配置模式」,在配置业务关键字策略时可直接选择业务关键字库中已维护的关键字,且支持直接添加。

场景示例:某公司已在iPaaS平台集成70+个API,已集成的多个API中都使用了业务关键字订单编号OrderID。为方便查看该订单的业务信息,希望调用API时系统自动匹配业务关键字将其作为单独字段显示在调用日志列表。

(1)配置业务关键字策略:新建策略时默认为快速配置模式,点击“添加”可选择业务关键字库内已维护的关键字,若无想要的关键字,可直接点击底部的“立即添加”新增。实际匹配时将第一个匹配到的参数值作为关键字内容。

对于当前用户自己创建的关键字,支持直接在当前页面删除。业务关键字设置标题右侧增加模式切换功能,支持将快速配置模式切换为「精准匹配模式」。

「业务关键字策略-快速配置模式」

「创建业务关键字」

(2)实现效果:完成上述配置后,调用API生成调用日志时,系统会自动匹配业务关键字并返回值,将其作为单独字段显示在调用日志列表。

「配置业务关键字效果」

(3)在业务关键字库中管理业务关键字:点击「策略管理」,从业务关键字卡片上方的「业务关键字库」进入,可管理该租户下所有在业务关键字策略-快速配置模式维护的关键字。

「业务关键字库入口」

「业务关键字库」

06

插件中心优化

为适配iPaaS后台管理菜单简化,并区分插件使用视角,本次插件中心优化以下内容:

1)使用视角:

支持查看当前租户下插件使用说明;针对插件情况,卡片右上角设有三种icon:

当插件被禁用,则为“禁用”icon,需联系租户管理员开启使用;当插件功能为系统某处启用部分功能,则为“提示”icon,移入气泡提示该功能所处位置;当插件功能为系统菜单功能,则为“进入”icon,点击进入功能页面。

「插件中心-使用视角」

「插件中心-灰度策略Tab页」

2)管理视角:

新增插件配置Tab,支持租户管理员配置当前租户启用的插件功能。

平台启用插件:迁移原有插件上添加、启/禁用、删除等操作,并新增“以菜单显示”功能,支持设置具备菜单页面插件启用后是否要显示在左侧主菜单栏。

「插件中心-插件设置」

平台未启用插件:需联系平台超级管理员启用。

07

新增插件-调用链路追踪

企业各业务系统内或各业务系统之间的API常常存在依赖关系,当某API报错后,可能需要排查多个API的调用日志来定位错误位置,费时费力且易遗漏。因此本次新增「调用链路追踪」功能,支持根据关键字检索全局日志自动生成接口之间的链路关系,便于快速定位失败环节,提高排查效率。

场景示例:

某公司已通过引用密钥校验API和数据同步API创建了一个同步用户数据到数据库并备份到其他数据库的API。运维人员发现该API中userid为define001的日志报错,需要排查是否由于另外2个API调用失败导致报错,从而快速定位问题。

1)调用链路入口:在插件中心开启「调用链路追踪」插件后,日志列表和详情页会出现调用链路入口,选择userid为001的失败日志进入调用链路追踪弹窗。

「调用链路入口」

2)调用链路追踪弹窗:在输入框中输入失败日志的traceid并查询,可将全租户日志报文中包含traceid的API查询出来,并自动生成链路,可以非常清晰的看到各API关联日志的调用结果等信息,检索其中包含失败日志的API就可以定位错误位置。

除上述「异常排查」场景外,还支持输入业务数据关键词对「业务数据流向」进行追踪,如需查看orderid为define001的订单数据流向,可在搜索框中输入define001进行查询。

「调用链路追踪弹窗」

「查看详情:API详情页-调用日志」

08

API公开市场改造

API公开市场新增同场景多个API组合上架的功能,该组合称为API服务。市场用户上架API时,新增发布为新服务、发布至有服务功能。市场用户购买时,以API服务为单位进行购买,购买后,可针对单个API进行测试调用。

场景示例:

某企业拥有天气查询API和地理位置查询API,两个API需要组合使用。因此在市场上架API时,希望两个API能组合在一起被用户访问和购买。

1)发布为新服务:租户管理员在待上架管理中可将API发布为新服务。

「市场后台-租户空间-待上架列表」

2)发布至已有服务:对于已有服务,可以将接口发布至已有服务。

「市场后台-租户空间-待上架列表」

3)API服务详情:公开市场展示维度,由原先单个API,改为展示API服务。用户可购买整个API服务,覆盖整个API场景,包含多个API信息。

「公开市场-首页」

「公开市场-API服务列表」

4)市场后台-API调用统计:在市场管理后台,增加全局API调用统计。

「市场后台-API调用统计」

09

消费资产支持查看消费凭证

针对外部系统协同开发,上线部署时间不一致,外部系统用户无法提前获知自己的消费者信息,从而修改相关认证的问题,我们在个人工作台,新增「消费者」模块

用户可查看自己在各个租户内的消费者信息及消费者凭证;可以提前修改系统内接口相关认证信息,当API发布至正式环境后,通过对应消费者申请授权后即可使用,无需修改代码。

1)消费资产新增「消费者」模块

在工作台,用户进入「消费资产」中,可查看自己在不同租户内的消费者信息。

「消费资产-消费者列表」

2)调用凭证抽屉

点击消费者列表信息,可查看对应消费者的调用凭证,支持复制。

「消费资产-调用凭证」

3)查看消费者可用API

在列表中,可见相关消费者可使用的API数量,点击数据,跳转至消费资产页面,并过滤出所选消费者可调用的API。

「消费资产-消费者过滤」

10

数据字典优化

1)关联应用系统

数据字段需要关联应用系统,支持关联多个应用系统。在API编排时,使用数据字典函数时,可见对应应用系统关联的数据字典。

「关联应用系统」

2)易用性优化

在函数表达式编辑时,引入数据字典表达式时,可在表达式编辑框上方出现「点击查看数据字典」入口,点击后,触发弹窗显示当前API所属应用系统可用的数据字典,支持复制数据字典编码与列名。

易用性优化

3)逻辑优化

数据字典编码配置错误时,API调用执行过程中断并报错;数据字典正确配置,传入的参数为匹配到数据字典项时,支持返回null或返回原值。

11

平台API门户插件化

新增「平台API门户」插件,控制企业内部API门户是否启用以及维护平台门户相关信息。

1)平台插件中心新增平台API门户

启用后,可在租户内插件中心中决定是否启用平台API门户。

「平台-插件中心」

2)设置平台API门户信息

点击「平台API门户插件」上设置按钮,可打开信息编辑抽屉,可编辑平台门户名称、API开发列操作名称、支持维护分类编辑人员,支持维护平台门户API分类。

「平台API门户信息维护抽屉」

3)租户内平台API门户插件

平台插件启用后,可在租户内选择是否启用「平台API门户」插件,启用后,在工作台出现平台门户入口,在API开发列表可申请将该API展示在平台门户内。

「租户内插件中心」

「工作台-平台门户入口」

本次更新就分享到这里了。以上都是研发团队深挖用户实际业务场景后进行的更新优化,希望能全面提升得帆云iPaaS的易用性和灵活度,完善您的使用体验!

对于本次更新,如果您有哪些功能需要进一步视频讲解,或者您有更好的更新建议,欢迎联系我们反馈!

标签: #菜单结构分析