任务日志
物联卡模块中的导入、同步等耗时操作以异步任务方式执行：请求提交后先持久化任务并返回任务号，实际执行由后台执行器领取并完成。
任务日志用于查看任务进度、操作留痕和执行结果，是确认批量操作是否生效的依据。
任务日志下包含三个页面：任务进度、操作日志、执行结果，三者分工不同：
| 页面 | 用途 | 典型场景 |
|---|---|---|
| 任务进度 | 查看任务列表、当前状态与执行进度 | 批量导入、全量同步提交后确认任务是否完成 |
| 操作日志 | 记录关键操作留痕，便于审计追溯 | 查「谁在什么时候做了什么」 |
| 执行结果 | 查看任务执行的明细结果与失败项 | 对失败项生成逐行失败报告并下载 |
任务进度
访问路径：物联网 → 物联卡 → 任务日志 → 任务进度
任务进度用于查看物联卡模块后台任务的执行情况，通常可以：
- 查看任务列表及当前状态
- 跟踪执行进度
- 对失败任务定位原因
适合在批量导入、全量同步等操作提交后，确认任务是否完成、是否有失败项。
操作日志
访问路径：物联网 → 物联卡 → 任务日志 → 操作日志
操作日志用于记录物联卡模块的关键操作留痕，例如卡的新增、变更、导入、绑定等操作，便于追溯「谁在什么时候做了什么」。
执行结果
访问路径：物联网 → 物联卡 → 任务日志 → 执行结果
执行结果用于查看任务执行后的明细结果，通常可以：
- 查看每个任务的成功与失败明细
- 对失败项生成逐行失败报告
- 下载任务结果文件用于核对
批量导入或同步完成后，如果存在失败项，建议到执行结果页面生成失败报告逐行核对。
失败报告与执行日志均通过受控下载接口返回短期有效的下载地址，请及时下载保存。
后台任务可靠性
物联卡的后台任务采用「先持久化、后执行」的可靠机制：
- 提交请求时只负责持久化任务并返回任务号，实际执行由后台执行器领取
- 任务执行进度、失败明细都会落库，任务进度与执行结果页面展示的数据即来自任务执行记录
- 服务重启后，未完成或异常的任务会按记录恢复继续执行，不会凭空丢失
- 对账与重放会校验企业、通道与操作时序，不会用旧结果覆盖更新的数据
因此，提交批量操作后无需等待页面刷新，直接到任务进度页确认执行状态即可；页面与接口返回的任务号可用于后续核对。
使用建议
- 提交批量操作后，先到任务进度确认任务已执行完成
- 导入存在失败项时，使用执行结果生成失败报告，按行修正后重新导入
- 操作日志用于审计留痕，不作为业务数据核对依据
- 任务日志是确认停机、复机、断网、开网等异步控制操作是否生效的依据，操作提交后请到执行结果确认
更新日志
2026/8/4 15:04
查看所有更新日志
7e927-于0139c-于117c7-于710ed-于
