简道云打印插件

最低版本要求: v2.0.2

考虑到简道云标准版不具备自建插件开发能力, 我们通过分析其现有钉钉群机器人的通信接口, 实现了一套兼容方案, 用来实现打印功能。

安装插件

在简道云开放平台安装钉钉群机器人插件, 安装完成后, 可使用智能助手/前端事件等方式调用插件

配置插件

插件配置只需要填写下文中声明的信息, 其他未提及的配置无需填写或保持空值

插件函数

选择发送文本消息函数

推送地址

https://weight-api.zhengshuyun.com/print/printByJdyDingTalkGroupRobot

消息内容

详情见下文中的参数配置

参数配置

每行一个键值对, 键值之间用:(英文半角冒号)隔开

qr

二维码的内容(不填时不生成二维码)

height

高度

width

宽度

qrSize

二维码的尺寸

fontSize

打印文本内容的字体大小

printSize

打印的数量

userId

用户ID

用于指定在哪个账号下执行打印任务

secret

密钥

用于身份验证, 确保请求的合法性

当前功能暂未实现，可作为保留字段，暂时可以不传

推荐可以在简道云建立一个名为全局配置的表单, 有2个字段, 分别为key和value

当要在使用表单时, 可以用数据关联功能, 获取key的值作为value的值自动填入插件内, 以此控制全局变量的更改

如果按照这样操作, 以后如果启用了该字段, 只需要在全局配置中添加一条记录: key为secret, value为真实密钥即可替换全局的插件配置

自定义打印内容

非以上系统参数的行, 均会被打印

参数填写错误系统识别失败的也会被视为自定义打印内容被打印

消息内容示例

// 中文部分替换为真实的数据(注意不要把//注释也填进消息内容)
// 以下为固定配置
qr:二维码
height:高度
width:宽度
qrSize:二维码大小
fontSize:字体大小
printSize:打印数量
userId:用户ID(在对应账号打印)
secret:密钥(暂未实现, 可不传)
// 以下为要打印的内容
内容键1:内容值1
内容键2:内容值2
我是张三
天王盖地虎
// 以此类推...

注意事项

• 用户ID(userId)为空或不正确时, 无法打印
• 用户不在线, 会记录到后台, 用户上线后自动打印
• 用户关闭了打印功能时, 无法打印, 也不会被记录到后台
• 传参错误, 插件会有执行失败记录
• 每一行只允许出现一个冒号, 第二个冒号后面的数据不会被取值(这个应该可以优化一下)