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

1、BOS开发指南编码规则配置编码规则1.简介 11.1.目的 11.2.适用对象 12.编码规则 12.1.概念定义 12.2.规则定义 23.常用功能 43.1.编码规则模板导出 43.2.编码规则应用范围优先策略 43.3.不允许断号、新增显示、新增显示且不允许断号 53.4.断号维护 73.5.属性参与编码 93.6 对生成编码的控制 103.7多适用条件 103.8 多应用字段 134.案例 171.1.目的对编码规则常见使用问题进行归纳总结。1.2.适用对象本文档适用于：测试人员：熟悉编码规则模块，了解编码规则常用功能。开发工程师：了解业务组件对编码规则集成方案。2.1.概念定义编码：

2、对于业务管理中的基础资料和业务单据， 我们都要用一个唯一的、 有意义的标识符来表示，这个标识符，就是编码。编码规则：对于同一类型的基础资料和业务单据， 我们必须采用统一的编码生成策略进行管理，这个编码生成策略，就是编码规则。22规则定义进入方法：系统平台-编码规则-规则定义编码规则系统流程图主要属性类别：固定值：标识编码业务对象的含义，可以由用户按自己的设计要求，定义固定值的具体内容：通常为英文缩写或中文缩写，例如：借款单-20051115-001LRB-20051115-001属性值：用户可以将当前业务对象的属性参与编码。系统日期：用户可以将当前的时间加入到编码中， 而且我们可以提供各种不同

3、的时间格式供用户选择。系统属性：用户可以将当前系统属性加入到编码中，例如创建时间，修改时间。顺序号：初始值：顺序号起始的数值步长：业务对象递增编码的顺序号之差例如：对于客户编码，初始值为 100,步长为 10，对于第一个客户编码为Coding00000100，那么第二个客户编码为 CodingOOOOOIIO。注意：一般用于编码规则的尾段，目的是为了对应用规则的对象进行计数和相关 排序。校验码：检查编码是否存在分隔符以及编码长度是否符合要求。 分9+1和EAN13两种验证码,主要是用来验证长度，而且检验码必须放在分录的最后一行。3.1.编码规则模板导出功能描述：对初始库中建立好的编码规则模板进

4、行导出目前不支持对编码规则进行导出。3.2.编码规则应用范围优先策略功能描述：应用范围优先策略，可以定义在集团内或多组织中使用同一编码规则。避免重 复定义、易于对编码进行管理。集团优先：集团内任何一个组织设定的编码规则均可以被集团内所有组织应用。多组织优先：指定的组织（可以指派多个）均可以使用当前规则。组织优先：指定的组织均可以使用当前规则。33不允许断号、新增显示、新增显示且不允许断号功能描述：编码规则使用不允许断号或新增显示且不允许断号时。可以在维护 断号功能中对已回收编码进行维护。不允许断号：许多单据的编码是不能有断号，同时也不让随便更改的，这是对编码的一个 很强约束的需求，这个需求直接

5、影响到编码规则的实现方式。应用场景一：新增显示：即单据新增时即产生编码，这样的方式不能用在不允许断号的场景，因为新增 一个单据时就取了号，用户很可能不会保存这么一个单据，那这个取到号就会丢失，就会 产生断号。应用场景二：新增不显示：即单据新增时不取编码，同时这个单据的编码允许断号。这时候就要定义新增不显示的规则。应用场景三：不允许断号：不允许断号的应用场景就是要求断号约束的编码规则，要满足这种需求，必 须在单据保存的时候才去取编码，这样才能保证的不丢失编码，另外，在单据删除时，发 现当前启用的编码规则是不允许断号的时候， 必须显式的调用编码规则的回收接口来回收当前的这个编码，以备下一次取编码的

6、时候使用。 业务集成”新增显示且不允许断号 ”需要设置实体扩展属性 CRAddNoBreak为true。Custom-znwwQ i nAa nirE* op ac 3 4np .Hi j clots1Z滋JW-ii-2 rt AQ| i fask kEAuififiL C14E1IE -o -册电. ”,.#*: ”主 hFraWUJlHgK p Cd4HukOflidvc人田tg如話塾-sji研3 S Khtw 1UMiSQlMti t.i * rw r -1|11 .Ijfiifl 譚-public (CQL&Easelnf d inf QjS+rinj conipsnylD) -thr

7、o-vs C o dine Ku LeEx c ep tiorL, E AS B1 sEuc apt i cm, BOSEKceptianSt r - null:IC o dingRuleManager iC qdlnRul eltanaer = CodingRuleManage rFactory,g：et demote Inst qnce();i (i匚odingRuleManager. isEKist (info, com.panyID)ID)if I iCodingEuleMarLager. isUse Inter mi tJhimbEizfiLrLf , campaiivID) 此处的

8、唧出步骡1)的汀d时一報的，判断审户昱否启鼬鸟支薛功第/启阳了断号強持助能，此时只是读取当前就新编碑，宜止前枪号在保存sysNumber = i.CcdingRul cWIarLaeer 1：亡adNwnhur( inf ocomp any ID ):else没有启用断芳支挿功餾 此时荻取了编码规则*生的编码 sysNiunber 二 iC c dingltiil eManag & r get Number (info.couiipanylD)return FysNumber ：;服务端调用，见框架的 DataBaseControllerBean 的 setNumberFromCodingRu

9、le 方法M j|(*主応编码B /尽删擾畫量终编码的方法*筍jam ctz“细电ras callerx 虫td* orId*throws BOSExcept iony ttirovs EASBizExc:eptian*/protected void setttunibrFrOJiCodingRule(CentctSj DtaBaselnfq caller；, St Tins nrg Id) throws BOSExceni ierb EASBi zExceirt icnICodirRuleHarLassr iCcdinjRuleMarLager = C odirgRul eManae r?

10、act oryif (argld = null | | argil. trimO * LenthO = 0)return:if (iCftdingRiileKarLager. isEKii tcaller, orgld)if tiCodingRuleManager. 1 sUseInt ermitNumber (cal 1 er3 orgld) 數孔 (! iCodingRileMinager. isEserSelect (calleij orgld)calLer set Hunt&r (iCodin岂RuLeMariager” get Number (calletj argTd): el s

11、e|if (iCo dinffRjl eMsna ei. 1 sAddV rew( call er. oral d) 、if .lCodinaREleManager. isModifiabLe caller, orgld)/炎断是否修改了編陽是否改大7：顺序号iCodLTLgRuleWar,ajer. checkHodif iedNumber (caLlerj orIdjcaller. getNumberO, toSt ring ():else/供么都汝选斯增不显丞九诗断僉.业务诗空rumbEi直在此吸置number callttr sttNumaer (iCDdingRul&MarLager

12、.gp+MimhpT 1 *r, nrgTd)Stri ng addNew(Codi ngRulel nfo codi ngRulel nfo)增加一个新的编码 规则对象，参数为待 插入的编码规则对 象String getNumber(IObjectValue bizObject, String org,ParmCodi ngRule customProperty)获取编码Boolea n update(Codi ngRule Info cod in gRule Info)更新一个编码规则 对象，参数为待插入 的编码规则对象Boolean delete(CodingRulelnfo codin

13、gRuleInfo)删除一个编码规则 对象，参数为待插入 的编码规则对象Boolea n deleteByNumber(Stri ng nu mber)删除指定number的 编码规则Codi ngRulel nfo getCodi ngRule(IObiectValue bizObject, Stri ng org)获取编码规则对象Codi ngRule Info getCodi ngRuleByNumber(Stri ng nu mber)获取指定 number的编码规则对象Codi ngRulel nfo getCodi ngRuleByName(Stri ng n ame)获取指定na

14、me的编 码规则对象Stri ng getBatchNumber(IObjectValue bizObject, Codi ngRulel nfocodi ngrule, int count)用满足指定条件的 编码规则对象生成 指定的数量的编码 返回Stri ng getBatchNumberFroml nitialValue(IObjectValue bizObject,String org, String bindingproperty, String customString, int count)从初始值开始批量取一组编码-Stri ng getSimulateNumber(Codi

15、ngRulel nfo codi ngrule info)获取满足指定条件 的编码规则对象生 成的模拟编码String sumLe ngth(Codi ngRule Info cod in grule info)获取满足指定条件 的编码规则对象的 编码长度String readNumber(IObjectValue bizObject, String org, Stringbindingproperty, String customString)读取满足指定条件 的编码规则对象的 生成编码只读boolea n hasCuscomStri ng(IObjectValue bizObject, S

16、tring org)满足指定条件的编 码规则对象中是否 包含有自定义段String getN on breakNumber(IObjectValue bizObject, String org)获取非中断的编码 即不允许断号存在 的编码boolea n isUserSelect(Codi ngRule Info cr)是否用户选择boolea n isExist(Codi ngRulel nfo cr)是否存在指定条件 的编码规则对象RuleStatus getRuleStatus(IObjectValue bizObject, Stri ng org, Stri ng bindin gproperty, ParmCodi ngRule customPro)获取规则的各种状 态boolea n isUsel ntermitNumber(Codi ngRulel nfo cr)指定的编码规则是 否启用断号支持功 能boolean isUseIntermitNumber(IObjectValue bizObject, String org,String bin