你可以通过设置 “定时任务”,定时自动执行已配置好的自动化测试场景,获取任务运行结果,完成定时测试、回归的需求。使用自托管 Runner 运行定时任务,会根据你的团队付费版本有用量限制。了解更多 定时任务入口#
你可以在自动化测试功能的目录树中,找到定时任务分类。项目中的所有定时任务会以结构树形式展示在此。可以在目录树中,添加定时任务或定时任务的目录;以及对某个定时任务/目录做更多的操作。点击定时任务分类,可以在右侧看到以列表形式展示的全部定时任务,及一些基本信息和操作,可以更方便管理。定时任务详情#
在目录树上点击一个已有的定时任务,或者新建一个定时任务,则会在右边打开定时任务的详情 tab。任务名称、说明: 用来区别定时任务以及说明该定时任务的详细目的。
启/停用: 开启、停止这个定时任务是否按期执行的开关。
测试场景: 定时任务会执行此处选择的一个/多个测试场景,每个测试场景都可以点击展开独立配置其 “运行配置”。运行环境、测试数据、循环次数、间隔停顿、保存请求/响应内容等都为标准运行配置,需要了解更多可见此处。 环境/全局变量值,指定本测试场景中的环境/全局变量,使用何种实际值。有两种选择,详细介绍可以查看此处。当选择使用 Runner 中保存的变量值时,会要求进一步选择需要使用的变量范围。有这个范围的目的是帮助用户更好的根据实际需求分隔变量,避免因为某次定时任务运行,而导致其它的任务因为变量被更改而运行失败。选择完成范围后还可通过产品界面中出现的入口来可视化查看此范围内的变量值。 Runner 中的变量范围 | 读写环境/全局变量方式 | 描述 |
---|
当前测试场景 | - 当前指定运行 Runner 中,此测试场景对应一个文件,在文件中持久化保存此测试场景内设置的环境/全局变量。
- 仅当前测试场景可以读取、写入这个文件中的变量。
| 最小的变量范围,影响面最小。适用于此测试场景上一次运行的结果,要继续提供给下一次此测试场景运行使用的情况。 |
当前定时任务 | - 当前指定运行 Runner 中,此测试场景所属的定时任务对应一个文件,在文件中持久化保存此定时任务内所有测试场景设置的环境/全局变量。
- 当前定时任务中,所有的测试场景可以读取、写入这个文件中的变量。
| 比较推荐使用的变量范围,中等的变量范围,影响面中等。适用于此定时任务中,不同测试场景之间需要传递数据的情况。 |
当前定时任务目录 | - 当前指定运行 Runner 中,此测试场景所属的定时任务目录对应一个文件,在文件中持久化保存此定时任务目录内所有定时任务中测试场景设置的环境/全局变量。
- 当前定时任务目录中,所有的定时任务里的所有测试场景可以读取、写入这个文件中的变量。
| 最大的变量范围,影响面最大,可能因为运行了某个定时任务修改了变量值,而导致其他定时任务运行失败。适用于一组定时任务之间需要传递数据的情况。 |
测试场景详情中的 “保存变量变化值” 配置需被勾选,才能在定时任务运行过程中,将通过前后置操作设置的环境变量或全局变量保存到指定 Runner 的变量范围内。
使用相同运行设置: 让下方的全部测试场景使用同样的运行配置。
运行周期: 设置该定时任务以什么样的定时周期来进行执行,例如每周日晚上 11 点,或每间隔 6 小时执行一次。
运行于: 具体执行此定时任务的实例。可以通过 Apifox 云端(即将开放)、团队自托管 Runner 来执行定时任务。如果团队部署了多台通用 Runner,可以选择其中一台。
通知: 开启通知即可在此定时任务运行完成后,发送一个通知信息给指定的对象,信息内会有测试总览结果和详情链接。打开后可以设置是只要完成运行即进行通知还是在仅发生失败时进行通知,用以减少无效通知的打扰。通知对象的详细说明请参考此处。 定时任务运行#
定时任务运行完成后,会将运行结果从 Runner 上传至服务端中,可以在客户端的 “定时任务 - 运行历史” 中查看选择定时任务的所有运行结果详情。建议定时任务开启通知,这样即可在运行完成后第一时间收到通知消息,从而及时查看任务运行结果。