编码发生器

功能简介

• 编码发生器是一种用于生成一定长度的随机编码的工具。这些编码通常由数字、字母或符号组成，具有一定的随机性和唯一性，可以用于各种需要标识唯一性的场合，如订单号、会员号、优惠券码等。
• 编码发生器可以根据不同的需求和规则生成不同类型的编码，如固定长度、可变长度、指定字符集、不重复等。同时，编码发生器还可以支持批量生成和自定义前缀、后缀等功能，方便快捷地生成大量的编码。
• 在实际应用中，编码发生器通常与数据库或缓存系统结合使用，用于生成唯一的标识符，以便于管理和查询。

使用流程

1. 进入“生成器配置”页签，创建ID标识器，即建立一个满足业务需求的编码发生器。
2. 创建ID标识器前，需要添加生成器分类和生成器标签，生成器名称及代码系统自动生成。
   • 生成器分类：支持创建一种业务分类，例如生成的编码是文档编码、零件编号或生产批次等。
   • 生成器标签：为生成器建立编码标签，例如上文中的文档，是属于工程文档、测试说明，还是财经报告、法律条文等，添加一个可辨识、搜索的标签。
3. ID标识器任务创建完成后，通过拖拉拽在画布中添加“构件”，并设置构件的运行属性，设置完成后发布生效。
   • 编码生成器由4个部分构件组成，固定字符+对象编码+日期代码+流水序列。其中流水序列是必选部分，没有该部分，无法对外生成编码。
   • 添加构件时，若添加“对象编码”构件，则需要设置业务对象属性。例如部件编码组成包含对内型号、小类代码等属性，此时就需要在“业务对象属性”中单独添加属性，并设置“业务对象类属性代码”（属性值、唯一值）。编码生成时就会包含自定义添加的属性值。
4. 通过接口调用使用，应用于系统或程序中，生成业务编码。

生成器分类

创建生成器分类

1. 在角色桌面首页，单击左上角的，选择“管理中心 > 编码生成器”。
2. 进入“生成器分类”页签，单击“添加”，在弹出的界面中填写如下信息：
   • 生成器分类代码：自定义分类代码，区别于其他分类，具有唯一性。
   • 生成器分类名称：自定义分类名称。
   • 生成器分类描述：关于分类的描述。
   • 备注：添加分类的备注信息。
   • 是否有效：设置当前分类是否有效。

3. 设置完成后，单击“保存”。

生成器分类相关操作

生成器标签

创建成器创建标签

1. 进入“生成器标签”页签。
2. 选择“全部标签”，单击。
   

   添加子节点生成器标签，需先单击父节点右侧的，再在弹出的操作列表中单击“添加”。

3. 在弹出的“创建生成器标签”窗口中，配置以下信息：
   • 标签名称：自定义一个与业务相关的标签名称。
   • 标签代码：自定义标签代码，区别于其他标签，具有唯一性。
   • 标签描述：关于标签的自定义描述。

4. 填写完成后，单击“保存”。

生成器标签相关操作

创建ID标识器

创建任务

1. 进入“生成器配置”页签，单击。
2. 在弹出的界面中设置如下信息：
   • 生成器代码：由系统自动生成，系统唯一值。
   • 生成器名称：生成器的名称，系统默认填充“生成器代码”的取值。
   • 生成器分类：数据来源于生成器分类。
   • 生成器标签：数据来源于生成器标签。

3. 填写完成后，单击“确定”。

添加构件

1. 将需要的“构件”从顶部的构件列表中拖入中间的画布区域。
   图1 添加构件
   
   

   “流水序列”构件为必选，没有流水序列，无法对外生成编码。

2. 单击构件，设置构件属性。

   表3 构件属性

   构件	说明
   ID生成器	生成器代码：系统自动生成，系统唯一值 生成器名称：生成器的名称，系统默认填充“生成器代码”的取值 生成器分类：自定义分类，数据来源于生成器分类 总目标长度：生成器条码总长度 流水分组规则：系统自动生成 格式预览：生成器条码内容 备注：填写自定义备注信息
   固定字符	构件代码：由系统自动生成，系统唯一值 构件名称：默认为固定字符串，支持修改 固定值：编码中自定义的固定值，如ABC、001等 目标长度：固定值的长度 是否属于流水分组标识：是否开启编码生成的预览效果，默认开启 是否作为组装元素输出：是否使用该规则，默认开启
   对象编码	业务属性取值 业务属性：数据来源于业务对象属性 属性初始值：数据来源于“业务对象属性”中的“默认值” 目标长度：根据预览值计算的长度 预览值：“属性初始值”经过数据处理后的最终数值 数据处理逻辑 数据处理方法：支持大小写转换、长度填补、顺序反转、字符串截取、增加前缀、增加后缀。（例如大小写转换，支持设置为“全转大写”，即编码中的小写字母全部转换成大写） 构件显示属性 构件名称：默认为对象编码，支持修改 构件代码：由系统自动生成，系统唯一值 是否属于流水分组标识：是否开启编码生成的预览效果，默认开启 是否作为组装元素输出：是否使用该规则，默认开启
   日期代码	时间代码属性：设置日期样式，选项如下 时间年月日时分秒yyyMddHHmmss 时间年月日yyyyMdd 时间年月yyyyMM 时间时分秒HHmmss 自选定组合 日期格式：设置年份显示样式，显示为2位数字或4位数字，例如24或2024 预览值：选定日期后，自动生成预览值 目标长度：预览值长度 初始值：根据“时间代码属性”生成的值，例如202406 构件代码：由系统自动生成，系统唯一值 构件名称：默认为日期代码，支持修改 是否属于流水分组标识：是否开启编码生成的预览效果，默认开启 是否作为组装元素输出：是否使用该规则，默认开启
   流水序列	流水码类别：当前仅支持数字流水 目标长度：数字流水值的长度，取值范围1-10 最小值：根据目标长度和进制规则确认最小值 最大值：根据目标长度和进制规则确认最大值 增减方式：目前仅支持增量 间隔量(十进制)：默认为1 进制规则：十进制、可配置字符进制，其中34进制字符集不勾选O和I 周期重置模式：可选值从不、每日、每周、每月、每年 预览值：最小值经过进制转换后的最终数值 构件代码：由系统自动生成，系统唯一值 构件名称：默认为流水序号，支持修改 是否作为组装元素输出：是否使用该规则，默认开启 说明： 流水序列递增规则： 如果纯数字，会从最小值递增到最大值，例如：最小值是1最大值是9999，则初始的第一个流水序列码是0001，然后往上递增加1，变为0002，0003。 如果是数字加字母形式，会从最小值递增到最大值，例如，最小值是1，最大值是ZZZZ，在同一个位数上，先是数字递增，然后再到字母递增。则初始的第一个流水序列码是0001，然后往上递增加1，变为0002，0003，到了0009的时候再递增是000A，000B，000C，到了000Z后再递增是0010。

3. 设置完成后单击“操作”列表中的“发布”。

   操作过程中您也可以进行重置、还原、复制等操作。

业务对象属性

添加编码构件后，需要创建业务对象，并设置业务对象属性。业务对象添加后可应用于编码当中，作为编码的组成部分。

添加业务对象

1. 进入“业务对象属性”页签。
2. 单击“添加”。
3. 在弹出的“添加业务对象”窗口中，设置如下信息：
   • 应用名称：业务对象的应用名称。
   • 应用类名称：业务对象的应用类名称。
   • 应用类代码：业务对象的应用类代码，默认为“应用类名称”取值。
   • 应用类描述：业务对象的应用类描述。
   • 参考对象表：业务对象参考对象表。
   • 参考的数据源名称：业务对象参考的数据源名称。

4. 设置完成后，单击“保存”。

添加业务对象属性

1. 选择已添加的业务对象，单击“操作”列中的“添加”。
2. 在弹出的“添加业务对象属性”窗口中，设置如下信息：
   • 业务对象：数据来源于业务对象。
   • 业务对象类属性代码：业务对象属性的代码，系统唯一值。
   • 业务对象类属性名称：业务对象属性的名称。
   • 数据类型：业务对象属性的数据类型。
   • 取值范围：varchar（字符）；number（数字）；date（日期）。
   • 默认值：业务对象属性的默认值。
   • 业务对象类属性描述：业务对象属性的描述。
   • 备注：业务对象属性的备注。

3. 设置完成后，单击“保存”。

使用编码发生器

通过调用编码生成器API接口，生成编码。

图2 请求示例

图3 响应示例