学习目标

1. 了解编码规则以及编码规则的主要配置属性；

2. 学会配置编码规则。

内容简介

本学习单元主要介绍编码规则以及相关配置属性，并通过实操演示编码规则的配置过程。

编码规则定义

编码：对于业务系统中的基础资料和业务单据的每一条记录数据，我们都要用一个唯一的、有意义的标识符来表示，这个标识符，就是编码。

编码规则：对于同一类型的基础资料和业务单据的记录数据，我们需要采用统一的编码生成策略进行管理，这个编码生成策略，就是编码规则。

编码规则入口

【系统云】-【配置工具】-【业务规则】 -【编码规则】

常见问题：编码规则列表左树出现新增的单据，需满足三个条件：1.单据的业务控制里启用【显示编码规则】；2.单据所在的应用需启用；3.单据不能是模板。

编码规则属性介绍

新增显示：新增界面就会显示出编码。

允许修改：编码字段允许人工手动修改。

默认区间分隔符：编码分段之间的分隔符

编码分段属性：

【常量】：用户自定义设置值，可以是数字、字段、特殊字符以及汉字等。

【系统日期】：当前系统的日期，可设置日期格式，例如YYYY,YYYY-MM-DD，YYYYMMDD等格式。

【业务对象日期】：来源于业务对象所有和时间有关的字段，也可以设置格式。

【业务对象字段】：来源于业务对象的字段，使用模式有补位和截断两种模式。补位：根据长度自动补齐，分为左侧补位和右侧补位。举例，编码分段设置长度6位，属性值实际长度为3位，补位符号%，当前属性值为AAA。左侧补位后为 %%% AAA，右侧补位后为AAA %%% 。截取：根据长度截取部分属性值，分为左侧截取和右侧截取。如编码规则长度设置3位，属性值长度位6位，为AAABBB。左侧截取后为BBB，右侧截取后为AAA。

【流水号】：顺序号，可以设置长度、起始值。流水号还有断号补偿开关，如果开启该属性，流水号是不允许断号的，当删除单据时会回收该断号，下一次新增的单据会优先使用断号。

【校验码】：目前固定为EAN13校验码，编码格式固定。编码分两部分，第一部分为12位数字编码，第2部分为校验码。校验方法：校验符的计算方法非常简单，将12个数字从左起将所有的奇数位相加得出一个数a，将所有的偶数位相加得出一个数b，然后将数b乘以3再与a相加得到数c，用10减去数c的个位数，如果结果不为10则检验符为结果本身，如果为10则检验符为0。

【随机码】：目前系统默认支持8位随机码。

流水号依据：需要在流水号前的分段设置，作为编码分组的依据，这个依据发生改变时，流水号要重新从1开始取数。

适用条件 :当一个单据有多个编码规则时，可以通过适用条件控制编码规则生效范围，在获取单据编码规则时会过滤不符合条件的规则。

适用条件 :当一个单据有多个编码规则时，可以通过适用条件控制编码规则生效范围，在获取单据编码规则时会过滤不符合条件的规则。

受控组织 :当不同的组织需要使用不同的编码规则时，可以通过受控组织控制编码规则在哪些组织下才生效。如果设置了受控组织，单据有主业务组织的情况下（在开发平台建单据选择带组织模板时，单据会自带主业务组织），系统获取编码规则会校验主业务组织是否在受控组织内，在才会用这个编码规则生成编码，如果单据没有主业务组织，系统会校验用户当前登录的组织是不是在受控组织内，如果没有设置受控组织，编码规则在任何组织下都可用。

如何配置一个编码规则

本视频通过编码规则实操案例演示编码规则的配置过程，以及流水号依据、受控组织、适用条件等属性的应用。

主讲人：袁安

编码规则工具类

编码规则配置完成后，新增单据或保存提交单据就能自动生成编码，是因为单据继承了标准的模板，而模板的界面插件注册了CodeRulePlugin或者保存提交的操作绑定了服务插件CodeRuleOp,这两个插件实现了获取满足条件的编码规则生成编码赋值给编码字段这个过程。那对于后台生成的业务对象，不会触发这两个插件，如果该业务对象也要使用编码规则，就需要用到编码规则工具类CodeRuleServiceHelper的相关接口。首先调用CodeRuleServiceHelper的getCodeRule获取实体满足条件的编码规则；

然后调用CodeRuleServiceHelper的getNumber方法生成编码，并赋值给单据编号字段；如果流水号勾选了断号补偿，在后台删除单据时需要调CodeRuleServiceHelper的recycleNumber去回收编码。

课后练习

分别给办公用品登记单、办公用品库存单、办公用品领用申请单三个单据配置新增显示且不断号的编码规则，编码示例：XX-YYYYMMDD-0001。

编码规则

恭喜您！