接口自动化工具Doclever使用说明.docx

### Doclever平台使用说明 #### 一、Doclever平台简介 **Doclever**是一个功能强大的可视化接口自动化测试平台，主要用于接口测试的自动化管理和执行。它支持多种常用的接口文档格式导入，例如Postman和Swagger，这使得用户能够快速地将已有的接口文档导入到平台中进行自动化测试。 此外，Doclever还提供了模拟接口的功能（Mock），当接口仍处于开发阶段时，可以通过模拟接口来提前进行测试，避免因为接口未完成而导致测试工作无法进行的问题。对于复杂的测试场景，尤其是存在多个接口相互依赖的情况，Doclever也能够提供有效的解决方案和支持。 #### 二、Doclever测试环境配置 Doclever的测试环境可通过以下地址访问：`http://xxx:20000`。为了确保测试环境的稳定性和安全性，建议使用专用的服务器资源，并且对环境进行定期维护。 #### 三、加入团队与项目 1. **登录/注册**：首次使用Doclever平台前，需要先进行账号的注册或登录。 2. **加入团队**：可以通过主动申请或由团队管理者邀请的方式加入团队。申请时需要提供团队ID，等待管理者审批。 - 主动申请：输入团队ID `xxxx`，等待团队管理者审批。 - 管理者邀请：可以给予被邀请者团队管理员或团队成员的不同权限。 3. **加入项目**：加入团队后，根据项目需求，由项目组长邀请成员加入项目。项目组长还可以在团队内新增项目，并邀请成员加入。 - 导入项目：项目组长在团队内导入项目，具体操作可参考“接口导入”章节。 - 邀请成员：只能邀请已经加入团队的成员。 #### 四、接口导入与更新 **接口导入**主要包括以下步骤： 1. 在接口选项卡中选择导入接口。 2. 选择Swagger导入方式，并选择URL类型。 3. 打开开发环境的Swagger链接，并将链接复制粘贴到Swagger URL中即可导入全部接口。 **接口更新**： 1. 进入项目，点击设置选项卡。 2. 更新工程项目。 #### 五、接口调试与测试 - Swagger导入Doclever时，会自动生成各接口的请求参数和类型、返回结果参数和类型。 - 调试时，需要选择或输入请求服务的BaseUrl，填写请求参数值后点击运行查看运行结果。默认BaseUrl是导入接口时的url，若当前输入的BaseUrl不在项目的BaseUrl列表中，系统会提示添加。 - 自动化接口测试包括UI模式和代码模式两种。 #### 六、自动化接口测试 - **UI模式**：适用于简单的测试场景。增加用例对应的接口后，给接口增加入参。支持层级之间的分隔，需要注意的是层级参数名要加上双引号。此外，还可以增加log打印和条件判断，例如通过返回状态码校验来判定case是否通过。 - **代码模式**：适合复杂场景的测试。可以从UI模式切换到代码模式，直接在代码模式下编写JavaScript代码。 - **集合测试**：可以指定运行多个测试用例，并加入轮询以定期运行这些测试用例。失败后可以发送邮件通知。 #### 七、增加协作者 为确保测试用例的安全性与协作效率，可以通过增加协作者的方式为特定用户提供编辑或查看权限。在UI界面中选择自己的用户名，然后为用户分配相应的权限，默认情况下项目管理者具有可写权限，其他成员则为只读权限。 #### 八、Mock方法 1. **服务搭建**：服务搭建好后，提供测试环境或开发环境地址给效能团队，他们会启动mock程序，并告知mock端口号。 2. **Mock接口配置**：在接口选项卡中找到需要mock的接口，请求BaseUrl设置为mock服务的地址，在Result栏填写mock数据。 3. **Mock接口启用条件**：只有接口状态为开发中时，才会启用mock接口；否则将使用真实的接口。 ### 结论 通过上述内容可以看出，Doclever平台不仅支持多种接口文档导入，还具备强大的接口自动化测试能力，尤其在处理复杂场景下的多接口依赖方面表现突出。此外，它还提供了模拟接口、集合测试以及协作者管理等功能，极大地方便了开发和测试团队的工作流程。对于需要进行高效、稳定的接口自动化测试的企业而言，Doclever无疑是一个非常实用的选择。