模板消息预警
概述
模板消息预警是一种在满足预警条件时，将观远BI平台的数据通过变量匹配关联到飞书和钉钉的结构化消息卡片模板，实现预警消息以结构化卡片形式推送的功能。
飞书模板消息预警
前提条件
-
在观远与飞书的管理后台，完成观远与飞书集成的准备工作，具体操作请参考飞书完全集成方案。
-
在飞书的卡片搭建工具中创建并发布需要发送的消息卡片模板，具体用法请参考飞书卡片搭建工具概述。
-
卡片模板中对于需要从观远BI平台中获取的动态数据，需要提前配置卡片变量。
-
在卡片模板中需要添加自定义机器人/应用，确保指定的应用和「所有自定义机器人」拥有发送该卡片模板的权限。
-
创建并配置模板消息预警
-
在观远BI平台中，点击右上角「九宫格」按钮中的「预警中心」，依次点击「模板消息预警 > 添加模版消息预警」。
-
基础信息和触发机制的详细配置信息见卡片预警。
-
对「预警发送」进行配置，选择「飞书」作为通知渠道，支持「消息通知]和「群机器人」两种通知方式。
-
消息通知：可添加观远BI平台中的用户或用户组作为收件人，预警消息会单独发送至个人。
-
群机器人：可通过群机器人将预警消息发送到飞书群，具体用法请参考使用群机器人推送信息通知。
-
-
对「预警内容」进行配置。
- 模板ID：点击下拉框获取当前BI对应应用下所有的模板ID，支持通过模板ID和名称进行模糊搜索。卡片模板需要指定到当前BI对应的应用，若卡片模板设置的是所有应用，BI平台无法自动获取到该卡片模板。
- 版本号：点击下拉框选择模板的版本号。默认选择最新版本，支持选择到历史版本，选择历史版本则会按照历史版本的模板进行匹配后发送消息卡片。
- 变量匹配：对于飞书卡片模板中配置好的卡片变量，需要匹配到BI平台中来自可视化卡片的动态数据、卡片等（根据变量类型不同，需要匹配的BI元素不同）。具体配置内容可以参考模板消息订阅
目前支持匹配的飞书变量类型包括文本、整数、图片、图片数组、对象数组、表格行数据、分端差异化链接。
-
若需要通过飞书消息卡片直接发送表格（如下图），需要配置「表格行数据」变量。
-
飞书消息卡片中：「表格」组件对应「表格行数据」变量，变量中需要添加字段列、设置字段的key以及字段类型。
-
观远BI平台中：添加「表格行数据」类型的变量，变量中添加列，列名填入飞书消息卡片中该字段的key，字段类型与飞书保持一致即可。
-
-
若需要通过飞书消息卡片直接发送可视化图表（如下图），需要配置「图片数组」变量。
-
飞书消息卡片中：「图表」组件对应「对象」变量。
-
观远BI平台中：「变量类型」选择「图片数组」，选择一个匹配的可视化卡片即可。
-
-
预警内容配置完成后，可以通过「向我发送预览」在飞书上查看最终收到的消息卡片效果，确认样式和数据无误后点击「确定」，完整的模板消息预警配置完毕。
钉钉模板消息预警
前提条件
-
在观远与钉钉的管理后台，完成观远与钉钉集成的准备工作，详见钉钉完全集成方案。
-
填写机器人编码。
- 在钉钉开放平台创建群机器人，钉钉群机器人创建请参考使用群机器人推送信息通知。
- 在钉钉开放平台打开「机器人配置」，点击「复制RobotCode」。
- 在观远BI「管理中心 > 系统集成 > 办公OA > 钉钉」界面，开启应用，将上一步复制的RobotCode填入「机器人编码」中，点击「保存」。
-
在钉钉的卡片搭建工具中创建并发布需要发送的消息卡片模板，详细操作请参考卡片模板。
创建并配置模板消息预警
-
在观远BI平台中，点击右上角「九宫格」，进入「 预警中心> 模板消息预警 」，点击右上角「添加模板消息预警」。
-
基础信息和触发机制的详细配置信息见卡片预警。
-
对「预警发送」进行配置，选择「钉钉」作为通知渠道，支持「消息通知」和「群机器人」两种通知方式。
-
消息通知：可添加观远BI平台中的用户或用户组作为收件人，预警消息会单独发送至个人。
-
群机器人：钉钉模板消息预警使用的机器人与普通的预警不同，钉钉是通过「企业内部应用」机器人发送预警消息，一个企业内部应用对应了一个机器人，具体操作请参见使用群机器人推送信息通知 。
-
-
对「预警内容」进行配置。
-
模板ID：填写中创建的卡片模板ID，可以在模板列表中获取。
-
变量匹配：对于钉钉模板中配置好的卡片变量，需要匹配到BI平台中来自可视化卡片的动态数据、卡片等（根据变量类型不同，需要匹配的BI元素不同）。
目前支持匹配的钉钉变量类型包括文本、整数、图片、图片数组、对象数组、表格行数组、分端差异化链接。
-
-
「预警内容」配置完成后，可以通过「向我发送预览」在钉钉上查看最终收到的消息卡片效果，确认样式和数据无误后点击「确定」，完整的模板消息预警配置完毕。
常见问题
关于预警相关的常见问题，详见常见问题。