酷应用高频FAQ及典型场景设计指南
钉钉全场域一键调用使用酷应用
Q1：如何在钉钉全场域调用使用酷应用
- 酷应用也有自己的酷应用专属链接（需要更换酷应用品的coolappcode）啦，可在钉钉全场域一键调用，以后启动酷应用不仅局限在【酷应用中心广场、主应用详情页】，还可在钉钉端内全面扩散，比如服务窗、短视频、直播、各种资源位等
- ISV可以把coolapp code替换成自己的酷应用code即可，可以把做的酷应用品在各个场域分发给客户，增强传播，效果如下：【目前链接仅支持手机端打开访问使用】
- 特殊说明：如果选择群列表为空，请确认当前手机端登录的企业组织内是否有新建内部群，如果无，请新建后方可在群内使用
酷应用入口
Q1：宜搭应用和酷应用是什么关系？酷应用的入口，在哪里新建酷应用？
A：目前酷应用不是宜搭的一个单独应用，酷应用能力主要分为酷消息、酷动态卡片、酷置顶卡片、酷看板、酷机器人等，这些酷应用能力会嵌入到宜搭功能的各个形态内，使得宜搭搭建的应用默认具备酷应用能力。了解详情，具体可根据您想要的效果在对应的配置入口内搭建酷能力。
卡片
Q1：在哪里可以快速新建卡片并且发送/更新卡片？
A：您可以在集成自动化/新版简易流程设计器内 新增发送/更新卡片节点，可以选择官方提供的卡片模板或自定义交互/群置顶卡片，进行自定义卡片设计。
Q2：集成自动化中已配置卡片发送/更新节点，日志执行成功后显示发送卡片成功，但仍旧没有收到？
A：目前卡片发送失败常见3个原因：
1. 酷应用没有上架到到企业自建应用中心内，需要将应用先发布到企业自建应用中心内。
2. 酷应用没有在组织内部群/部门群的 群快捷栏“更多>酷应用市场”启用，需要先启用自建酷应用。
3. 没有从群中发起表单（没有群上下文），例如使用”定时触发+卡片发送到当前群“，该case场景不支持。”定时触发+卡片发送到指定群“在指定群内发起表单可以获得表单上下文，卡片可发送成功。
Q3：在自定义卡片设计器内重新设计卡片样式后，钉钉发送出来的卡片尚未及时生效？
卡片更新后，需要重新触发卡片的发送或更新才能发送或更新新卡片。但由于端内缓存的影响，可能出现新触发后卡片样式没有更新的情况。如果出现该情况，可以通过钉钉偏好设置>高级>其他>一键清理，勾选”清除图片缓存、清楚Web缓存“即可。
Q4：卡片内如何实现at人效果？
A：设计卡片时引入人员变量，在集成自动化卡片节点内映射成员数据
- 在卡片设计器>数据源内新增一个“变量类型为用户信息”的普通变量，同时可定义mock数据，拖入富文本组件，在组件setter面板里@命名的变量
- 您可以在集成自动化/新版简易流程设计器内 新增发送/更新卡片节点，在配置卡片内容里可以进行卡片数据源绑定，将成员字段映射到该“用户信息”变量上，即可实现at人效果
Q5：如何实现卡片上展示指标卡/进度条等数据统计指标，实现类似酷看板的效果
- 具体配置链路可访问 查看2022.08.16 版本更新-宜搭酷看板（数据服务+酷数据卡片）了解详情
- 暂不支持在卡片上渲染报表图表组件
- 需要注意的时，针对不同的业务场景，如果显示指标数量不等，有不同的建议设计方案：
- 如果当前需要显示≥3个循环指标卡，请使用卡片设计器>组件库>循环渲染容器 进行功能配置
- 如果当前需要显示≤3个循环指标卡，可使用卡片设计器>区块组件库>循环指标卡 进行功能配置
Q6：卡片上显示数据统计类指标，显示的指标数据默认是小数，如何改成%百分数显示？
在 数据工厂>数据服务>新建公式字段，通过公式进行百分比处理，具体可参考如下配置，了解完整配置详情可查看2022.08.16 版本更新-宜搭酷看板（数据服务+酷数据卡片）
Q7：卡片上的元素如按钮如何按条件显示或隐藏
以“群订餐”场景为例，当订餐份数已售罄时，显示“已售罄”按钮，隐藏“预定”按钮
- 在卡片设计器内定义按条件判断的普通变量，如“已售罄”，变量类型为“布尔值”，同时配置mock数据
- 将所有需要设置显示或隐藏的按钮全部拖入画布设计器，在按钮的setter配置面板内，针对“是否显示 ”属性进行配置，定义条件且绑定step1所定义的变量，当布尔值为真时，显示该组件，否则隐藏该组件
- 在集成自动化内配置卡片节点，将流程上下文的数据与卡片数据源变量进行映射即可。
Q8：群快捷栏上面，可以放置一个应用的多个页面作为多个入口吗？
支持的，现在一个酷应用可以放置多个快捷入口到群快捷栏上面，支持展开的形式，不支持折叠的形式。
Q9：自定义页面跳转表单页面，如何传递当前群的群id参数？
酷应用默认只在群快捷栏打开的第一个页面上会默认带上「群id（conversationId）」，如果需要将参数传递，可以通过 url 带参数的形式。
假设群快捷栏入口地址配置的是一个自定义页面，然后点击自定义页面上面的某个按钮或者链接跳转到一个表单页面，这时候需要在表单页面上面获取到群id，提交后才能发送卡片到对应的群内。
操作方式：
在自定义页面上面，通过链接块跳转到表单页面，如果链接块配置的“内部页面”，那么「群id」参数会自动带过去。
如果链接块配置的是“外部链接”，那么需要手动将「群id」参数传递过去。
代码如下：
(this.state.urlParams || {}).conversationId
在表单中新增一个单行文本组件，标题取名叫“群id”，然后状态设置为隐藏，数据提交设置为“始终提交”。
!!!IMPORTANT: 其中默认值绑定一个变量，通过获取 url 上面的参数填入「群id」参数。
代码如下：
decodeURIComponent((this.state.urlParams || {}).conversationId)
最后，在发送到群的时候，既可以选择“当前群”，也可以选择“群id”所在的群。
