---
title: "管理触发测试方法 - 计划触发"
language: "zh"
url: "https://docs.testany.io/zh/docs/managing-test-plan/"
markdown_url: "https://docs.testany.io/zh/docs/managing-test-plan.md"
translation: "https://docs.testany.io/en/docs/managing-test-plan.md"
last_updated: "2026-03-03T14:24:54+08:00"
---

# 管理触发测试方法 - 计划触发

## 概述

计划任务（Plan）用于按固定时间或周期自动执行一组 测试流水线。

适用于以下场景：

- 每日冒烟回归
- 每周跨环境稳定性检查
- 每月合规回归套件

## 关键概念

| 概念 | 说明 |
| --- | --- |
| 计划任务标识 | 计划任务唯一标识，格式为 `P-{workspace_key}-{4位大写十六进制}` |
| 触发ID | 对于 Plan，触发ID 就是计划任务 key 本身（例如 `P-WKS-7351`） |
| 触发实例ID | 同一计划任务下某次执行的序号（例如 `00004`） |
| 触发实例 | 一次具体执行事件（例如 `P-WKS-7351-00004`） |
| 计划所有者 | 计划任务资源的所有者（在具备权限时可维护该计划） |

## 开始前准备

请先确保：

- 已有目标 工作区
- 至少已有一条可执行的 测试流水线
- 当前账号具备该工作区的计划任务创建/编辑权限

## 创建计划任务

1. 进入目标工作区，打开 **触发器** -> **计划任务**。

![计划任务列表页](https://docs.testany.io/docs/images/zh/plan-list-page.png)

2. 点击 **新建计划**。

![新建计划弹窗](https://docs.testany.io/docs/images/zh/plan-create-dialog.png)

3. 填写：
   - **名称**（必填）
   - **描述**（可选）
   - **执行计划**（必填）
   - **关联流水线**（必填）
4. 点击 **Create/创建** 完成创建。


> **备注**
>
> 计划任务必须始终至少绑定一条流水线。若未绑定流水线，则无法执行。


## 按目标时间配置 Schedule（重点）

如果你不熟悉 cron，建议按“我希望什么时候执行”来反推配置：

1. 先写一句目标：  
   `我希望这个计划在 ... 执行`
2. 在 **Every** 里选周期（`day`/`week`/`month`/`year`）。
3. 设定日期约束：
   - 按“每月几号”执行，优先用 **on**
   - 按“周几”执行，优先用 **and**
4. 用 **at** 和 **分钟选择器**设置具体时间点。
5. 看 **Schedule preview** 两部分是否都符合预期：
   - 自然语言描述
   - 生成的 cron 表达式
6. 保存后先确认一次真实执行，再投入正式周期。

### 常用配置模板

| 目标 | 推荐设置 |
| --- | --- |
| 每天 09:00 执行 | **Every**=`day`；**on/and** 保持默认全范围；**at**=`09`；分钟=`00` |
| 每周一到周五 10:30 执行 | **Every**=`day`；**and**=`Mon-Fri`；**at**=`10`；分钟=`30` |
| 每月 1 日 00:15 执行 | **Every**=`month`；**on**=`1`；**at**=`00`；分钟=`15` |


> **提示**
>
> 首次配置建议先设一个“几分钟后就会触发”的时间，先在执行记录确认一次真实触发，再改成正式生产计划。


## 管理计划任务

创建后可在详情页持续维护。

![计划任务详情页](https://docs.testany.io/docs/images/zh/plan-detail-page.png)

在详情页可以：

- 编辑名称、描述、调度规则、关联流水线
- 查看和维护 owner 与 labels
- 查看 `created_at` 与 `updated_at`
- 配置结果通知（个人接收人、群组接收人、Webhook 分发）
- 通过时区转换查看 upcoming executions

## 查看执行历史

你可以通过两种入口查看执行历史：

- **计划详情页 -> Executions**：查看最近 10 条触发实例
- **Show all results**：跳转到执行记录页，并自动带上计划过滤条件（`triggered_by=<plan_key>`）

![按计划过滤的执行记录](https://docs.testany.io/docs/images/zh/plan-execution-history.png)

展开某条触发实例后，可以继续查看该次触发下的流水线执行详情与状态。

## 相关文档

- [触发测试执行](https://docs.testany.io/zh/docs/managing-test-executions.md)
- [如何阅读执行列表和流水线执行详情](https://docs.testany.io/zh/docs/how-to-read-execution-list-and-detail.md)
- [管理测试手动触发](https://docs.testany.io/zh/docs/managing-test-manual-trigger.md)
- [管理测试门卫任务](https://docs.testany.io/zh/docs/managing-test-gatekeeper.md)

## 本页术语

- [计划任务 (Plan)](https://docs.testany.io/zh/docs/glossary.md#plan)
- [执行 (Execution)](https://docs.testany.io/zh/docs/glossary.md#execution)
- [测试流水线 (Test Pipeline)](https://docs.testany.io/zh/docs/glossary.md#test-pipeline)
- [环境 (Environment)](https://docs.testany.io/zh/docs/glossary.md#environment)
- [计划任务标识 (Plan Key)](https://docs.testany.io/zh/docs/glossary.md#plan-key)
- [触发ID (Trigger ID)](https://docs.testany.io/zh/docs/glossary.md#trigger-id)
- [触发实例ID (Trigger Instance ID)](https://docs.testany.io/zh/docs/glossary.md#trigger-instance-id)
- [触发实例 (Trigger Instance)](https://docs.testany.io/zh/docs/glossary.md#trigger-instance)
- [计划所有者 (Plan Owner)](https://docs.testany.io/zh/docs/glossary.md#plan-owner)
- [工作区 (Workspace)](https://docs.testany.io/zh/docs/glossary.md#workspace)