1.1 【定时器】轮询频率
当选择通过「查询」方式定时获取第三方数据时,对于「批量查询」需要进一步设置轮询频率。
方式一:通过点选配置,设置轮询频率,适用于常见的简单的轮询频率场景:
1、 每天的早晨7点到晚上11点之间,每10分钟查询一次,设置如下:
按小时查询同理,比如每2小时查询一次。
执行时间:每天7:00、7:10、7:20... 依次到22:50。
2、每天仅在晚上11点,查询一次,设置如下:
3、每周的周一查询一次,查询时间:周一晚上11点,设置如下:
可选择周一到周日,且支持多选。
4、每月的2号查询一次,查询时间:晚上11点,设置如下:
可选择1号到31号,且支持多选。
方式二:如果方式一的配置无法满足需求,有更个性化的轮询频率,可以通过Cron表达式配置。
Cron表达式说明
Cron表达式是一个字符串,表达式设置由空格分开,主要结构为:秒 分 小时 日 月 星期 年。
注意:
- 因为集成平台的轮询频率不能低于分钟级 和 不能高于年,所以,Cron表达式不需要设置秒位、和年位。
- 约束检验:分钟的枚举值不能超过10个。
字段说明
字段 | 可填写的值 | 可填写的特殊字符 |
秒(Seconds) | 不需要 | 不需要 |
分(Minutes) | 0 - 59的整数 | , - * / |
小时(Hours) | 0 - 23的整数 | , - * / |
日(DayofMonth) | 1 - 31的整数 | , - * ? / |
月(Month) | 1 - 12的整数(或者JAN、FEB、MAR、APR、MAY、JUN、JUL、AUG、SEP、OCT、NOV、DEC,不区分大小写) | , - * / |
星期(DayofWeek) | 1 - 7的整数(或者MON、TUES、WED、THUR、FRI、SAT(1=MON,依次7=SUN,0也可以表示SUN),不区分大小写) | , - * ? / L # |
年(Year) | 不需要 | 不需要 |
每一个域都使用数字,但还可以出现如下特殊字符,它们的含义是:
(1)*:表示匹配该域的任意值。假如在Hours域使用*, 即表示每小时都会触发事件。
(2)?:未指定特定值。 仅适用于 DayofMonth 和 DayofWeek,为这两个时间域中的其中一个设置具体值后,另外一个必须设置为?。
(3)-:表示范围。例如在Hours域使用5-20,表示从5点到20点每小时触发一次
(4)/:表示起始时间开始触发,然后每隔固定时间触发一次。例如在DayofMonth域使用1/5,则意味着每5天触发一次,第一次触发是1号。
(5),:表示列出枚举值。例如:在Hours域使用5,20,则意味着在5点和20点各触发一次。
(6)L:表示最后Last,只能出现在DayofWeek和DayofMonth域。如果在DayofWeek域使用5L,意味着在最后的一个星期四触发。
(7)W:表示有效工作日(周一到周五),只能出现在DayofMonth域,系统将在离指定日期的最近的有效工作日触发事件。例如:在 DayofMonth使用5W,如果5日是星期六,则将在最近的工作日:星期五,即4日触发。如果5日是星期天,则在6日(周一)触发;如果5日在星期一到星期五中的一天,则就在5日触发。另外一点,W的最近寻找不会跨过月份 。
(8)#:用于确定每个月第几个星期几,只能出现在DayofMonth域。例如在4#2,表示某月的第二个星期三。
常用表达式举例子
"59 11 * * 1,2" 表示: 每周一和周二的11:59 执行
"0 10,14,16 * * ?" 表示: 每天上午10点,下午2点,4点 执行
"15 10 L * ?" 表示:每月最后一日的上午10:15执行
"15 10 ? * 6L" 表示:每月的最后一个星期五上午10:15执行
"15 10 ? * 6#3" 表示:每月的第三个星期五上午10:15执行
1.2【触发事件】源系统触发事件与目标系统执行操作的映射逻辑
单对象
CRM -> 第三方系统
1、CRM系统会默认将对象数据的新增、编辑、作废等事件消息都通知到集成平台。 所以,触发动作这里用户无需配置。如果存在此对象的启用的集成流,则触发流程执行同步。
2、对于CRM新增的数据:
- 如果目标系统执行动作勾选了「新增」,将对目标系统同步执行「新增」操作。(前提是符合同步数据范围)
- 如果未勾选「新增」,目标系统不执行任何操作。
3、对于CRM编辑的数据,不一定走第三方系统的编辑操作,这取决于集成平台的「中间表」(也就是集成流详情页下的“同步数据”列表里)是否已经存在了源数据与目标数据的ID映射。
- 如果不存在,集成平台会认为目标系统没有此数据,而走「新增」操作。(如果目标系统执行动作未勾选新增,则不执行)
- 如果存在,集成平台会认为目标系统已有此数据,走「编辑」操作。(如果目标系统执行动作未勾选编辑,则不执行)
根据以上集成平台的实现逻辑,合理配置执行动作。
如果只想同步某个时间点后新增的数据,可以通过在数据范围内通过创建时间或其他时间做筛选; 2或者保障中间表里做了存量数据的ID映射。
第三方系统 -> CRM 反向同理
所以,当判断应该调用什么类型接口时,请结合执行动作的配置和中间表数据综合判断。
1.3 推送动作
1、推送接口支持实时推送
2、可设置需要返回目标对象上的哪些字段,会在接口data 参数里返回
1.4 源系统CRM组件
导入CRM数据是否触发同步配置
配置入口:集成流-编辑- CRM作为源系统组件
注意:此配置为对象级配置,即此对象所有的流都统一受此配置影响。
哪些字段变更触发更新同步
配置入口:集成流-编辑- CRM作为源系统组件
系统默认:当配置在数据范围和字段映射的字段发生编辑时触发同步
自定义配置:如果系统默认不能满足需求,则可以自定义配置字段,只有选中的字段变更才会触发同步