目录

安装和使用

二次开发手册

常见问题

打印精灵(PrintSpirit)和一般的标签打印软件相比有哪些不同，有什么优势。

答：打印精灵由精灵三剑客SpiritDesigner, SpiritLabel, SpiritWeb共同组成独特的标签打印解决方案。 与一般的标签打印软件如BarTender, Dlabel 相比，最大的特点就是组件化，使得打印精灵在可靠性、 扩展性、开放性、平台适应性等方面具有独特的优势。

  • 可靠性。 一般的标签打印软件就是一个独立的windows应用程序。而打印精灵的核心功能由不同的组件完成， 组件不会相互干扰，资源占用少。比如工厂车间日常使用时，只需要专注打印，不需要标签设计功能，不会因为标签设计功能 的BUG影响打印。

  • 扩展性。SpiritWeb提供标签打印的底层支持，自动将标签格式转换为ZPL或windows打印命令。在维持SpiritWeb 打印API不变的情况下，可以非常容易地扩展应用层，实现各种非常特殊的打印功能，比如换标打印。

  • 开放性。SpiritWeb提供开放式的标签打印API, 可以快速开发各种定制化的打印功能。满足行业的特殊需要。

  • 跨平台适应性。SpiritDesigner，SpiritLabel均在浏览器中运行，天然具有跨平台特性。SpiritWeb本质上是一个 服务程序，可以支持windows, linux等操作系统。

打印精灵(PrintSpirit)支持liunx操作系统吗

答：支持。

打印精灵(PrintSpirit)都支持哪些打印机

答：SPIRIT采用设备无关模式设计，原则上支持任意种类的打印机。具体如下：

  1. 对于网页打印：支持任何Windows支持的打印机 + 兼容ZPL/CPLC打印指令集的打印机。
  2. 对于嵌入式设备/移动设备，目前支持兼容ZPL/CPLC打印指令集的打印机。

有设计好的标签模板共选用吗？

平台提供了模板共享区，这是一个相互交流的场地，通过SpiritDesigner设计的标签模板都可以在这里共享。

在企业内网中能使用打印精灵(PrintSpirit)吗？

答： 可以。具体方案如下:

方案1

本地下载设计好的标签。在我的标签（或共享标签）中，选择需要的标签，并下载。让后将对应的文件拷贝到打印控件 安装目录/labels下。可以保留下载时缺省的文件名,也可以另设文件名,打印时将使用这个名字查找标签.

标签下载

方案1的缺点是，必须每台需要打印的机器都必须拷贝标签文件。如果有多台设备，更新模板时工作量较大。

方案2

将其中一台机器作为主服务，设置其他PC修改配置指明从该服务器获取标签数据, 形成主从结构。这样把标签文件拷贝到主机上即可。 有多种实现方式， 参考：生产型企业内网环境下条码打印解决方案

注意: 该方案必须打开PC机防火墙, 确保9011端口可以在从机上访问.

具体操作如下：

打开打印精灵控制台，在参数栏添加: master=主服务器IP地址并保存.

或使用API, 在open时设置main参数

SPIRIT.open({"master":"主服务器IP地址"}, function(p){
    ...
})

或使用setUrl(url), 注意差别: setUrl()需要写完整的路径, 而main参数只需要IP地址, 同时setUrl()的优先级高于main参数.

SPIRIT.setUrl("http://主服务器IP地址:9011/load-template?id=")
SPIRIT.open({}, function(p){
    ...
})

什么是模板ID?如何获取。

模板ID是在本平台编辑模板后生成的唯一标识，通过模板ID可以访问，编辑制定的模板。

在共享模板或用户中心我的模板中，可以查看模板的ID。

模板ID

什么是模板变量？规则是什么？

详见如何实现可变数据打印

模板变量名支持中文吗?

支持。

如何实现可变数据打印

打印精灵支持强大的可变数据打印功能. 设计模板时, 可以指定占位符(称为:模板变量), 打印时模板变量将自动替换为实际值, 同一个标签模板可以打印不同的内容, 实现可变数据打印.

无论是使用SpiritLabel, 还是API方式打印标签, 使用模板的设计方式均相同.

例子 如果一个TEXT字段, 内容为: [姓名name, 地址:addr], 用了两个变量name, addr

以JS API方式为例, 打印时，PrintLabel的第二个参数为变量列表，会自动替换对应的模板变量，

 PrintLabel(labelID, {name:"张三", addr:"四川成都"});

那么实际打印内容将是： [姓名：张山 地址：四川成都]

模板变量也可以是结构化的数据，如：receiver.name、receiver.addr等等，receiver包含了多个字段。

 PrintLabel(labelID, { 
   receiver: { name:"张三", addr:"四川成都"}
 });

支持可变数据的元素包括: 文字,多行文字,一维条码,二维条码, 每个元素可以包含任意数量的变量. 创建模板时, 操作步骤如下.

  1. 选中元素 (文字,多行文字,一维条码,二维条码)
  2. 双击元素或在工具栏点击文字编辑 打开文字编辑对话框.
可变数据编辑
  1. 在文字编辑框里, 可以输入文字和模板变量(数量任意). 模板变量包括预定义变量, 自增序列, 自定义变量三类.
    • 预定义变量, 打印精灵内置的常用变量,如日期, 时间等.
    • 自增序列, 该值在每次打印一张标签后自动增加.可以指定前导符,位数,增量(步长)
    • 自定义变量, 每个自定义变量名称可以是字母数字,也可以是中文; 自定义变量的示例值仅在模板编辑时显示, 打印会自动替换为变量的实际值.

可以不共享模板吗？因为这可能涉及企业机密。

可以.

基于互联网的共享精神，我们鼓励大家共享自己的设计。但是考虑到企业的实际情况, 有三种方式可以选择, 如有需求请联系打印精灵业务支持

  • 采用企业帐号，可以不共享设计，供有保密需求的企业选用。
  • 使用SpiritDesktop, 该软件集标签编辑、标签打印为一体，功能与在线版本打印精灵基本一致, 但无需连接互联网, 主要供有内网需求的客户使用.
  • 使用SpiritCenter, 在SpiritDesktop的基础上增加了打印机集中管理功能.

无法打印中文

答： 由于汉字处理在ZPL/CPLC中为非标部分，不同的厂家可能在打印机里面装了不同的汉字库，可能造成无法识别汉字库而无法打印中文。 打印精灵采用的方式是: 使用0号字体作为缺省处理字体. 国产的打印机0号字体一般都支持中文, 但是进口的打印机0号字体不一定支持中文, 因此可能出现不能打印机汉字的问题. 解决该问题，一般有两种处理方法：

  1. 询问打印机厂家，获取打印机汉字库名称，在程序或驱动设置里设定font="汉字字体名称"来解决。
  2. 对于网页打印，如果该打印机可以提供windows驱动程序，可以选择windows打印模式来解决。

留言

登录