编码规则使用说明

栏目:云苍穹知识作者:金蝶来源:金蝶云社区发布:2024-09-23浏览:1

编码规则使用说明

1 简介

1.1 功能介绍

主要功能点如下:

1、  编码规则

设置业务对象的编码规则,作为编码的生成策略。

2、  最大号维护

维护不同编码依据的最大流水号。

3、  断号维护

维护不同编码依据出现断号情况的流水号。

4、  编码规则升级

编码规则升级可以优化编码性能, 为编码并发请求较高的场景提供更及时的自动编码体验。

1.2 应用场景

设置业务对象的单据编号生成规则,运行时单据新增或保存时,可根据既定的规则自动生成单据编码,编码经过唯一性校验后,展示在单据编号字段上。

1.3 系统路径

5.0及以下版本:【系统服务云】→【配置工具】→【编码规则配置】 

6.0及以上版本:【基础服务云】→【公共设置】→【编码规则配置】 

1.4 功能说明

 1.4.1    编码规则

在设计器中自定义一个单据业务对象,对其设置编码规则。

操作步骤如下:

1、  先进入开发平台,打开需要配置编码规则的业务对象(单据或基础资料),在表单属性中点击【业务控制】,在弹出的界面中打开【显示编码规则配置】开关,打开开关后才能在编码规则设置中找到该业务对象。

2、  

5.0及以下版本依次打开【系统服务云】→【配置工具】→【编码规则配置】 或6.0及以上版本依次打开【基础服务云】→【公共设置】→【编码规则配置】 ,选择自定义单据,点击【新增】按钮:

3、  进入编码规则新增界面,设置编码规则属性后,保存生成一条编码规则。

新增界面基本信息字段说明如下表:

元素名称

元素类型

功能说明

业务对象

文本

默认值为选择的业务对象,不可编辑

规则编码

文本

默认值自动生成,可修改,不可重复

规则名称

文本

默认值为当前对象名称,可修改

默认段间

分隔符

单选

下拉列表

设置不同编码段之间的默认分隔符,默认为空,可选择:空、-、@、#、$、%、^、&、*、[、]

新增显示

开关

控制新增界面展示按此规则生成的编码

允许修改

开关

控制新增界面单据编号字段是否允许修改

修改时重新编码

开关

控制当前编码规则在业务对象修改时,按修改后的编码段取值重新按规则生成编码。


工具栏按钮说明如下表:

元素名称

元素类型

功能说明

受控组织

开关

控制编码规则是否收组织管控,启用后,工具栏展示受控组织按钮,可设置当前编码规则的适用组织,支持在组织列表中选择多个组织作为使用组织,设置适用组织后,其他非适用组织则不能使用当前编码规则。

启动条件开关控制当前编码规则的启动条件,用于控制编码规则按条件使用,启动条件的功能涵盖适用条件,当配置启动条件时,适用条件将失效。

适用条件

开关

控制当前编码规则的适用条件,用于控制多个编码规则按条件使用,可根据单据的主业务组织及其下级组织控制编码规则的使用。


新增界面编码设置信息字段说明如下表:

元素名称

元素类型

功能说明

编码段-

类型

单选

下拉列表

选择编码段的字段类型,可选随机码、常量、系统日期、业务对象日期、业务对象字段,选择不同类型,可设置不同的参数,规则如下:

常量,;

随机码,;

系统日期,;

业务对象日期,编码段取系统某人日期字段的值,可设置日期;显示格式,可选择业务对象上的日期型字段作为编码来源;

业务对象字段,

 

新增

按钮

新增一个编码段

删除

按钮

删除选中的编码段

编码示例

文本

展示编码生成示例

编码段-

类型

单选

下拉列表

选择编码段的字段类型,可选随机码、常量、系统日期、业务对象日期、业务对象字段、流水号,选择不同类型,可设置不同的参数

常量

文本

编码段为常量值,可输入固定值作为设置值

随机码

文本

编码段为随机码,固定为8位长度

系统日期

日期

编码段取系统当前日期,可设置日期格式

业务对象

日期

日期

编码段取系统某人日期字段的值,可设置日期;显示格式,可选择业务对象上的日期型字段作为编码来源

业务对象

字段

属性组合

编码段可取业务对象上的字段值,通过使用模式控制,取字段值或者截取部分字段值

使用模式

下拉列表

选择完全取值,编码段取编码来源的字段值;

选择属性截断,截取编码来源字段值的部分作为编码段,可设置的参数如下:  

长度:默认值为8,可修改

补位符号:输入补位符,如果来源字段值长度不足设定长度时,用补位符补足长度

补位:可选择在来源字段值的右侧或左侧填充补位符

截去:可选去除来源字段值的右侧部分或者左侧部分

流水号

属性组合

根据流水号依据自动生成流水号,可设置流水号属性:

长度:默认值为8,可修改;

起始值:设置流水号开始自动生成的初始值;

步长:设置流水号自动生成的间隔值;

断号补偿:出现断号时,是否允许自动补号,新增单据生成编码时会先去断号表取数据,如果断号表有数据,则取断号表的数据最为编码; 如果断号表没数据,则会取最大号表中该依据对应的最大流水号+1作为编码;

注,流水号功能需在高级设置中开启,只允许设置一个流水号编码段,流水号与随机码不能同时存在。

流水号依据

下拉列表

启用流水号之后,编码段中的系统日期、业务对象日期、业务对象字段增加流水号依据属性,可设置为:

非依据:默认值,不作为流水号生成和流水的依据

设为依据:作为流水号生成和流水的依据,取值发生改变,从起始值重新开始生成流水号。

设为依据但不显示:作为流水号生成和流水的依据,但在编码中不展示该编码段。

段间分隔符

下拉列表

设置当前编码段与上一编码段之间的分隔符,默认为空,可选择:空、-、@、#、$、%、^、&、*、[、],设置默认分隔符后,此处默认值取默认分隔符的设定值,允许修改为其他分隔符

校验码

属性组合

设置编码段为校验码,默认值为EAN13校验码。校验码需在高级设置中启用,且只能在最后一个编码段使用。


新增界面点击高级设置,打开编码规则高级设置界面,可设置如下参数:

元素名称

元素类型

功能说明

显示适用条件工具栏项

开关

控制当前编码规则的适用条件,启用后,工具栏展示适用条件按钮,可设置当前编码规则的适用条件,用于控制多个编码规则按条件使用。

校验码

开关

控制编码段是否启用校验码,启用后,编码段可选择校验码,目前校验码只支持EAN13校验码,常应用于生成条形码。

 

 1.4.2  最大号维护

支持对最大流水号进行维护。可以新增、修改编码规则不同流水号依据的最大流水号。

5.0及以下版本依次打开【配置工具】-【编码规则配置列表】-【最大号表】或6.0版本依次打开【公共设置】-【编码规则配置列表】-【最大号表】路径进入最大号维护界面,选中一个编码规则,点击进入与该编码规则相关的最大号表界面。

选择列表中的最大流水号,点击删除,可删除该流水号,点击一个流水号,打开修改界面。



最大号维护通常在特殊情况下使用,使用场景有两个:

1)用户想要基于特定流水号依据重新编号;

2)由于系统原因一直无法获取新的编码,导致死循环;


1.4.3    断号维护

断号维护功能用于新增、删除、修改编码规则不同流水号依据出现的断号。在特殊场景下使用,如数据删除导致出现流水号断号时,维护丢失的断号信息,编码规则启用断号补偿后,会按断号维护中已维护的自动补号,生成已丢失的单据编号,保证单据编码在流水号依据下的连续性。

5.0及以下版本依次打开【配置工具】-【编码规则配置列表】-【断号表】或6.0版本依次打开【公共设置】-【编码规则配置列表】-【断号表】路径进入断号维护界面,进入断号维护界面,选中一个编码规则,点击进入与该编码规则相关的断号表界面;

点击新增按钮,打开断号新增界面,可新增编码规则某个流水号依据的断号。



 1.5   关键业务场景

1.5.1    新增编码规则示例

设计器中分录实体上配置引出分录操作,运行时,即可引出当前单据体上所有数据,所见即所得。

业务场景:

 新建单据需要配置编码规则,由系统自动生成编码;

配置编码规则使用案例如下:

1、先进入开发平台,找到需要配置编码规则的单据,接下来的操作如图所示;

2、

5.0及以下版本依次打开【系统服务云】→【配置工具】→【编码规则配置】 或6.0及以上版本依次打开【基础服务云】→【公共设置】→【编码规则配置】 ,选择自定义单据,点击【新增】按钮:


3、设置编码规则,案例:常量+流水号(Q-00000001)


4、编码规则配置完成,可以到单据检验一下效果。

 

1.5.2    按组织设置编码规则

业务场景:

同一个业务对象在不同组织下应用不同的编码规则。

配置编码规则使用案例如下:

1、在编码规则列表或者编辑页面,点击【受控组织】按钮

 2、打开【受控组织】弹窗,点击新增行,选择需要设置的业务单元:

  3、保存编码规则并启用。只有单据的主业务组织(单据若无主业务组织则取登录组织判断)与编码规则中的适用组织相符才有效。

 

 

1.5.3    按条件设置编码规则

如果想要实现同一业务对象在不同条件下应用不同的编码规则,可设置编码规则的启动条件或者适用条件,启动条件涵盖适用条件的功能,且配置操作更为简单,建议配置启动条件。


1.5.3.1按启动条件设置编码规则

在编码规则详情页,在禁用的编码规则,点击左上角的启动条件按钮,即能配置编码规则的启动条件,点击“添加条件”按钮配置想要的条件即可。


1.5.3.2 按适用条件设置编码规则

配置编码规则使用案例如下:

1、适用条件的适用属性及属性值配置:

依次打开【开发服务云】-【开发平台】-【基础服务云】-【企业建模】-【编码规则】。扩展配置表单:

适用条件属性(bos_coderuleappcondpro)

适用条件属性值(bos_crappcondprovalue)

步骤:

1)  找到“企业建模-编码规则”下的“适用条件属性” 和“适用条件属性值” 两个页面。

 

2)  先预览适用条件属性页面,选择业务对象并填写要控制的属性;

3)  再预览适用条件属性值页面,选择刚保存的适用条件属性,并填写需要控制的属性值。



 

1、编码规则编辑页面,点击【适用条件】按钮

 

2、打开适用条件弹窗,选择好适用属性和属性值。我们以客户为例,下图选择的业务对象为测试单据,适用属性为“测试适用条件”,属性值为“2”。

 3、保存后启用编码规则。当“测试适用条件”为2时,单据依据此编码规则生成编码。

编码规则使用说明

1 简介1.1 功能介绍主要功能点如下:1、 编码规则设置业务对象的编码规则,作为编码的生成策略。2、 最大号维护维护不同编码依据的最...
点击下载文档
确认删除?
回到顶部
客服QQ
  • 客服QQ点击这里给我发消息