帮助文档

前往官网
最新更新时间:2023-05-06 14:55:16

应用简介

腾讯轻联一般是以特定的场景事件进行触发,例如当有客户提交了腾讯问卷时,或当销售易CRM系统中新增客户记录时则触发下一个场景。

但是,在我们的日常工作中存在着大量定时、重复的工作,例如:每天下午17:00在企微群内发送日报收集链接并提醒群成员填写等。

这样的场景连接方案需要以具体时间和频率驱动,并非以具体场景事件驱动,可以通过腾讯轻联内置组件-定时触发来完成。

定时触发配置手册

简介

定时任务(Scheduler)作为触发器,用于按设定的规则定时触发一条流。图形化 Scheduler 支持以下三种触发模式:
单次触发:支持选择多个指定的时间点触发。
周期触发:按照固定的周期触发。
Cron 表达式:配置中包含一条或多条 Cron 规则,当任意一条 Cron 规则与当前时间匹配时,该定时器所在的集成流将被触发。

操作配置

参数配置

 

参数数据类型描述是否必填默认值
触发模式Int设置触发模式:单次触发,周期触发,Cron表达式0(Cron表达式模式)
Cron 表达式string设置触发规则,例如每分钟触发1次等
时区string指定时区亚洲/北京 UTC+08:00
仅在上次任务执行完后触发bool若勾选则仅在上次任务执行完后触发false

Scheduler 包含一条或多条 Cron 规则,当存在多条规则时,使用
\r
分隔,Cron 表达式的配置规则如下:

参数含义取值范围
seconds0 - 59
minutes分钟0 - 59
hours小时0 - 23
days日期(选填,默认每天)1 - 31
months月份(选填,默认每月)1 - 12
weekdays星期几(选填,默认不指定)1 - 7
years年份(选填,默认每年)1970 - 2099

在配置 Cron 表达式时,可使用以下运算符:
*表示任意匹配,例如hours="*"表示每个小时。
-表示范围,例如weekdays="1-5"表示周一至周五。
,表示并列,例如months="1,3,5,7,8,10,12"表示大月。
/表示增量,例如hours="8/2",表示8点开始,每两个小时。
L表示最后一个,例如weekdays="6L",表示当月最后一个周六。
?表示不指定。这里有一个约束,即年月日和星期几中至少要有一个为不指定。这是为了避免冲突,例如同时指定2020年2月20日(原本周四)和周三。默认星期几是不指定的。

配置界面

https://qcloudimg.tencent-cloud.cn/raw/29d7750cb0e6f3b257578f5503241054.png

输出

Scheduler 作为 trigger 组件,是集成流的第一个组件,Scheduler 会生成一个空的 message 消息,触发集成流的运行。
组件输出的 message 信息如下:

message 属性
payload空,没有值存在
error执行成功后,error 为空
执行失败后,error 为 dict 类型,包含“Code”和“Description”字段:“Code”字段表示错误类型,“Description”字段表示错误具体信息
attribute空,没有值存在
variable空,没有值存

数据预览

https://qcloudimg.tencent-cloud.cn/raw/81f7584e35c5f7c59d9deee55ce54dd8.png

案例

周期触发模式

每30秒触发一次:https://qcloudimg.tencent-cloud.cn/raw/1972ae04ae9bf34e0c4a98067a52980e.png

单次触发模式

2023年1月1日0时0分0秒触发一次:https://qcloudimg.tencent-cloud.cn/raw/d7da174f8f6fbe9d12d4c25b6a82b3e6.png

Cron 表达式模式

每5分钟触发一次:https://qcloudimg.tencent-cloud.cn/raw/d94891fadc4ae258f85793e40d4cb072.png

如果您在文档使用中遇到问题或者有改进建议,请点击 在线反馈