任务管理

1. 概要

任务，按时间点或者周期性执行的任务。它实现了任务执行程序和触发器之间的关联。一个具体的任务，配置任务的触发时间，调度器会根据触发时间规则来安排执行此任务。

2. 任务列表

列表字段：

• 名称：任务名称，具有唯一性，用户自定义。
• 描述：用户对任务功能的自定义说明。
• 上次执行时间：任务上一次执行的实际时间。
• 下次执行时间：任务下一次执行的计划时间。
• 状态：任务的运行状态。共有进行中、完成、失败三种状态。

3. 创建任务

• 进入平台管理，点击菜单“管理>任务管理”，进入任务管理页面。
• 点击操作栏的创建任务→，创建一个任务。
• 输入任务名称、任务描述。
• 选择开始时间、结束时间。结束时间不能早于开始时间。

• 选择触发类型。我们提供两种任务触发类型:简单任务、Cron任务。

  • 简单任务： 当需要在规定的时间执行一次或在规定的时间段以一定的时间间隔重复触发执行Job时，SimpleTrigger就可以满足要求；

  • Cron任务： 支持比 SimpleTrigger 更具体的调度，而且也不是很复杂。基于 cron 表达式，CronTrigger 支持类似日历的重复间隔，而不是单一的时间间隔。

• 输入任务执行的触发时间规则。

  • 如果是简单任务，则输入重复间隔、重复次数。

  • 如果是Cron任务,则输入cron表达式。

您可以点击cron表达式解析按钮→对cron表达式进行解析。点击了解如何cron表达式

• 选择超时策略，超时策略有阻塞、串行、并行三种。

  • 选择阻塞：一个任务的一次执行开始时，上一次执行尚未完成，则将此任务暂停。
  • 选择串行：一个任务的一次执行开始时，上一次执行尚未完成，则等待上一次执行完成后立即开始本次执行。
  • 选择并行：一个任务的一次执行开始时，上一次执行尚未完成，则上次执行和本次执行一起进行。

• 选择任务程序。

• 编辑对应任务程序的参数。当不更改参数时，默认使用默认值。

• 选择通知对象。

• 点击下一步，预览任务详情。点击创建，完成任务的创建。

4. 查看任务详情

• 进入平台管理，点击菜单“管理>任务管理”，进入任务管理页面。

• 点击任务的名称,进入到任务详情页面。

您可以在任务详情页查看任务信息和任务日志。通过任务信息，您可以了解任务名称，任务描述，起止时间，触发类型，触发时间规则，执行策略，上次执行时间，下次执行时间，任务程序名，任务参数详情，通知对象。通过任务日志，你可以了解任务执行的状态，实例ID，计划执行时间和实际执行时间。

5. 启停用任务

• 在任务管理列表页，点击您要停用任务所在列的按钮，选择停用，停用该任务，任务停用后便不会执行。
• 在任务管理列表页，点击您要停用任务所在列的按钮，选择启用，启用该任务。

6. 删除任务

• 在任务管理列表页，点击您要删除任务所在列的按钮，选中删除，即可删除任务。

7. cron表达式填写说明

表达式结构

Cron表达式,用于配置cronTrigger实例的触发时间规则是一个字符串，字符串以5或6个空格隔开，分为6或7个域，每一个域代表一个含义，语法格式如下：

{秒数} {分钟} {小时} {日期} {月份} {星期} {年份(可为空)}

例： “0 0 12 ? * WED” 在每星期三下午12:00 执行（年份通常 省略）

各字段及符号含义

cron表达式包含的必要组件：

特殊符号的含义：

Cron 表达式案例

/5 ? 每隔5秒执行一次0 /1 ? 每隔1分钟执行一次0 0 5-15 ? 每天5-15点整点触发0 0/3 ? 每三分钟触发一次0 0-5 14 ? 在每天下午2点到下午2:05期间的每1分钟触发0 0/5 14 ? 在每天下午2点到下午2:55期间的每5分钟触发0 0/5 14,18 ? 在每天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发0 0/30 9-17 ? 朝九晚五工作时间内每半小时0 0 10,14,16 ? 每天上午10点，下午2点，4点

0 0 12 ? WED 表示每个星期三中午12点0 0 17 ? TUES,THUR,SAT 每周二、四、六下午五点0 10,44 14 ? 3 WED 每年三月的星期三的下午2:10和2:44触发0 15 10 ? * MON-FRI 周一至周五的上午10:15触发

0 0 23 L ? 每月最后一天23点执行一次0 15 10 ? 6L 每月的最后一个星期五上午10:15触发0 15 10 ? 2005 2005年的每天上午10:15触发0 15 10 ? 6L 2002-2005 2002年至2005年的每月的最后一个星期五上午10:15触发0 15 10 ? 6#3 每月的第三个星期五上午10:15触发

“30 ?” 每半分钟触发任务“30 10 ?” 每小时的10分30秒触发任务“30 10 1 ?” 每天1点10分30秒触发任务“30 10 1 20 ?” 每月20号1点10分30秒触发任务“30 10 1 20 10 ? ” 每年10月20号1点10分30秒触发任务“30 10 1 ? 10 SUN 2018” 2018年10月每周日1点10分30秒触发任务“15,30,45 ?” 每15秒，30秒，45秒时触发任务“15-45 ?” 15到45秒内，每秒都触发任务“15⁄5 ?” 每分钟的每15秒开始触发，每隔5秒触发一次“15-30⁄5 ?” 每分钟的15秒到30秒之间开始触发，每隔5秒触发一次“0 0/3 ?” 每小时的第0分0秒开始，每三分钟触发一次“0 15 10 ? * MON-FRI” 星期一到星期五的10点15分0秒触发任务

8. 更多操作

• 事务定义
• 事务实例
• 在Choerodon进行API调试