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版本。