1. 概述
1.1 应用场景
飞书集成环境下，希望能够将结构化的图表内容以卡片形式嵌入至聊天消息、群置顶消息、链接预览等飞书协作场景中，提升信息传递效率。
例如消息卡片场景下，用户通过消息卡片推送项目报告、业务监控、审批流转等信息。
1.2 功能简介
仪表板新增「发布飞书卡片」功能，将产品中的图表字段与飞书卡片中的变量进行映射匹配后可推送至飞书的个人/群组中。
「使用指定应用发送飞书卡片」：添加应用后，该应用可通过发送消息相关 API 向指定成员推送消息。
「使用自定义机器人发送飞书卡片」：绑定自定义机器人后，该自定义机器人通过 webhook 向群聊推送卡片消息。
1.3 注意事项
需要在 飞书集成模式 下才能使用。
2. 功能说明
| 配置项 | 说明 |
|---|---|
| 卡片设置简述 | 卡片设置名称 |
| 定时发送 | 设置定时发送开始时间和执行频率 |
| 发送到人 | 通过应用发送到指定用户可查看，点击出现成员选择弹窗 |
| 发送到群 | 通过机器人发送到群，点击后可设置 Webhook |
| 卡片ID | 飞书卡片ID（仅支持新版本飞书卡片） |
| 变量匹配 | 需将飞书中配置完成的卡片变量与九图表字段做匹配，才可在飞书卡片中正确映射显示 支持的变量类型： 文本：
表格行数据：
对象：即分析图表，仅支持柱形图、折线图、条形图、饼状图、面积图、漏斗图、词云；
注：飞书卡片中的所有变量均需匹配才可发送成功。 |
3. 准备工作
3.1 创建应用
若用户 使用指定应用发送飞书卡片，则需要参考链接文档创建并配置应用。
登录飞书开发者后台，在 企业自建应用 页签，点击 创建企业自建应用。配置应用名称、应用描述以及应用图标，并点击创建。
进入应用详情页，在左侧导航栏中，进入 测试企业与人员 页面，并在页面右上角点击 创建测试企业 创建你的测试企业或关联已有测试企业。
在 操作 列，点击 关联应用。
测试企业关联应用后，在页面顶部切换企业应用为测试版本应用。
若你使用的是正式版本应用而非测试版本，你需要创建应用版本并发布应用，上述配置才可生效。
在左侧导航栏中，进入 应用能力 > 添加应用能力 页面，找到 机器人 卡片，并点击 添加。
在左侧导航栏中，进入 开发配置 > 权限管理，在 权限管理 页面中，点击 开通权限。将以下权限的 Key 粘贴到权限搜索框，点击 确认开通 权限：
im:message:send_as_bot
应用的可用范围必须是所有用户，如下图所示：
3.2 创建群自定义机器人
若用户 使用自定义机器人发送飞书卡片，则需要参考链接文档创建并配置应用。
登录飞书客户端。创建一个群聊，打开群聊的设置界面。
打开群聊的 设置 界面，添加自定义机器人，如下图所示：
复制并保存好 Webhook 地址，如下图所示：
3.3 开通权限
保证应用中以下权限均被开通，详情参见：配置应用权限
3.4 在飞书中创建卡片
如何制作飞书卡片请参考飞书官方文档：飞书卡片
https://open.feishu.cn/cardkit 进入飞书卡片搭建环境，创建卡片：
接下来在飞书卡片中配置变量，详情请参见：配置卡片变量
将组件拖入界面后，可以在组件中设置变量，如下图所示：
表格还可以设置列变量，如下图所示：
制作完成后，即可在将卡片添加至应用和自定义机器人。「以下应用可通过 API 调用该卡片」中需添加卡片所在的应用和「九数云应用」，如下图所示：
若非管理员无法添加「九数云应用」，则直接添加「所有应用」。如下图所示：
保存卡片并发布，如下图所示：
4. 操作步骤
4.1 仪表板设置卡片
进入项目下的指定仪表板中，拖入图表后，点击「发布飞书卡片」，如下图所示：
复制卡片 ID ，如下图所示：
进行卡片配置，此处设置发送到机器人群中，输入 Webhook、卡片ID，并匹配变量，输入卡片中的变量名，由于卡片中变量设置的是柱状图，因此选择对象，并选择仪表板中的图表组件，如下图所示：
对于图表Pro，需要手动选择飞书图表中的 X轴和 Y轴分别匹配图表 Pro 中的哪个字段，如下图所示：
在设置完成后，用户还可以点击「向我发送预览」测试是否设置成功，如下图所示：
4.2 变量匹配说明
飞书卡片中的所有变量均需成功匹配才可发送成功，请参考下文的匹配关系进行配置。
| 匹配的飞书展示类型 | 获取变量名称 | 变量类型 | 匹配详情 |
|---|---|---|---|
| 图表 | 在飞书卡片的「图表>组件配置>绑定变量」中添加变量，下图中 L1 为变量名称。
| 对象 | 仅图表Pro需手动配置匹配字段。 和九数云的图表组件进行匹配：从图表使用的字段中选择对应字段，匹配飞书图表中的「X轴」和「Y轴」
效果如下图所示：
|
| 文本 | 在飞书卡片的文本中添加变量。下图中的 WB 即为「变量名称」
| 文本 | 和九数云的指标卡进行匹配：通过变量获取到指标卡的指标数值，填入文本中变量的对应位置
效果如下图所示：
|
| 表格 | 在飞书中添加表格，并获取「行变量」以及每列数据的 「Key」
【飞书】行变量 = 【表格行数据】变量名称 【飞书】Key = 【表格行数据】下的子变量名称 | 表格行数据 | 和九数云的表格进行匹配：通过变量获取到表格每列数据详情（只支持匹配明细表中的文本字段）
注：为顺利回填数据，表格中的合同金额为文本字段。
|
4.3 效果查看
在消息中即可看到群聊机器人通知发送了变量生效后的卡片内容，如下图所示：
若设置了多种展示类型，发送的效果如下图所示：
上一篇：组件操作及快捷键
