# CloudCC 定时作业（scheduleJob）介绍

定时作业（`scheduleJob`）用于查看和管理已经配置在 CloudCC 平台中的调度任务。它聚焦于**作业管理侧**，常用于运维排查、任务巡检和作业下线。依赖定时类。

---

## 什么时候用 scheduleJob

当你需要处理“已配置好的定时任务”时，优先使用 `scheduleJob`：

- 日常巡检：查看当前有哪些任务、是否符合预期
- 故障排查：根据作业 ID 查看具体配置
- 任务治理：删除无效、重复或已弃用的作业

---

## 与 timer 的关系

- `timer`：偏向**开发与发布定时类代码**（创建、发布、拉取源码等）
- `scheduleJob`：偏向**运行时作业管理**（新建、查列表、查详情、删除）

通常流程是：先通过 `timer` 交付能力，再通过 `scheduleJob` 做线上作业管理。

---

## 后台页面配置说明（与实际界面对齐）

根据当前定时作业配置页面，创建/编辑作业时主要关注以下字段：

| 配置项 | 是否必填 | 说明 |
|------|------|------|
| 作业程序 | 是 | 选择要执行的定时类程序（即作业绑定的业务逻辑） |
| 频率 | 是 | 支持 `每周`、`每月` |
| 星期（仅每周） | 是（每周时） | 勾选周一到周日，可多选，表示每周哪些天触发 |
| 开始 | 是 | 作业生效开始日期 |
| 结束 | 是 | 作业生效结束日期 |
| 执行时间 | 是 | 每次触发的具体时间点（例如 `上午 0:00`） |

### 频率规则

- 选择 `每周`：必须至少勾选一个星期值（周一到周日）
- 选择 `每月`：按每月规则触发（具体以后台月度配置项为准）
- 所有计划都会受 `开始` 和 `结束` 日期约束，超出范围不触发

### 示例：每周定时任务

```text
作业程序：客户长时间未联系新建活动
频率：每周
星期：星期一、星期三、星期五
开始：2026-04-01
结束：2026-12-31
执行时间：上午 08:00
```

该配置表示：在有效期内，每周一/三/五上午 08:00 执行一次选定作业程序。

---

## 注意事项

- 删除定时作业不可恢复，操作前务必核对作业用途与影响范围。
- 作业是否触发，由开始/结束日期与频率规则共同决定，配置变更后建议结合业务窗口验证。

---

## 关联文档

命令与参数说明见本模块开发指南文档（`devguide`）。

---