快手云打印编辑器使用教程(ISV版)
快手云打印编辑器是由快手官方推出的,能让使用快手电子面单的商家与ISV更快捷地进行电子面单模板编辑的效率工具。本平台提供两种操作人角色:商家和ISV。为了让ISV尽快接入本平台,并对其用户开放本平台功能,请认真阅读以下操作指导!
1、云打印编辑器
●编辑器界面:
●登录账号:在快手服务市场注册APPKEY时所登录的账号
2、使用流程
2.1 接口
●获取商家自定义区/ISV预设自定义区列表:open.express.custom.tempate.list.query(接口文档)
●获取ISV打印项列表:open.express.printer.element.query(接口文档)
3、ISV使用
3.1 设置打印项
ISV可以自由配置电子面单模板打印项,可在打印项中自由添加基础元素(文本、线条、矩形、码式、图片)。其中,文本元素配置中的文本内容和码式元素中的条码内容的在实际打单作业中是需要动态传值的(通过打印报文的自定义区 customData 传递),所以文本与码式的文本内容请按照以下格式编写:
例:打印报文中自定义区域 customData 格式:
若面单上需要打印出文本(码式)对应的value1、value2、value3,则在打印项设置时,对应的文本(码式)元素的文本内容需要填写<%=_data.key1%>、<%=_data.key2%>、<%=_data.key3%>。在设置自定义区时,通过拖拽对应打印项编辑发布生成自定义区域模板,上述templateURL 的模板内容如下:
通过获取商家自定义区/ISV预设自定义区列表接口拿到自定义模板的返回值中 placeholderKeys 字段标识了设置模板时所有的一级占位符,同样以上面为例,设置完模板后,调接口返回值中的 placeholderKeys 为 ["key1", "key2", "key3"]。
●placeholderKeys 为一级占位符的含义:仅会返回 <%=_data.一级占位符.二级占位符%> 的一级占位符,如设置模板中文本(码式)的文本内容包括 <%=_data.person.name%>、<%=_data.person.age%>、<%=_data.remark%>,本参数返回["person", "remark"]。