1. 概述
1.1 版本
| FineDataLink 版本 | 功能变动 |
|---|---|
| 4.0.26 | 4.0.26 版本之前，「结果通知」需要「开启调度」才能设置；4.0.26 版本及之后，「结果通知」可以单独开启 |
| 4.0.28 | 「结果通知」中：
|
| 4.1.4 | 提供确认、取消按钮：进行设置后，可保存、取消操作 |
| 4.1.5.4 | 支持对定时任务源表结构变化进行通知 |
| 4.1.5.5 | 构建失败的任务支持结果通知 |
1.2 功能简介
任务执行失败后，可通知相关人员任务执行失败。
通知渠道：平台、邮件、短信、钉钉群机器人、飞书群机器人、企业微信群机器人。
通知内容：任务异常通知、脏数据通知、源表结构变化通知。
注：数据开发-定时任务需要发布到「生产模式」中，才能使用该功能。
1.3 前提条件
2. 功能说明
任务执行失败后，可通知相关人员任务执失败。
「结果通知」功能默认是关闭状态，需要手动开启。
需注意以下几点：
1）消息通知仅在任务执行失败时，才会通知，任务执行成功不会通知。
2）单个任务的通知限制 10s 一次。例如：
A 任务配置了任务失败提醒和脏数据提醒，在 10:00:00，因为脏数据超限导致任务停止。在 10:00:00~10:00:09.999 之间，如果 A 任务被重复触发，同样因为脏数据超限导致任务停止，不会再重复提醒。在 10:00:00~10:00:09.999 之间，如果 B 任务因为脏数据超限导致任务停止，会再提醒（因为不是同一个任务）。
3）4.1.5.5 以及之后的版本，当构建任务失败，也会给予通知，例如设置通知渠道为「平台」，如下图所示：
2.1 结果通知按钮
默认关闭，需要手动开启。
2.2 通知内容
2.2.1 任务异常通知
任务失败提醒默认为（默认勾选，不可取消）：
独立部署中，各个渠道的通知内容统一为：${任务名} 运行失败，开始执行时间为 2023-03-21 15:22:38，结束时间为 2023-03-21 15:22:41，请前往【任务运维】-【定时任务】-【运行记录】查看详情
具体报错信息：
默认不勾选，勾选后，若任务失败，将发送报错信息
各个渠道的通知内容统一为：
${任务名} 运行失败，开始执行时间为 2023-03-21 15:22:38，结束时间为 2023-03-21 15:22:41，报错节点为【${节点名称}】，具体报错信息。更多报错内容请前往【任务运维】-【定时任务】-【运行记录】查看详情
报错示例：
多个节点出错，各个渠道的通知内容统一为：
${任务名} 运行失败，开始执行时间为 2023-03-21 15:22:38，结束时间为 2023-03-21 15:22:41，报错节点为【${节点名称}】，具体报错信息；报错节点为【${节点名称}】，具体报错信息。更多报错内容请前往【任务运维】-【定时任务】-【运行记录】查看详情
2.2.2 脏数据通知
1）出现脏数据按钮：勾选「脏数据通知」按钮后，「出现脏数据」按钮默认勾选。当定时任务出现脏数据后，进行通知。
2）脏数据汇总信息按钮：勾选后，在定时任务运行完成后，将脏数据按照原因汇总发送给用户。
3）具体报错内容如下表所示：
| 不勾选「脏数据汇总信息」按钮 | 勾选「脏数据汇总信息」按钮 | ||
|---|---|---|---|
标题：数据开发任务脏数据通知 【信息平台】您好，数据开发任务「#taskname#」中，产生脏数据，请前往「任务运维」-「定时任务」模块，在对应任务日志中查看详情。 | 标题：数据开发任务脏数据通知 数据开发任务「#taskname#」中，产生脏数据，原因为#errorReason#，请前往「任务运维」-「定时任务」模块，在对应任务日志中查看详情。
示例：
|
4）任务日志的「统计」Tab下，展示统计对象的脏数据行数；点击脏数据行数可展开查看各错误原因分类下的脏数据条数。
2.2.3 源表结构变化通知
详情使用步骤请参见：设置结果通知
为了保证定时任务的来源表 DDL 变化能通知用户，可在「任务控制>结果通知」下设置通知情况。当运行中的任务出现来源表的 DDL 变化时，即会通知信息给用户。如下所示：
| 项目 | 说明 |
|---|---|
| 使用前提 | 数据同步节点中数据来源「配置方式」选择「选表」 数据去向与映射中勾选了「源表结构变化监测」 |
2.3 平台用户组
当通知渠道为短信/邮件/平台渠道时：基于平台体系配置通知对象，通知对象可选择平台用户、部门、角色，三者取并集。
2.4 通知渠道
统一说明：
1）当通知渠道选择短信/邮件/平台时，「通知对象」中需要勾选「平台用户组」按钮。如下图所示：
2）通知渠道选择短信/邮箱时，「自定义收件人」与「平台用户组」不能同时为空。
3）通知渠道选择短信/邮箱时，「自定义收件人」不支持引用参数。
4）通知渠道选择短信/邮箱时，「平台用户组」中选择了 A 用户，自定义收件人中也设置了 A 用户，不做重复通知。
具体设置说明：
通知渠道选择「客户端」时，可设置通知渠道为钉钉/飞书/企业微信。
注：一个通知渠道中，Webhook 地址不支持填写多个。
钉钉群机器人 Webhook 地址：可参考 自定义机器人接入
飞书群机器人 Webhook 地址：自定义机器人使用指南
企业微信群机器人 Webhook 地址：添加群机器人步骤如下图所示，机器人添加成功的提示页面上会有 webhook 地址：
