分享一个能方便生成微信卡片消息模板的自定义公式

Simon.hu

本帖最后由 phoben 于 2021-4-25 19:57 编辑

在使用企业微信的小伙伴应该都熟悉"企业微信卡片"消息功能，这是使用频率非常高的一个API
我们平时使用，一般都会将API封装成服务器命令，方便我们发送
例如这样：
image.png453457641.png

发送后一般客户端收到样式为：
image.png564850768.png

我们知道description参数是消息内容体，官方文档的介绍其实是支持HTML格式的，能换行和变色

特殊说明：
卡片消息的展现形式非常灵活，支持使用br标签或者空格来进行换行处理，也支持使用div标签来使用不同的字体颜色，目前内置了3种文字颜色：灰色(gray)、高亮(highlight)、默认黑色(normal)，将其作为div标签的class属性即可，具体用法请参考上面的示例。

我们看下官方给的例子，这个消息体本身不复杂，就是几个div加个class类名

{
"description" : "<div class="gray">2016年9月26日</div> <div class="normal">恭喜你抽中iPhone 7一台，领奖码：xxxx</div><div class="highlight">请于2016年10月10日前联系行政同事领取</div>",
}

复制代码

但是这一串东西，咱们想要在活字格的公式栏打出来，还真不是一件容易的事儿，尤其还得结合单元格引用来使用。
捣鼓半天,三条文本也拼接不明白，只好作罢，最后只好用最简单的文本发送完事儿!
image.png426538390.png

所以一不做二不休
就干脆做了个小函数，让大家可以快速生成标准的消息模板，这里不敢独享，给大家分享出来
如下图：

image.png849663085.png

以前拼接这样的一段文本，公示栏的拼接相信很难理清楚，现在只需要这么一句话
=WXTEXTCARD("高亮|标题：测试消息","内容：收到一条业务消息...")
就能得到这么一个带颜色、带当前日期的模板字符串，返回后的字符串传给API作为参数即可

image.png696486205.png

------------------------------公式使用说明------------------------
1、下载本帖的js文件，再活字格设置中上传
2、在所有支持公式的地方，可使用=WXTEXTCARD()公式取得标准模板字符串

公式范例：支持最多99条消息体=WXTEXTCARD(arg1,arg2,...)

arg参数说明: 每个参数都由一端字符串组成，有三个配置项，用"|"分割，配置项分别是 "type|content|wrap"

参数名	说明
type	文字颜色，支持三种：默认、灰色、高亮，不填则为默认黑色字
content	要发送的消息文本
wrap	本条消息后是否空一行，填写true或者false,不填则为false