集装箱箱号识别插件
1. 简介
1.1 插件简介
集装箱箱号识别插件,用于识别和核验集装箱箱号。用户通过拍照或者上传一张带集装箱箱号信息的照片,即可返回图片中的集装箱箱号、集装箱归属、箱号、箱重等信息,同时对信息进行校验并返回校验结果及校验详情。
1.2 应用场景
如在货运管理系统中,可以自动识别集装箱箱号信息并校验,确保快速且准确地录入到业务系统中,有效解决人工抄录过程中抄错、抄漏等问题,减少人工录入工作量,降低出错概率和企业人力成本。
1.3 预期效果
开启集装箱箱号识别插件,拍照上传或者直接上传一张待识别的带集装箱信息照片后,即可返回读数结果,并自动回填至对应字段中。
1.4 使用说明
集装箱箱号识别插件为付费插件,每次调用插件进行集装箱箱号识别消耗 0.28 个 云币。在使用插件时自动扣除云币数量,当云币余额可支付的识别次数为 0 时,将无法使用集装箱箱号识别与核验插件。
2. 插件安装及启用
2.1 安装插件
1)直接安装
- 您可点击右方链接直接安装插件:集装箱箱号识别插件安装。
- 安装成功后,可参考本文【2.2 启用插件】,前往「开放平台 >> 插件管理」处配置并启用插件。
2)插件市场处安装
在简道云「插件市场」处,安装「集装箱箱号识别」插件。插件市场处安装方法可参见文档:插件市场中【2.3 插件安装】。
2.2 启动插件
在插件管理中,打开「集装箱箱号识别」插件右侧开关,启用插件。
3. 表单搭建
插件使用体验:集装箱箱号识别插件模板表单。本文将按照示例表单进行讲解。
以集装箱信息记录为例,新建「集装箱信息记录表」表单,字段设置如下:
字段说明 | 字段名称 | 字段类型 |
—— | 货物负责人 | 成员单选 |
到货日期 | 日期时间 | |
集装箱信息 | 集装箱图片 | 图片 |
集装箱箱号 | 单行文本 | |
集装箱所有者 | ||
集装箱类型 | ||
箱重(KGS) | ||
核验结果 | ||
核验详情 |
4. 前端事件配置
4.1 添加前端事件
进入「表单属性」,点击前端事件下的「设置」,添加前端事件:
4.2 设置事件名称&说明
添加好前端事件后,首先设置前端事件的基础信息,即事件名称和事件说明,用于区分前端事件:
4.3 设置触发动作
设置触发动作:触发字段选择「集装箱信息图片」字段。
4.4 设置执行动作
1)设置执行动作如下所示:
- 选择插件:选择「集装箱箱号识别」插件;
- 集装箱信息图片:设置为字段值,即「集装箱图片」字段;
2)在「字段存储关系」处,点击「添加」按钮,并选择全部字段,设置如下所示的字段回填关系:
- 集装箱箱号:回填到「集装箱箱号」字段;
- 集装箱所属:回填到「集装箱所有者」字段;
- 集装箱类型:回填到「集装箱类型」字段;
- 箱重(KGS):回填到「箱重(KGS)」字段;
- 核验结果:回填到「核验结果」字段;
- 核验详情:回填到「核验详情」字段;
设置完成后点击「保存」。
4.5 效果演示
效果参见本文【1.3 预期效果】。
5. 集装箱箱号核验规则与核验结果
5.1 集装箱箱号规则及其核验规则
1)标准箱号采用 ISO6346(1995)标准,由11位编码组成,包括如下所示三个部分:
- 第一部分:由 4 位英文字母组成。前三位代码 (Owner Code) 主要说明箱主、经营人,第四位代码说明集装箱的类型。列如CBHU 开头的标准集装箱是表明箱主和经营人为中远集运。
- 第二部分:由 6 位数字组成。是箱体注册码(Registration Code),用于一个集装箱箱体持有的唯一标识。
- 第三部分:为校验码(Check Digit)由前 4 位字母和 6 位数字经过校验规则运算得到,用于识别在校验时是否发生错误。即第 11 位数字。
2)根据校验规则箱号的每个字母和数字都有一个运算的对应值。箱号的前 10 位字母和数字的对应值从 0 到 Z 对应数值为 0 到 38,11、22、33不能对 11 取模数,所以要除去第 N 位的箱号对应值再分别乘以 2 的 N-1 次方 (N=1,2,3………..10)。
3)以箱号为 CBHU3202732 的集装箱为例,如下所示:
- 第 1 位代码为 C,它的代码值为:代码的对应值×2^0=13×1=13;
- 第 2 位代码为 B,它的代码的对应值×2^1 =12×2=24;
- 以此类推得到箱号前10位代码的代码值,将前10位的代码值乘积累加后对11取模。
故箱号为 CBHU3202732 的集装箱前 10 位箱号的代码累加值为4061,取 11 的模后为 2,就是这个箱号第 11 位的识别码的数值。
5.2 箱号核验可能结果
核验结果 | 核验结果的返回信息 | 核验详情的返回信息 |
正确 | 通过校验 | 当前箱号{当前箱号}正确,校验位为{当前箱号校验位},通过校验! |
错误 | 验证不通过 | 当前箱号{当前箱号}错误,校验位为{当前箱号校验位},验证不通过! |
错误 | 验证不通过 | 后面7位位必须是数字,箱号错误! |
错误 | 验证不通过 | 前面4位必须是字母,箱号错误! |
错误 | 验证不通过 | 箱号长度一共11位,箱号错误 |
6. 注意事项
1)图片大小建议不要超过 4M(图片最大支持10M),防止网络传输延时过长。
2)插件识别结果对应的集装箱箱号,集装箱类型,集装箱箱重(KGS)与集装箱信息对应关系如下图。其中集装箱所有者为集装箱号前四位结果。
3)如果集装箱箱号识别与核验需求未满足需求欢迎联系开发者,详见【7. 联系方式】。
7. 联系方式
该插件为官方合作的服务商开发,若您在使用过程中有任何疑问,可通过以下方式咨询:
- 公司:中山市一相科技有限公司
- 联系人:吴琪恩
- 联系邮箱:qa@hlszh.com