设备任务

设备任务用于对一批设备定时批量执行操作，底层基于 XXL-Job 调度。菜单：物联网 > 设备任务（路由 /iot/device-job-relation，日志路由 /iot/deviceJobRelation/log）。

创建任务

菜单：物联网 > 设备任务 > 新增

字段	说明
执行类型	任务的业务类型
目标设备	抽屉中多选目标设备（可多个）
任务规则	核心配置，JSON 格式，按任务类型填写（见下表）
任务描述 / 负责人	展示与责任人
邮箱通知	任务执行结果通知邮箱
调度类型	CRON（内置表达式生成器）或 固定速度（按秒）
高级配置	调度过期策略、超时时间、失败重试次数、调度状态开关

任务规则（三种类型）

类型	规则 JSON	说明
1 批量调用服务	{"identifier": "setPower", "inputParams": {"Power": 1}}	对目标设备逐一发起服务调用（同步/异步由服务定义决定）
2 批量设置属性	{"temperature": 26.0, "Power": "on"}	对目标设备逐一执行属性设置
3 批量消息推送	{"topicShortName": "data/report", "messageContent": "{...}"}	对目标设备的自定义 Topic 下发消息（产品需已配置该自定义 Topic）

保存时平台会按类型校验规则合法性（服务标识符、属性、自定义 Topic 是否存在）。

任务管理

• 开启 / 暂停：控制任务调度是否生效。
• 日志：进入任务日志页，查看每次调度的调度时间、调度结果、执行时间、执行结果、错误重试次数与执行备注，支持导出。
• 修改 / 删除：修改会同步更新 XXL-Job 中的调度配置。

典型示例

每天 07:00 将所有目标设备的 Power 属性设为开：

{ "Power": "on" }

调度类型选择 CRON：0 0 7 * * ?，任务规则类型选择「批量设置属性」。

提示

属性设置与服务调用均为下行指令（QoS 0），设备离线时该次执行会失败并记录在任务日志中；失败重试次数在高级配置中调整。设备侧报文格式见使用物模型通信。