ASCII码转EPC插件

1. 简介

1.1 插件简介

ASCII 转 RFID-EPC 插件用于在 ASCII 文本与 RFID 电子标签可写入的 EPC 编码之间进行双向转换。插件支持将资产编号、物料编码、序列号等 ASCII 文本编码为 96-bit / 128-bit 的 EPC 十六进制串，也支持将 EPC 十六进制串还原为原始 ASCII 文本。

插件内置字符校验、全角转半角、超长处理、补位对齐等能力，可在编码前自动识别并处理中文汉字、Emoji、全角符号等无法写入 EPC 的字符，避免因编码不规范导致标签写入失败或读出的数据无法还原。

1.2 应用场景

插件适用于需要将业务编号写入 RFID 电子标签，或从标签读取编号回填至表单的各类场景：

1.3 预期效果

以资产标签打印为例，开启 ASCII 转 RFID-EPC 插件，在「资产编号」字段输入 SN2026092301，选择编码方向后，即可在「EPC 编码」字段返回对应的十六进制串 534E32303236303932333031，并自动回填至对应字段中。

反向操作时，在「EPC 编码」字段粘贴 534E32303236303932333031，选择解码方向后，即可在「还原文本」字段返回原始编号 SN2026092301。

1.4 使用说明

1）ASCII 转 RFID-EPC 插件为付费插件，售价为 9.9 元/月。

2）插件单次转换的字符数受 EPC 位宽限制：96-bit 最多容纳 12 个 ASCII 字符，128-bit 最多容纳 16 个 ASCII 字符。超出容量时，插件会根据「超长处理」参数的设置，选择报错、自动升级位宽或截断。

2. 插件安装及启用

2.1 安装插件

1）直接安装

您可点击右方链接直接安装插件：ASCII 转 RFID-EPC 插件安装。

安装成功后，可参考本文【2.2 启用插件】，前往「开放平台 >> 插件管理」处启用插件。

2）插件市场处安装

在简道云「插件市场」处，安装「ASCII 转 RFID-EPC」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。

2.2 配置插件

安装后，在插件管理处，点击插件右侧的设置按钮，进行插件配置：

全部配置完成后，点击「保存」。

2.3 启用插件

在插件管理中，打开「ASCII 转 RFID-EPC」插件右侧开关，启用插件。

3. 表单搭建

以资产标签打印场景为例，新建「资产标签登记表」，字段设置如下：

4. 前端事件配置

4.1 添加按钮执行动作

点击「是否开始转码」按钮字段，在「字段属性 >> 执行动作」处点击「设置」，添加前端事件：

4.2 设置事件名称和说明

添加好前端事件后，首先设置前端事件的基础信息，即事件名称和说明，用于区分前端事件：

4.3 设置执行动作

设置执行动作如下所示：

全部设置完成后，点击「保存」按钮。

5. 注意事项

1）EPC 仅支持 ASCII 字符。中文汉字、Emoji、日文、韩文等字符无法写入 EPC，编码前请确保编号为英文字母、数字与英文符号的组合。若业务编号含中文，建议改用英文编号，或选择「符号转换」「丢弃」「替换」模式处理。

2）容量限制。96-bit 最多容纳 12 个 ASCII 字符，128-bit 最多容纳 16 个 ASCII 字符。超出容量时，若选择「自动升级位宽」，仅在 96-bit 且内容不超过 16 字符时生效；若内容超过 16 字符，仍会报错。

3）补位方式需与写入端一致。解码时若补位方式与写入时不一致，还原结果可能包含不可打印字符或多余空格。建议编码与解码使用相同的补位方式与补位方向。

4）空格补位存在歧义。以空格补位时，解码剥离首尾空格可能误伤原文中真实存在的空格，插件会给出 W007 提示，请人工确认结果。

5）截断与丢弃不可逆。选择「截断」「丢弃」「替换」模式后，原始内容无法完整还原，插件会给出提示，请确认结果是否符合预期。

6）十六进制串格式。解码时支持带空格、短横线、冒号、点号分隔的十六进制串，也支持 0X 前缀，插件会自动清理后解析。

6. 联系方式

该插件为官方合作的服务商开发，若您在使用过程中有任何疑问，可通过以下方式咨询：