Skip to content

定时任务 ​

定时任务是系统按固定时间自动执行的后台工作,例如每天早上发送跟进提醒、到期提醒,凌晨同步数据仓库、让调薪和工程变更按生效日期生效。管理员可以在这里调整执行时间和参数、启用或停用任务、立即执行一次,并查看执行日志。

平台专属

定时任务是平台专属功能,SaaS 模式下只有平台租户的管理员可以使用。任务对所有租户统一调度:每次执行时按租户逐个运行(只运行启用且未到期的租户),某个租户失败不影响其他租户,执行说明中汇总各租户的结果。

页面入口 ​

系统监控 → 定时任务

定时任务

列表字段 ​

列说明
任务名称如「客户跟进提醒」
任务标识任务的唯一编码,如 crm.followRemind
Cron执行时间表达式
参数任务参数,如 days=30
状态启用 / 停用
最近执行最近一次执行的开始时间
结果最近一次执行成功 / 失败
执行说明最近一次执行的结果说明,如「提醒 3 个客户」「没有逾期应收」,多租户时按租户列出
操作「执行」「修改」「日志」

内置任务 ​

系统共内置以下 17 个任务,提醒类任务把消息发送到相关人员的站内消息(顶栏铃铛)中,并对同一对象做了去重,不会重复打扰:

任务名称任务标识默认执行时间默认参数作用
经营预警推送bi.alertNotify每天 09:00评估全部启用的预警规则,把触发的预警推送给有决策支持权限的用户(每条规则每天一次)
数据仓库同步bi.etl每天 01:30把销售、采购、库存、生产、财务数据同步到数据仓库,供商务智能分析使用
合同回款提醒crm.collectionRemind每天 08:50执行中合同的逾期回款计划,提醒合同负责人(每期一次)
客户跟进提醒crm.followRemind每天 08:00下次跟进时间在今天及之前的客户,提醒负责人(每个客户每天一次)
客户公海回收crm.poolReclaim每天 02:30days=30负责人超过 days 天没有跟进的未成交客户退回公海,并通知原负责人
应收逾期提醒fin.arOverdue每天 09:00汇总逾期未收的应收单,提醒应收人员
票据到期提醒fin.noteDue每天 09:10days=7days 天内到期仍未处理的票据:应收票据提醒托收,应付票据提醒备足资金兑付,通知票据管理人员
劳动合同到期提醒hr.contractExpiry每天 08:40days=30到期日已过的合同改为「已到期」;days 天内到期的合同提醒人事(每份合同一次)
试用期到期提醒hr.probationRemind每天 08:10days=15days 天内试用期到期的员工,提醒人事和所在部门负责人(每人一次)
调薪生效hr.salaryApply每天 00:05把今天生效的调薪同步到薪资档案
工程变更生效mes.ecnEffect每天 00:05已批准且到了生效日期的工程变更,切换 BOM 版本
设备保养提醒mes.maintainRemind每天 08:30days=3days 天内到期的设备保养,提醒设备维护人员(每台设备每个保养日期一次)
工单逾期提醒mes.woOverdue每天 08:40已过计划完工日期仍未完工的工单,提醒制单人(每张工单每天一次)
项目任务逾期提醒pm.taskOverdue每天 08:50进行中项目里已过计划完成日期的任务,提醒任务负责人(每个任务每天一次)
纠正预防逾期提醒qms.capaOverdue每天 09:20超过要求完成日期仍未关闭的纠正预防(8D),通知负责人
补货提醒scm.reorder每天 08:30预计库存不高于再订货点的物料,每天提醒采购人员一次
批次临期提醒wms.batchExpiry每天 08:20days=30days 天内到期且有库存的批次,提醒仓库人员(每个批次一次)

「默认参数」中的 days 可以在「修改」中调整,例如把公海回收改为 days=60。没有默认参数的任务不需要填写参数。

相关功能说明:客户管理、合同管理、劳动合同、工程变更、设备保养、生产工单、纠正预防、补货建议、数据仓库。

修改任务 ​

点击「修改」打开「修改定时任务」:

修改定时任务

字段必填说明
任务显示任务名称和标识,不可修改
Cron 表达式是6 段:秒 分 时 日 月 周,如 0 30 1 * * * 表示每天 01:30;格式错误时提示「Cron 表达式不正确」
参数否key=value 格式,多个用英文逗号分隔,如 days=30
状态是启用 / 停用。停用后不再自动执行,但仍可手动「执行」
备注否

保存后立即按新的时间重新调度,无需重启系统。

Cron 表达式写法 ​

柠檬ERP 使用 6 段 Cron 表达式,各段依次为:

段秒分时日月周
取值0-590-590-231-311-120-7(0 和 7 都是周日)或 MON-SUN

常用符号:* 表示每一个;, 列举多个值;- 表示范围;/ 表示间隔;? 用在日或周上表示不指定。

表达式含义
0 0 8 * * *每天 08:00
0 30 1 * * *每天 01:30
0 0 9 * * MON-FRI工作日(周一至周五)09:00
0 0 8,14 * * *每天 08:00 和 14:00
0 0 */2 * * *每 2 小时整点
0 */30 * * * *每 30 分钟
0 0 2 1 * *每月 1 日 02:00

提示

执行时间以服务器时区为准。数据仓库同步等耗时任务建议放在夜间;多个提醒任务可以错开几分钟,避免同时运行。

立即执行 ​

点击「执行」,任务会马上运行一次(不影响原有的定时计划),完成后提示执行结果(成功时显示执行说明,失败时显示错误原因),并刷新列表。

  • 同一任务正在运行时不能重复执行,提示「任务『xxx』正在运行」;
  • 手动执行在执行日志中记为「手动」触发;
  • 常用于验证修改后的参数、补发当天遗漏的提醒,或在导入数据后立即同步数据仓库。

执行日志 ​

  • 行内「日志」:查看该任务的执行日志;
  • 工具栏「执行日志」:查看全部任务的执行日志。

执行日志

列说明
任务任务标识
触发定时 / 手动
开始时间
耗时(ms)执行用时,毫秒
结果成功 / 失败
说明执行说明或失败原因;多租户时按「租户名:结果」用分号分隔

注意事项 ​

注意

  • 部署时如果在服务端关闭了定时任务调度(一般只在测试环境这样做),所有任务都不会自动执行,只能在本页手动执行。
  • 停用提醒类任务后,相关人员将收不到对应的站内提醒,首页待办中的数据不受影响。
  • 新版本增加的任务会在系统启动时自动登记,使用默认的执行时间和参数。

基于 Apache-2.0 协议开源