BOS开发指南_编码规则配置.docVIP

编码规则 1. 简介 3 1.1. 目的 3 1.2. 适用对象 3 2. 编码规则 3 2.1. 概念定义 3 2.2. 规则定义 4 3. 常用功能 5 3.1. 编码规则模板导出 5 3.2. 编码规则应用范围优先策略 6 3.3. 不允许断号、新增显示、新增显示且不允许断号 6 3.4. 断号维护 8 3.5. 属性参与编码 10 3.6 对生成编码的控制 11 3.7 多适用条件 11 3.8 多应用字段 14 4. 案例 18 简介 目的 对编码规则常见使用问题进行归纳总结。 适用对象 本文档适用于： 测试人员：熟悉编码规则模块，了解编码规则常用功能。 开发工程师：了解业务组件对编码规则集成方案。 编码规则 概念定义 编码：对于业务管理中的基础资料和业务单据，我们都要用一个唯一的、有意义的标识符来表示，这个标识符，就是编码。 编码规则：对于同一类型的基础资料和业务单据，我们必须采用统一的编码生成策略进行管理，这个编码生成策略，就是编码规则。 规则定义 进入方法：系统平台-编码规则-规则定义 编码规则系统流程图 主要属性类别： 固定值： 标识编码业务对象的含义，可以由用户按自己的设计要求，定义固定值的具体内容： 通常为英文缩写或中文缩写， 例如：借款单001 LRB001 属性值： 用户可以将当前业务对象的属性参与编码。 系统日期： 用户可以将当前的时间加入到编码中，而且我们可以提供各种不同的时间格式供用户选择。 系统属性： 用户可以将当前系统属性加入到编码中，例如创建时间，修改时间。 顺序号： 初始值： 顺序号起始的数值 步长： 业务对象递增编码的顺序号之差 例如：对于客户编码，初始值为100，步长为10，对于第一个客户编码为Codin那么第二个客户编码为Codin 注意：一般用于编码规则的尾段，目的是为了对应用规则的对象进行计数和相关排序。 校验码： 检查编码是否存在分隔符以及编码长度是否符合要求。分9+1和EAN13两种验证码，主要是用来验证长度，而且检验码必须放在分录的最后一行。 常用功能 编码规则模板导出 功能描述：对初始库中建立好的编码规则模板进行导出 目前不支持对编码规则进行导出。 编码规则应用范围优先策略 功能描述：应用范围优先策略，可以定义在集团内或多组织中使用同一编码规则。避免重复定义、易于对编码进行管理。 集团优先：集团内任何一个组织设定的编码规则均可以被集团内所有组织应用。 多组织优先：指定的组织(可以指派多个)均可以使用当前规则。 组织优先：指定的组织均可以使用当前规则。 不允许断号、新增显示、新增显示且不允许断号 功能描述：编码规则使用‘不允许断号’或‘新增显示且不允许断号’时。可以在‘维护断号’功能中对已回收编码进行维护。 不允许断号：许多单据的编码是不能有断号，同时也不让随便更改的，这是对编码的一个很强约束的需求，这个需求直接影响到编码规则的实现方式。 应用场景一： 新增显示：即单据新增时即产生编码，这样的方式不能用在不允许断号的场景，因为新增一个单据时就取了号，用户很可能不会保存这么一个单据，那这个取到号就会丢失，就会产生断号。 应用场景二： 新增不显示：即单据新增时不取编码，同时这个单据的编码允许断号。这时候就要定义新增不显示的规则。 应用场景三： 不允许断号：不允许断号的应用场景就是要求断号约束的编码规则，要满足这种需求，必须在单据保存的时候才去取编码，这样才能保证的不丢失编码，另外，在单据删除时，发现当前启用的编码规则是不允许断号的时候，必须显式的调用编码规则的回收接口来回收当前的这个编码，以备下一次取编码的时候使用。 (1) 业务集成 ”新增显示且不允许断号” 需要设置实体扩展属性CRAddNoBreak为true。 (2)通过ICodingRuleManager接口中getRuleStatus方法取得RuleStatus，判断是否为”新增显示且不允许断号” ruleStatus.isAddNoBreak()。 (3)单据上通过readNumber取得临时编码显示。 详见第5章isUseIntermitNumber isUseIntermitNumber isAddView方法 断号维护 功能描述：编码规则使用‘不允许断号’或‘新增显示且不允许断号’时。可以在‘维护断号’功能中对已回收编码进行维护。 属性参与编码 功能描述：如果客户要求根据某个属性来影响单据的编码，这个时候需要将这个属性添加到编码规则的定义中，并做一些相关的设置来实现各种控