Eolinker API DevOps 私有云 7.2 更新:全面强化内置函数,强化定时测试任务、加入API版本管理、优化体验等
2020,10,17 更新

EOLINKER EPC 私有云产品已于近期发布 7.2 版本,以下是部分核心改进内容:

【API研发管理】产品更新说明:

  1. 预处理内置变量变更;
  2. 预处理加入大量内置函数,支持AES、DES、SHA1、SHA256等函数等;
  3. 父子级选项的勾选状态加入联动关系,当取消父级勾选框时自动取消子级勾选;
  4. Mock API 导入API文档的返回参数时,改用增量更新的方式,不会覆盖当前Mock API的返回内容;
  5. API文档中支持在数据结构中引入其他数据结构(数据结构嵌套);
  6. API编辑页面加入“快速保存”功能,快速保存不会触发变更通知,并且不需要填写API更新描述;
  7. API测试用例中支持编写“测试用例说明”;
  8. 加入API版本管理功能,支持为API的某个变更历史设置版本号,支持根据版本号查看对应的API列表,并且导出API文档;
  9. 复制api时,创建时间与更新时间改为复制时的时间,创建人改为复制API的人;
  10. 项目统计信息加入测试用例数量统计。

 

【API自动化测试】产品更新说明:

  1. 预处理内置变量变更;
  2. 预处理加入大量内置函数,支持AES、DES、SHA1、SHA256等函数等;
  3. 自动化测试API步骤中支持编写“测试用例说明”;
  4. 分享项目访问密码,密码由明文传输改为加密传输,加强安全性;
  5. 私有云定时测试任务可设置具体时间,比如12点37分执行,精确到分钟;
  6. 改进测试报告文件、邮件,加入更多统计信息;
  7. 自动化测试预处理和raw请求参数中支持“引用参数值”等。

 

【其他】

  1. 支持通过OpenAPI创建和修改API文档;
  2. 优化部分界面体验。

1.预处理内置变量更新

在过去较长的一段时间里,不断有用户和我们反馈不理解什么是“预处理”,以及预处理中内置的变量很容易和自定义变量重名,比如url、params这些变量在自定义的脚本中经常重名,因此希望对此作出改进。

由于预处理功能和内置变量功能已经发布较长时间,目前平台内有数千万的相关数据,因此这个改动看似简单却牵涉众多用户的使用习惯。因此Eolinker团队在经过和内测用户沟通和设计之后,决定对现有预处理以及内置变量做出以下改变:

  1. API测试中的预处理功能更名为“前置处理”与“后置处理”,方便用户分别编写脚本来改变请求参数或者返回结果。
  2. 自7.2版本起,部分内置变量重新命名,旧的变量名会自动刷为新的变量名,而旧的变量名则失效不再使用。

但是,由于旧变量的数据众多,我们开发团队无法保证每一个变量都被正确地刷新为新的变量名,因此可能导致少部分情况下的预处理脚本执行失败,需要手动将旧的变量改为新的变量即可。

了解关于预处理内置变量的详细更新说明,请点击这里。

 

2.预处理加入大量内置函数,支持AES、DES、SHA1、SHA256等函数等

新版本中,在预处理中加入了大量的内置函数,并且针对每个函数都完善了代码提示和说明信息,方便使用。详细的函数列表可以查看《内置函数手册》

 

3.父子级选项的勾选状态加入联动关系

当取消父级勾选框时自动取消子级勾选,勾选父级时则弹窗询问是否勾选所有子级选项。

 

4.Mock API 导入API文档的返回参数时,改用增量更新的方式

现在在Mock API中导入API文档的返回参数时,不会覆盖当前Mock API的返回内容,减少重新填写数据的时间。

 

5.API文档中支持在数据结构中引入其他数据结构(数据结构嵌套)

  1. 不同的数据结构有不同颜色的左侧边框表示,比如下图中的黄色和红色部分;
  2. 数据结构仅支持整体进行拖动,比如下图中红色部分的数据结构是一个整体进行拖动,黄色是一个整体进行拖动。

 

6.API编辑页面加入“快速保存”功能,快速保存不会触发变更通知,并且不需要填写API更新描述

“快速保存”不会弹窗,并且不会发送变更通知,适合对API文档进行小改动时使用。

“保存”会弹出,提示输入更新描述,并且可以发送文档变更通知给相应人员。(发送通知选项挪到了保存弹窗中)

保存弹窗会显示版本号设置、触发变更通知选项。(接口版本号功能仅企业版支持)

 

7.API测试用例中支持编写“测试用例说明”

  1. 说明文本框默认是收缩状态的,需要手动展开
  2. 请求参数、返回参数支持编写“说明”字段,默认是隐藏该字段,可以通过列表项选项打开。

 

8.加入API版本管理功能

在API研发过程中,随着对API的不断优化与迭代,我们需要对各个版本的API变更情况进行记录、跟踪,方便后期维护。

比如项目最初版本有20个API,这些API开发完成之后可以设置为1.0版本;项目迭代到1.1版本时,新增了10个API,改动了1.0版本的10个API,因此项目1.1版本涉及的接口有20个。

通过API版本管理功能,我们可以给API设置版本号,后期维护时可以快速了解1.0版本开发的有哪些API,1.1版本新增或改动了哪些API等,还可以将API信息按照版本导出成离线文件(Word、PDF、Markdown等)。

进入项目详情页面,在左侧侧边栏点击 API版本 功能,在API版本管理页面即可创建版本。

成功创建后,进入API详情页,点击右上角 版本与变更历史 按钮,在侧边栏中可以给每一次变更设置版本。

注意,一个版本在一个API中只能绑定一条变更历史,比如“用户登录接口”只能给1月1日的变更历史设置为1.0版本,可以给1月2日的变更历史设置为1.1版本。