使用 EOLINKER 进行接口测试的最佳路径 (上)

本文内容：

1. 测试脚本管理：讲述如何在 EOLINKER 上设计测试项目目录结构。
2. 编写测试脚本：讲述如何在 EOLINKER 上编写接口测试脚本。
3. 测试脚本执行及报告：讲述如何在 EOLINKER 上执行接口测试脚本，及如何查看和下载测试报告。
4. 测试项目人员协做：讲述如何在 EOLINKER 上进行多人的测试项目协做。

1.测试脚本管理

在EOLINKER上设计测试项目目录结构来管理测试脚本；

先来看下EOLINKER的测试脚本管理分级：

项目管理 > 测试项目管理 > 测试项目模块管理（支持子模块和子子模块管理） > 测试用例集 > 单个测试用例

测试脚本管理分级

项目管理

若是如今你只有一个项目叫"小鱼游游Web"，包含web版/app版/公众号H5版/小程序版，你能够经过【新建自动化测试】（以下图中标记1）来建立每一个版本的测试项目；

若是如今你有多个项目，如"小鱼游游Web"，"小鱼游游APP"，同时每一个项目包含web版/app版/公众号H5版/小程序版，你能够先经过【新建分组】（以下图中标记2），为"小鱼游游Web"，"小鱼游游APP"分别建立各自的项目目录，而后进入各个项目目录中，经过【新建自动化测试】（以下图中标记1）来建立每一个版本的测试项目；

另外，若是项目已经结案，能够经过项目列表的[归档]操做按钮，项目就会移至【已归档项目】（以下图中标记3）列表中，这里的归档和未归档没有本质上的区别，只是放在不一样的文件夹而已。

项目管理页面

经过前面操做，各位已经有了测试项目，你们能够进入项目来一看究竟。

1.若是须要了解测试项目当前的协做人员数/ 项目动态/ 测试用例个数等信息的话，请打开 概况页面；

2.若是要建立并管理 测试项目模块，测试用例集以及单个测试用例，您能够先去 场景用例 页面查看，回头将为您详细讲解；

3.若是想指定一批测试用例脚本在你设定的时间自动跑，并把测试结果发送到你指定的邮箱，定时进行查看。这个功能须要你们开通企业版本才能进行使用；而若是你已经拥有企业版本，那你能够打开 定时任务 页面先看看里面长什么样，后面会和你们进行详细讲解；

4.若是但愿自定义一些公共调用的变量或参数，如 http 请求的默认值（host url，请求头部，body 参数），来 公共资源管理 页面。

5.若是想对测试脚本进行限权管理，好比只读/读写等，去 协做人员管理 页面设置；

6.最后，若是你想在导入 API 文档时，只看小鱼游游 Web 项目的 API 文档时，你能够进行 自动化测试管理 里面的【可引用的API项目】中进行设置；

测试项目管理

测试项目模块管理/测试用例集

回顾前面说的：“若是你要建立并管理 测试项目模块，测试用例集以及单个测试用例，先去[场景用例]页面打个照面，稍后再详细给你叨叨。”

点[场景测试]，进入测试项目模块/测试用例集页面；

经过【新建分组】（以下图中标记1）建立项目模块目录（一般模块划分2种：按业务和按界面，你能够在设计单接口测试脚本时，按界面，在设计场景测试脚本时，按业务），你能够经过模块目录后面的菜单按钮，建立子分组和子子分组，即子模块和子子模块。

建立好模块目录后，咱们须要在各个模块目录下面建立对应用例集，经过【新建用例】（以下图中标记2）建立各自的用例集。

测试项目模块/测试用例集页面

EOLINER 的用例集有2种类型：

1.普通类型-UI 模式（默认类型）：若是你偏心界面，那你能够选择这种模式，你只须要填空就能完成接口测试脚本；

2.高级类型-代码模式：若是你钟意撸代码，若是你又会 Javascript ，这个模式会更加适合你；

新建用例集弹窗

单个测试用例

到此，项目结构已完成，下面就能够开始编写测试脚本了。

在测试用例集列表，点选一个普通类型-UI模式用例集，进入单个测试用例 - 普通类型[UI模式]页面，经过【+已有接口】（以下图中标记1）从API文档导入接口基本信息（url/请求方法/请求协议/ 传参/返回信息），这样方便咱们设计脚本时，只要改动传参和添加校验信息，即完成一个用例脚本编写，具体怎么作，去下一小节吧；固然若是开发的没有在EOLINKER的API研发管理模块中编写API文档，那你能够经过【+空白接口】（以下图中标记2）来编写测试脚本。

单个测试用例页面 - 普通类型[UI模式]

若是你点选是一个高级类型-代码模式用例集，你将进入单个测试用例 - 高级类型[代码模式]页面，界面以下，

单个测试用例页面 - 高级类型[代码模式]

2.编写测试脚本

上面小节已提到，编写接口测试脚本有2种方式：

1. 经过【+已有接口】按钮，从API文档列表导入已有的接口文档（以下图 - API文档列表页面），而后基于接口文档基本信息，并添加用例名称和校验信息（断言），完善接口测试脚本。（推荐）
2. 经过【+空白接口】按钮，填写空白接口文档，而后添加用例名称和校验信息（断言），完成接口测试脚本。

截图进入路径：API研发与自动化测试 -> API研发管理 -> 小鱼游游Web（Web开发项目）-> API文档

API文档列表页面

若是你如今是在EOLINKER上编写项目的第一条测试用例脚本，你能够根据下面的步骤去编写测试脚本：

1. 建立测试环境并导入到用例集
2. 建立前置用例（如登陆或注册）
3. 建立后置用例（如退出登陆）

说明：步骤2-3放在步骤5后面再作，也是能够的。

1. 导入API文档（或添加空白接口）

   a. 在导入的API文档中，编辑测试用例描述（在EOLINKER上叫接口名称）

   b. 在导入的API文档中，编辑请求信息

   c. 在导入的API文档中，编辑预期返回信息（这里是填写返回头部和返回参数，若是这部分开发已经填写，能够跳过这一步）

   d. 在导入的API文档中，添加返回头部校验

   e. 在导入的API文档中，添加返回结果校验

   f. 在导入的API文档中，添加高级设置

2. 点保存，完成测试脚本编写。

说明：后面添加新的用例，基本就是重复4-5的操做，仍是挺便捷的嘛!

1.建立测试环境并导入到用例集

在测试环境中，咱们能够自定义公共URL（接口所在的主机名）自定义全局变量、自定义添加公共请求参数、自定义添加公共请求头部标签、自定义添加公共鉴权方式。

建立测试环境并导入到用例集操做步骤以下gif动态图：

建立测试环境并导入到用例集

GIF 动态图说明：

第一个页面为测试项目列表页面。
第二个页面为测试项目的公共资源管理-测试环境页面，在这里建立测试环境。
第三个页面为测试项目的场景用例页面，在这里导入刚才建立测试环境。

2.建立前置用例（如登陆或注册）

前置用例，即测试用例的前置条件，登陆或数据初始化，目前还不支持远程链接并操做数据库，不过咱们能够经过调用接口方式，达到数据初始化的目的。

这里假设在 API 文档列表中，已经添加 登陆的接口文档，这里我经过【+已有接口】按钮从 API 文档列表中 导入登陆接口 来建立前置用例，步骤以下 GIF  动态图：

GIF动态图说明：

1. 第一个页面为测试项目的场景用例页面，在这里，点【前置用例】，进入前置用例集列表页面，而后点【新建前置用例】，建立一个名为 登陆的用例集，点这个新建的用例集进入前置用例编辑页面。
2. 第二个页面为前置用例编辑页面，（注：在新建用例或导入API前，先清除掉编辑窗口中的示例代码），在这里，

   a. 点【+已有接口】按钮，此时会进入 API文档列表选择页面，勾选登陆接口，点【肯定】按钮，完成API导入。

   b. 编辑导入的API文档，由于这里的登陆接口有3个必填传参，因此我定义3个变量，变量的值，须要本身去构造，每一个公司的登陆参数都不同，有的是时间戳+随机字符串+密钥，有的是md5等等，这一部分eolinker都有封装好的md5和sha方法，可直接调用，你也能够本身经过 在通用函数构造自定义的函数，以下图为通用函数编辑页面，我以为这块比jmeter好用太多，jmeter那边你须要用java写个jar包，而后在jmeter的测试计划中导入，而后调用的时候，还要写beanshell脚本，真的太麻烦了。

另外，还写了个断言，用于测试前置用例是否正确，其中"result_api_1.response"是获取接口返回信息，这个信息是string类型，因此后面用JSON.parse()，将其转化为json对象，用于后面response.statusCode获取返回信息中的statusCode字段的值。

c. 编辑完API文档，即写好前置用例，能够点测试按钮，看是否登录成功，我这里测试结果是测试失败，是由于个人3个传参我给的是空的。

d. 点【保存】，而后点【返回列表】返回到前置用例集列表页面。

3.第三个页面为前置用例集列表页面。

3.建立后置用例（如退出登陆）

后置用例，即为后期处理，返回参数加工、资源清除或数据清除。

后置用例和前置用例的建立步骤同样，这里就再也不上gif动态图。

4.导入API文档并完成测试脚本编写

这里不用多说，直接上gif动态图，图看不明白的，能够看下面的动态图说明（TT，图录的好辛苦，要求加鸡腿...）。

GIF动态图说明：

1. 第一个页面为测试项目的场景用例页面，在这里，点以前建立好的 测试项目模块目录【通用接口】，进入用例集列表页面，而后点【新建用例】，建立一个名为 获取公司列表的用例集，点这个新建的用例集进入用例编辑页面。
2. 第二个页面为单例列表页面，在这里，

   a. 点【+已有接口】，此时会进入 API文档列表选择页面，勾选登陆接口，点【肯定】按钮，完成API导入。

   b. 点刚导入的API文档后面的【编辑】操做按钮进入用例编辑页面。

3. 第三个页面为用例编辑页面，

   a. 编辑接口名称，即用例名称。

   b. 访问此接口时不用传参，因此请求信息这里为空。

   c. 预期返回参数，通常是开发在API文档填好的，因此这里为空。

   d. 没有可校验的返回头部，因此返回头部校验这里为空。

   e. 返回结果校验，这里我用的是JSON检验方式，这里有个【同步返回参数】按钮，XML检验方式也有，若是开发已经写好预期返回参数，点此按钮后，全部的返回参数都会自动导入到校验字段列表中。

   f. 高级设置，我勾选了 【该用例校验为失败时,依然执行下一个用例】，若是没勾选的话，此用例测试失败时，后面的用例就不会被执行；其中【当某一校验规则判断为失败时，依然判断其他规则】是默认勾选，表示若是校验字段列表中某个字段校验失败，仍校验其余还没校验的字段；超时限制，默认5000ms，即5秒，表示 测试超时将会自动判断为测试失败。

点【保存】，返回到单例列表页面，即完成用例编写。

4.第四个页面为单例列表页面，在这里点【+前置用例】按钮，在弹窗中选择要添加的用例，由于成功调用这个 [获取公司列表]通用接口须要登陆的，这里就须要添加 登陆前置用例。

注：高级类型-代码模式的用例编写方法和前面的建立前置用例的方法是同样，这里就再也不详细说明，若是你很是想我写一篇关于 高级类型-代码模式的用例编写的话，请留言，让领导给我加鸡腿!（对，我就是这么没出息，我就是要鸡腿... ）

到此，测试用例编写的正确方式，也就介绍完了。

本文总结

本文主要是引导你们怎么用 EOLINKER 设计接口测试项目架构，其中包含如何项目目录结构，如何编写接口测试脚本，如何执行测试脚本和如何获取测试报告，以及如何进行多人的协做。其中后两部分的内容，咱们在下篇文章介绍！