Postman 的 Jenkins 管理 - 手动构建
目录
一、准备工作
二、postman 项目脚本准备并导出
1. 打开已完成并测试无误的 postman 项目脚本。 再次执行测试。
编辑2. 导出（ 测试用例集、环境变量 两个文件）**“不 支 持 中 文”** —— 全部改成英文！
编辑3. 文件所在目录地址栏 输入 cmd 打开终端。注意：用 “绝对路径” 测试。方便使用 Jenkins。
编辑4. 执行无误， 查看生成的测试报告文件# extra版报告模板
三、使用Jenkins管理-手动构建
1. 打开 Jenkins 首页，点击 “新建Item” 创建一个 新任务
2. 输入任务名，如：ihrm_postman，见名知意就OK。选择 “Freestyle project”，点 “确定” 。跳至 “配置”页面。
3. 回主页，可看到 ，多出任务ihrm_postman。 点 任务名称，“配置” 可以继续刚才的配置。
4. 跳至 “构建” 标签。（General 、源码管理、构建触发器、构建环境 四个标签先跳过）
（1）点击 “增加构建步骤”，选择 “Execute Windows batch command” 选项（macOS选择 “Execute shell” ）
编辑 （2） 将 cmd 终端 测试无误的 命令， 粘入“命令” 编辑框中（如有红色浪线警告，忽略）。
5. 构建后操作” 标签。
（1）点击 “增加构建后操作步骤”，选择 “Pulish HTML reports”，点击 “新增” 按钮。
（2）将 Index page[s] 后的值改为：“report.html” 。名称 应与上面 命令中 生成的 测试报告名称 一致。
6. 点击 “应用” --> “保存”。
7. 在 自动跳至 页面中，点击 “Build Now”，可在下面 Build History（构建历史）中， 看 到 构 建 正 在 进 行。
8. 完成后，左侧菜单中 多出 “HTML Report” 菜单栏。点击可查看 测试报告。可能会样式错乱。
四、总结
在当今的软件开发领域，自动化测试和持续集成成为了提升开发效率和软件质量的重要手段。Postman 作为一款流行的 API 开发工具，结合 Jenkins 这一强大的自动化服务器，可以实现高效的 API 测试流程。本文将详细介绍如何在 Jenkins 中进行 Postman 的手动构建，实现 API 测试的自动化。
一、准备工作
-
安装 Postman 和 Newman Postman 用于设计和测试 API 请求，而 Newman 是一个命令行工具，能够执行 Postman 集合中的测试用例，从而实现自动化运行。确保在你的计算机上正确安装了 Postman 和 Newman。
-
创建 Postman 集合 ：在 Postman 中新建一个集合，添加你想要测试的 API 请求及相关测试用例。设计好测试内容后，对集合进行仔细检查，确保测试用例能够通过验证，然后将其导出为 JSON 文件，以便后续在 Jenkins 中使用。
-
安装 Jenkins 插件 ：通过 Jenkins 插件管理界面安装 Postman 插件，这样可以在 Jenkins 中更方便地执行 Postman 测试用例。
二、postman 项目脚本准备并导出
1. 打开已完成并测试无误的 postman 项目脚本。 再次执行测试。
全部测试通过
2. 导出（ 测试用例集、环境变量 两个文件）**“不 支 持 中 文”** —— 全部改成英文！
千万不要放在中文目录下面
导出环境变量
3. 文件所在目录地址栏 输入 cmd 打开终端。注意：用 “绝对路径” 测试。方便使用 Jenkins。
4. 执行无误， 查看生成的测试报告文件
# extra版报告模板
newman run 测试用例集名.json -e 环境变量文件.json -d 数据文件.json -r htmlextra --reporter-htmlextra-export 报告名称.html# 示例：
newman run "D:\SoftwareTesting\testExport\ihrm.postman_collection.json" -e "D:\SoftwareTesting\testExport\postman_environment.json" -r htmlextra --reporter-htmlextra-export report.html执行
生成报告
三、使用Jenkins管理-手动构建
Jenkins下载地址：Jenkins 的安装和设置
操作步骤：
1. 打开 Jenkins 首页，点击 “新建Item” 创建一个 新任务
2. 输入任务名，如：ihrm_postman，见名知意就OK。选择 “Freestyle project”，点 “确定” 。跳至 “配置”页面。
3. 回主页，可看到 ，多出任务ihrm_postman。 点 任务名称，“配置” 可以继续刚才的配置。
4. 跳至 “构建” 标签。（General 、源码管理、构建触发器、构建环境 四个标签先跳过）
（1）点击 “增加构建步骤”，选择 “Execute Windows batch command” 选项（macOS选择 “Execute shell” ）
（2） 将 cmd 终端 测试无误的 命令， 粘入“命令” 编辑框中（如有红色浪线警告，忽略）。
5. 构建后操作” 标签。
（1）点击 “增加构建后操作步骤”，选择 “Pulish HTML reports”，点击 “新增” 按钮。
（2）将 Index page[s] 后的值改为：“report.html” 。名称 应与上面 命令中 生成的 测试报告名称 一致。
> 说明：
> 因为生成报告时，没有指定目录。 所以：上面 “HTML directory to archive” 是空的。
> 如果，指定报告生成到其他位置。 要配置 “HTML directory to archive”的值。
（3）Report title 是生成的报告 标题，可修改为 “Report999” 试试看。
6. 点击 “应用” --> “保存”。
7. 在 自动跳至 页面中，点击 “Build Now”，可在下面 Build History（构建历史）中， 看 到 构 建 正 在 进 行。
1. 点 #1 后面的名称 ， 点击 “控制台输出” 查看 执行的命令。
2. 再次点 “Build Now”，可以 再构建一次 #2。 以此类推。
8. 完成后，左侧菜单中 多出 “HTML Report” 菜单栏。点击可查看 测试报告。可能会样式错乱。
通过构建后操作步骤中配置的 HTML 报告发布选项，点击任务详情页面中的 “HTML 报告” 链接，即可查看生成的 HTML 格式测试报告，直观地了解 API 测试的结果和详细信息
特别说明：
如有 红色 “失败” 提示，检验是否 测试用例 断言没有通过！用例断言失败， Jenkins 自动判定为 失败！
四、总结
通过以上步骤，成功地在 Jenkins 中配置了 Postman 的手动构建过程，实现了 API 测试的自动化。现在，你可以根据项目的实际需求，灵活地手动触发构建任务，及时地对 API 进行测试，从而提高软件开发的效率和质量。当然，在实际应用中，还可以根据项目的特点和复杂度，进一步优化和扩展这个基础流程，例如引入环境变量配置、数据驱动测试、自动发送测试报告邮件等，以满足更高级的测试需求。
希望本文对你理解和应用 Postman 与 Jenkins 的集成有所帮助，如果在实际操作过程中遇到任何问题，欢迎在评论区交流讨论。