ID生成器定义

前提条件

已登录MBM Space，且拥有该菜单栏目的操作权限。

约束与限制

• “是否有效”为“否”的数据，对外提供的查询接口将被过滤，其他功能模块也无法引用。
• 生成器配置在引用生成器分类数据时，引用的是“发布”状态且“是否有效”为“是”的记录。
• 非“发布”状态的ID生成器数据其他功能模块无法引用。
• 如果某生成器分类下关联了ID生成器，则该生成器分类不能被删除。
• 仅最小叶子节点的生成器标签可添加ID生成器与生成器标签的捆绑关系。
• 如果某业务对象下关联了业务对象属性，则该业务对象不能被删除。
• 需要由用户自行配置的“ID生成器定义”的基础数据参考表1、表2和表3。

  表1 ID生成器定义基础数据（生成器配置）

  ID生成器	说明
  车间编号	构件：固定字符 + 流水序列 固定字符：“固定值”为“SF” 流水序列：“目标长度”为“3”
  线体编号	构件： 对象编码 + 流水序列 对象编码：“业务属性”为“线体种类”（数据来源于“业务对象码”） 流水序列：“目标长度”为“3”
  工位编号	构件： 对象编码 + 固定字符 + 流水序列 对象编码：“业务属性”为“工序编码”（数据来源于“业务对象码”） 固定字符：“固定值”为“-” 流水序列：“目标长度”为“3”
  LOT条码	构件：固定字符 + 对象编码 + 流水序列 固定字符：“固定值”为“LOT” 对象编码：“业务属性”为“工单号”（数据来源于“业务对象码”） 流水序列：“目标长度”为“6”
  工单号 说明： 如果配置了正常工单、返工工单等与工单类型对应的工单号生成器，则无需配置该生成器。	构件：固定字符 + 日期代码 + 流水序列 固定字符：“固定值”为“WOP” 日期代码：“时间代码属性”为“时间年月日yyyyMMdd” 流水序列：“目标长度”为“6”
  正常工单ID	构件：固定字符 + 日期代码 + 流水序列 固定字符：“固定值”为“WOP” 日期代码：“时间代码属性”为“时间年月日yyyyMMdd” 流水序列：“目标长度”为“6”
  返工工单ID	构件：固定字符 + 日期代码 + 流水序列 固定字符：“固定值”为“RWO” 日期代码：“时间代码属性”为“时间年月日yyyyMMdd” 流水序列：“目标长度”为“6”
  SN条码	构件：固定字符 + 日期代码 + 流水序列 固定字符：“固定值”为“SN” 日期代码：“时间代码属性”为“时间年月yyyyMM” 流水序列：“目标长度”为“10”
  箱子条码	构件：固定字符 + 对象编码 + 日期代码 + 流水序列 固定字符：“固定值”为“LPN” 对象编码：“业务属性”为“产品编码”（数据来源于“业务对象码”） 日期代码：“时间代码属性”为“时间年月yyyyMM” 流水序列：“目标长度”为“4”

  表2 ID生成器定义基础数据（业务对象码-对象）

  应用名称	应用类名称	应用类代码	应用类描述
  主数据	MDM	MDM	条码信息
  质检条件	mbm_qc_condition	mbm_qc_condition	质检规则定义的变量

  表3 ID生成器定义基础数据（业务对象码-对象属性）

  业务对象	业务对象类属性代码	业务对象类属性名称	数据类型	默认值	业务对象类属性描述
  MDM	lineCatalog	线体种类	varchar	001	线体编号的线体种类对象
  MDM	workstepCode	工序编码	varchar	Line	工位编号的工序编码对象
  MDM	wo_order	工单号	varchar	WOP240101000001	LOT条码的工单号对象
  MDM	part_no	产品编码	varchar	Product12345	箱子条码的产品编码对象
  mbm_qc_condition	weight	重量	number	50	重量变量
  mbm_qc_condition	volume	体积	number	30	体积变量

添加生成器分类

1. 在顶部导航栏中，选择“制造数据模型管理 > 建模工具 > ID生成器定义”，进入“ID生成器定义”页面。
2. 选择“生成器分类”页签。
3. 单击“添加”。
4. 在弹出的“添加生成器分类”窗口中，配置表4信息。

   表4 添加生成器分类参数表

   参数	说明
   生成器分类代码	生成器分类代码，系统唯一值。 取值长度不超过30个字符。
   生成器分类名称	生成器分类的名称。 取值长度不超过60个字符。
   生成器分类描述	生成器分类的描述。 取值长度不超过1000个字符。
   备注	生成器分类的备注。 取值长度不超过1000个字符。
   是否有效	标识是否有效。 默认为是。有效的生成器分类数据才能被其他功能模块引用。

5. 单击“保存”，生成器分类添加完成。

生成器分类相关操作

生成器分类添加完成后，您还可以进行如表5所示的操作。

添加生成器标签

1. 在顶部导航栏中，选择“制造数据模型管理 > 建模工具 > ID生成器定义”，进入“ID生成器定义”页面。
2. 选择“生成器标签”页签。
3. 单击左侧“全部标签”右侧的。

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

4. 在弹出的“创建生成器标签”窗口中，配置表6信息。

   表6 创建生成器标签参数表

   参数	说明
   标签名称	标签的名称。 取值长度不超过50个字符，且只能为中文、字母或数字。
   标签代码	标签代码，系统唯一值。 取值长度不超过30个字符。
   标签描述	标签的描述。 取值长度不超过500个字符。

5. 单击“保存”，生成器标签添加完成。

生成器标签相关操作

生成器标签添加完成后，您还可以进行如表7所示的操作。

添加ID生成器并发布

1. 在顶部导航栏中，选择“制造数据模型管理 > 建模工具 > ID生成器定义”，进入“ID生成器定义”页面。
2. 选择“生成器配置”页签。
3. 单击。
4. 在弹出的“创建ID标识器”窗口中，填写表8信息。

   表8 创建ID标识器参数表

   参数	说明
   生成器代码	ID生成器代码，系统自动生成取值。
   生成器名称	ID生成器的名称，系统默认填充“生成器代码”取值。
   生成器分类	ID生成器的分类，数据来源于“生成器分类”。
   生成器标签	ID生成器的标签，数据来源于“生成器标签”。

5. 单击“确定”。
6. 将需要配置的构件从顶部的构件列表拖入中间的画布区域。如图1所示。
   界面操作按钮说明如表9所示。

   图1 自定义ID规则
   

   表9 生成器配置操作按钮说明

   按钮	说明
   	新建生成器。
   	重置会清空画布上的构件数据。
   	编辑生成器，单击“还原”可恢复编辑前的生成器的构件数据。
   	单击“复制”，自动生成生成器副本，内容相同。
   	编辑后的生成器的构件信息保存成功。
   	可直接将生成器配置数据生成二维码，以及提供打印服务。
   	编辑后的生成器的构件信息发布成功，生成器的状态变为“发布”。 “发布”状态的生成器不支持编辑操作。

7. 选中画布中的某个构件，在弹出的“节点信息维护”窗口中编辑构件信息。

   然后，逐一完成画布中各构件的配置信息。

   节点维护界面对应参数说明如表10~表15所示。

   随机码和自定义函数目前暂不支持，雪花ID只能单独使用。

   表10 生成器参数表

   参数	说明
   生成器代码	生成器代码，系统自动生成，系统唯一值。 取值长度不超过50个字符，且只能为字母和数字。
   生成器名称	生成器名称，系统默认填充生成器代码取值。 取值长度不超过60个字符。
   生成器分类	选择生成器分类，数据来源于“生成器分类”。
   总目标长度	生成器条码总长度。 系统自动根据生成器中各构建的目标长度计算总目标长度。
   流水分组规则	流水分组规则，系统自动生成。
   格式预览	生成器条码内容，系统自动生成。
   备注	生成器的备注。 取值长度不超过500个字符串。
   图片	支持上传图片，图片内嵌至二维码。

   表11 生成器中固定字符参数表

   参数	说明
   构件代码	构件代码，系统自动生成，系统唯一值。
   构件名称	构件名称，默认为固定字符串。 取值长度不超过60个字符。
   固定值	自定义固定值。 取值长度不超过60个字符。
   目标长度	目标长度，系统自动根据固定值计算长度。
   是否属于流水分组标识	是否属于流水分组标识。 默认为是。
   是否作为组装元素输出	标识是否作为组装元素输出。 默认为是。

   表12 生成器中对象编码参数表

   参数	说明
   业务属性取值
   业务属性	选择业务属性，数据来源于“业务对象码”。
   属性初始值	选择“业务属性”后系统自动填充，数据来源于“业务对象码”，业务对象属性中的默认值。 取值长度不超过60个字符，且只能为字母、数字和特殊符号_+@&():-
   目标长度	目标长度，根据预览值计算长度。
   预览值	预览值，属性初始值经过数据处理后的最终数值。
   数据处理逻辑	单击“添加”，可配置数据格式处理逻辑。 数据处理方法：支持大小写转换、长度填补、顺序反转、字符串截取、增加前缀、增加后缀。
   构件显示属性
   构件名称	构件名称，默认为对象编码。 取值长度不超过60个字符。
   构件代码	构件代码，系统自动生成，系统唯一值。
   是否属于流水分组标识	是否属于流水分组标识。 默认为是。
   是否作为组装元素输出	标识是否作为组装元素输出。 默认为是。

   表13 生成器中日期代码参数表

   参数	说明
   时间代码属性	时间代码，取值包括： 时间年月日时分秒yyyMddHHmmss 时间年月日yyyyMdd 时间年月yyyyMM 时间时分秒HHmmss 自选定组合
   数据处理逻辑	单击“添加”，可配置日期映射逻辑。 数据处理方法：日期时间映射，支持年代码、月代码、周代码、日代码。
   预览值	预览值，由初始值经过数据处理后的最终数值。
   目标长度	目标长度，根据预览值计算长度。
   初始值	初始值，勾选的时间代码属性的内容。
   构件代码	构件代码，系统自动生成，系统唯一值。
   构件名称	构件名称，默认为日期代码。 取值长度不超过60个字符。
   是否属于流水分组标识	是否属于流水分组标识。 默认为否。
   是否作为组装元素输出	标识是否作为组装元素输出。 默认为是。

   表14 生成器中流水序列参数表

   参数	说明
   流水码类别	流水码类别。 默认为数字流水。目前仅支持数字流水。
   目标长度	目标长度，定义预览值的长度。
   最小值	根据目标长度和进制规则确认最小值。
   最大值	根据目标长度和进制规则确认最大值。
   增减方式	增减方式。 默认为增量。目前支持增量、减量。
   间隔量(十进制)	间隔量（十进制）。 默认为1。取值为正整数，且不能大于（最大值-最小值）。
   进制规则	进制规则，数据来源于“参数配置”。 默认为十进制。当前系统预置的取值包括十进制、可配置字符进制。 十进制 可配置字符进制
   10进制字符集~36进制字符集	“进制规则”选择“可配置字符进制”时，即可配置36个字符的字符值。 默认34进制字符集且不勾选O和I。
   周期重置模式	周期重置模式。 默认为从不。目前支持从不、每日、每周、每月、每年。
   预览值	预览值，最小值经过进制转换后的最终数值。
   构件代码	构件代码，系统自动生成，系统唯一值。
   构件名称	构件名称，默认为流水序号。 取值长度不超过60个字符。
   是否作为组装元素输出	标识是否作为组装元素输出。 默认为是。

   表15 生成器中雪花ID参数表

   参数	说明
   构件代码	构件代码，系统自动生成，系统唯一值。
   构件名称	构件名称，默认为雪花ID。 取值长度不超过60个字符。
   雪花ID	雪花ID，系统自动生成，有着系统唯一和有序递增的特点。
   目标长度	目标长度，默认为19，不支持修改。
   是否作为组装元素输出	标识是否作为组装元素输出。 默认为是。

8. （可选）在顶部的“操作”栏当中单击“保存”。

   如果鼠标移动到“保存”按钮位置系统弹出提示信息“已自动保存，无需再次操作”，则可跳过该步骤。

9. 在顶部的“操作”栏当中单击“发布”。

   “发布”状态的ID生成器才能被其他功能模块引用。

生成器配置相关操作

ID生成器添加完成后，您还可以进行如表16所示的操作。

添加业务对象

1. 在顶部导航栏中，选择“制造数据模型管理 > 建模工具 > ID生成器定义”，进入“ID生成器定义”页面。
2. 选择“业务对象码”页签。
3. 单击“添加”。
4. 在弹出的“添加业务对象”窗口中，配置表17信息。

   表17 添加业务对象参数表

   参数	说明
   应用名称	业务对象的应用名称。 取值长度不超过60个字符。
   应用类名称	业务对象的应用类名称。 取值长度不超过30个字符。
   应用类代码	业务对象的应用类代码。 默认为“应用类名称”取值，不支持修改。
   应用类描述	业务对象的应用类描述。 取值长度不超过1000个字符。
   参考对象表	业务对象参考对象表。 取值长度不超过30个字符。
   参考的数据源名称	业务对象参考的数据源名称。 取值长度不超过30个字符。

5. 单击“保存”，业务对象添加完成。

添加业务对象属性

1. 在顶部导航栏中，选择“制造数据模型管理 > 建模工具 > ID生成器定义”，进入“ID生成器定义”页面。
2. 选择“业务对象码”页签。
3. 选中业务对象记录后，单击“操作”列的“添加”。
4. 在弹出的“添加业务对象属性”窗口中，配置表18信息。

   表18 添加业务对象属性参数表

   参数	说明
   业务对象	数据来源于“业务对象”。
   业务对象类属性代码	业务对象属性的代码，系统唯一值。 取值长度不超过30个字符。
   业务对象类属性名称	业务对象属性的名称。 取值长度不超过60个字符。
   数据类型	业务对象属性的数据类型。 目前支持varchar、number、date。
   默认值	业务对象属性的默认值。 取值长度不超过60个字符，且只能为字母、数字和特殊符号_+@&():-
   业务对象类属性描述	业务对象属性的描述。 取值长度不超过1000个字符。
   备注	业务对象属性的备注。 取值长度不超过1000个字符。

5. 单击“保存”，业务对象属性添加完成。

业务对象/业务对象属性相关操作

业务对象/业务对象属性添加完成后，您还可以进行如表19所示的操作。

查询生成器关联动态

1. 在顶部导航栏中，选择“制造数据模型管理 > 建模工具 > ID生成器定义”，进入“ID生成器定义”页面。
2. 选择“生成器关联动态”页签。
3. 在动态列表上方输入框输入“生成器名称”信息后，按回车键，查询生成器关联动态。
   

   单击右上角，可以根据需求进行页面展示信息的个性化设置。

解析条码

1. 在顶部导航栏中，选择“制造数据模型管理 > 建模工具 > ID生成器定义”，进入“ID生成器定义”页面。
2. 选择“条码解析”页签。
3. 选择标签后，再在条码框当中输入对应条码信息。

   或者先单击“高级”，然后输入编码（生成器代码）信息，选择标签或分类后，再在条码框当中输入对应条码信息。

4. 单击“解析一下”。

   条码解析成功如图2所示。

   图2 条码解析成功