集装箱箱号识别插件

1. 简介

1.1 插件简介

集装箱箱号识别插件,用于识别和核验集装箱箱号。用户通过拍照或者上传一张带集装箱箱号信息的照片,即可返回图片中的集装箱箱号、集装箱归属、箱号、箱重等信息,同时对信息进行校验并返回校验结果及校验详情。

1.2 应用场景

如在货运管理系统中,可以自动识别集装箱箱号信息并校验,确保快速且准确地录入到业务系统中,有效解决人工抄录过程中抄错、抄漏等问题,减少人工录入工作量,降低出错概率和企业人力成本。

1.3 预期效果

开启集装箱箱号识别插件,拍照上传或者直接上传一张待识别的带集装箱信息照片后,即可返回读数结果,并自动回填至对应字段中。

1.4 使用说明

集装箱箱号识别插件为付费插件,每次调用插件进行集装箱箱号识别消耗 0.28 个 云币在使用插件时自动扣除云币数量,当云币余额可支付的识别次数为 0 时,将无法使用集装箱箱号识别与核验插件。

2. 插件安装及启用

2.1 安装插件

1)直接安装

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

文档内容是否对您有帮助?
有帮助
没帮助没帮助
如需获取即时帮助,请联系技术支持
咨询
扫码领取100+零代码资料简道云官方微信号400-111-0890
图标在线咨询
立即体验