# 勤业打印机

来源快照：`result_data_new_260518.json`

- 来源 ID：`1252562856335228941`
- 模块：资产管理
- 目录：标签打印
- space ID：`1183287979989131273`
- 原文链接：未提供
- 产品基线：未提供

## 正文

# 一、前置准备

工具准备：请提前将标签纸、碳带、打印机等相关硬件设施正常安装，并开启电源键，通过USB正常连接某台Windows电脑。

环境要求：WindowsPC

网络要求：OA服务器 需要可以访问 打印机USB连接的电脑。

如何检测网络条件是否满足？参考3.3

二、

# 核心操作

## 2.1、如何配置打印机？

**第一步** ：**开启** 打印机，并**通过USB** 连接一台Windows电脑 （下文简称打印PC）。

**第二步** ：**下载** 附件【勤业物联数据中台1.01.rar】并在打印PC上**解压，运行** ：

运行程序：勤业物联数据中台1.01\数据中台1.01\Debug，**右键以管理员身份运行** 当前目录下的 DTBIOT.exe；运行后效果如下图：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1252566176179429380&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**第三步** ：**添加** 打印PC的**防火墙入站规则** ，确保打印服务的端口可以正常被访问。

打开防火墙高级设置，点击入站规则，新建规则，选择TCP协议，端口配置 8899

![](https://weapp.eteams.cn/papi/file/preview?fileId=1252566184869503000&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1252566176246013953&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1252566176179429389&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**第四步** ：获取打印PC的IP，尝试访问打印服务，**确认服务运行状态**

win+R呼出CMD命令，输入：ipconfig，拿到ipv4地址，如下图

![](https://weapp.eteams.cn/papi/file/preview?fileId=1252566172044312580&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

假设IPv4的地址是：10.10.20.5，那么当前打印PC的服务则为http://10.10.20.5:8899/api/printer/print

通过任意浏览器访问该地址，如果出现如下图效果，代表服务运行正常：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1252566180415676426&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**第五步** ：将打印**服务注册到OA系统** 中。

使用管理员账号登录系统，访问菜单：设置—>物联设备，准备将我们刚刚启用的打印机注册到OA系统中：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1252566184869502984&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

点击【添加设备】，在弹出的表单页面中，填入打印设备相关的信息，如下图：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1252566172044312586&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 2.2、如何配置打印模板？

使用管理员账号，在设置->标签打印->标签模板中新建

![](https://weapp.eteams.cn/papi/file/preview?fileId=1252566171850383365&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1252566180595204102&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

保存后，页面自动跳转到模板设计器，可在模板设计器中通过新增、拖拽元素，搭建自己的模板效果：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1252566176129564681&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

附件提供了一份65*35的标准模板（资管家6535标准模板.txt），如有需要，可下载后复制内容到配置项中保存使用，效果如下：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1252566184744665109&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 2.3、如何批量打印？

在资产列表中，通过顶部【标签打印】按钮可批量选择数据，前往打印页面：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1252566171879440392&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1252566167732101126&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

注意：如果你的标签打印机中放置的是非RFID芯片标签纸，请关闭RFID模式。

# 三、后续查询

## 3.1、如何查询打印记录？

在打印页面右侧区域提供了打印历史记录查询入口，每一次打印操作都会留痕记录。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1252566180595204108&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 3.2、如何查询打印服务日志？

日志目录：1.01\数据中台1.01\Debug，查看对应的log目录文件即可。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1252566180533583872&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 3.3、如何检测OA服务器是否可以访问打印服务？

打印请求是需要通过OA服务器中转抵达的，因此需要OA服务可以正常访问打印服务，以下是Linux检测网络的常见方式：

1.

### 使用 curl 命令（推荐，直接检测 HTTP 服务响应）

示例：curl -v _http://10.10.10.1:8087_

成功访问：会显示 HTTP 响应（如状态码 200、404 等）

失败情况：

连接超时：可能网络不通或目标端口未开放

拒绝连接：目标端口未监听服务

无法解析主机：IP 地址格式错误或 DNS 问题

2.

### 使用 wget 命令（下载服务响应内容）

示例：wget -O - _http://10.10.10.1:8087_

成功：会显示下载进度和服务返回内容

失败：会提示 "无法连接"、"超时" 等错误

3.

### 先检测端口是否可达（排除网络层问题）

示例：telnet 10.10.10.1 8087

端口开放：telnet 会显示 "Connected"；nc 会显示 "succeeded!"

端口未开放：会提示 "Connection refused" 或超时

如果OA服务器没有办法访问打印服务，需要将打印服务做内网穿透映射到外网，并且配置相关安全策略，如仅限OA服务器的IP可访问。示例：打印服务： _http://10.10.10.1:8087_ ，通过穿透映射，产生一个外网地址：http://zgjprint-server-demo.com.cn:8087 (_http://172.14.20.152:8087_)。

 

四、

# 问题解决

1、

## SocketTimeoutException Connect timedout

**【报错含义】：**

网络不通或OA服务器无法正常连接打印服务

**【诊断步骤及应对措施】：**

参考3.3检查下网络条件或打印服务是否正常启动

## 2、打印RFID标签会打印“作废”字样

**【报错含义】：**  
 对于带epc/user数据的RFID打印操作，当打印过程中打印机无法将epc/user数据写入标签芯片时，打印机会在当前标签上打印“作废”字样；然后转到下一张标签进行补打，如果连续三次补打依旧失败，打印机将报错并停止工作；  
**【诊断步骤及应对措施】：**  
① 请检查标签是否已损坏。  
② 请检查标签有没有对标签进行RFID标签定位校准（换不同规格标签/更新升级固件/打印机恢复出厂设置等操作后，都需要重新进行RFID标签定位校准操作）  
③ 请检查是否对不带user区的标签执行写user操作。  
④ 请检查epc/user数据是否过长。可以查看标签规格书看标签支持多少数据，如果超标签规格，会因写不进去导致打印作废。  
⑤ 请检查将要写入的epc/user数据长度是否合法。ASCII类型数据长度必须为2个字符的整数倍，HexStr类型数据长度必须为4个字符的整数倍。  
⑥ 使用了普通标签进行打印，无法读写到标签RFID区域；  
⑦ 标签协议与机器模块不设配（比如标签的频段对不上，高频协议标签在超高频机器上使用）  
⑧ 如果是特殊标签，需要对应标签规格书的要求进行操作；检查标签密码是否定制，还有标签epc/user数据长度写入规则是否不一样。

## 3、微软、UC、QQ、edge、谷歌、猎豹等浏览器跨域问题

**【报错原因】：**  
 目前打印服务已支持对浏览器发起跨域请求，但如果出现谷歌浏览器上返回跨错误时，由于谷歌98版本之后，网站对私有服务发出请求前，浏览器都会自动发出一个“预检请求”，如果服务不认识预检请求，就不会正确返回，浏览器便会拦截所有预检请求不通过的请求。同时报跨域的错误；  
**【处理措施】：**  
 因为是浏览器拦截了数据包的请求；该跨域问题在于浏览器本身，新版本的谷歌浏览器就需要进入浏览器在地址栏输入：chrome://flags/#block-insecure-private-network-requests 回车访问 搜索Block insecure private network requests，将其设置为Disabled后重启浏览器运行才能解决；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1252566172010291201&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)
