## 主数据二开指导文档 ### 一、主数据配置器介绍主数据配置器是一种用于管理和配置主数据的工具。主数据是组织中用于描述业务实体的关键数据，如客户、供应商、产品等。主数据配置器允许用户定义和维护主数据的属性、关系和规则，以确保数据的一致性和准确性。通过主数据配置器，用户可以创建、修改和删除主数据对象，并定义其属性和关系。主数据配置器还提供了数据验证、数据导入和导出、数据同步等功能，以帮助用户管理和维护主数据。在我们系统中，主数据分为两类，固化主数据和自定义主数据固化主数据：基于系统原本的主数据（客商、员工、公司部门等）生成的固化配置，并提供了在固有配置上扩展字段的功能；固化主数据是系统自动初始化生成的。针对3.8以下版本接入主数据可能要进行适配，升级主数据后3.8版本以前页面的增删查改接口全部失效，全部基于主数据配置，使用通用的接口进行增删查改。 ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2023/08/31/A02AE0CFFFFFE51108C4909FB1B7B2AE0067.png) 自定义主数据：用户基于自己的业务，配置生成的主数据。 ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2023/08/31/A02AE0CFFFFFE51304D61D56B1B7B2AE0068.png) 3.8版本已接入主数据的模板 | 主数据 | 编码 | 是否支持配置 | | ------------------------- | -------------------------- | ------------ | | 纳税人信息 | SYS_LEGAL_PERSON | 是 | | 公司部门 | SYS_DEPT | 是 | | 员工信息 | SYS_EMP | 是 | | 项目管理 | SYS_PROJECT | 是 | | 客商管理 | SYS_VENDORS | 是 | | 商品管理 | SYS_TRADE_NAME | 是 | | 业务类型 | SYS_BIZ_CATEGORY | 是 | | 账套管理 | SYS_SOB | 是 | | 财务组织 | SYS_FU_LE_CC | 是 | | 公司账户 | SYS_COMPANY_BANK | 是 | | 结算方式 | SYS_PAYMENT_MODE | 是 | | 城市管理 | SYS_CITY | 否 | | 币种管理 | SYS_CURRENCY | 否 | | 银联号管理 | SYS_BANK_UNITED_CODE | 否 | | 交通工具席别 | SYS_VEHICLE_SEAT | 否 | | 火车站/机场 | SYS_STAND | 否 | | 银行管理 | SYS_BANK | 否 | | 用户管理 | SYS_USER_ACCOUNT | 否 | | 科目体系 | SYS_COA_ACCOUNT_SCHEME | 否 | | 税种税率 | SYS_TAX_RATE | 否 | | 汇率方案 | SYS_EXCHANGE_RATE | 否 | | 现金流标识 | CASH_FLOW | 否 | | 科目体系类型 | SYS_SUBJECT_TYPE | 否 | | 科目体系类型-会计要素明细 | SYS_SUBJECT_TYPE_CONFIG | 否 | | 科目体系-科目明细 | SYS_COA_ACCOUNT_ERP | 否 | | 维度管理 | SYS_FLEX_VALUE_SETS | 否 | | 维度管理-自定义成员 | SYS_FLEX_VALUE_SETS_CUSTOM | 否 | 不支持配置的模板，在页面对其配置进行了隐藏，其增删查改接口不变，只是增加了隐藏配置支持其他主数据的数据源进行引用。 #### 功能介绍主数据提供了配置以下功能：区域配置，字段配置（必填、唯一、编辑、展示、字段数据源、字段关联赋值、字段长度、格式、查询条件等），按钮配置（新增、删除、编辑、启用、禁用、导出），控制规则（动态展示、编辑、必填）。 ##### 区域配置新建主数据时，系统会默认生成一个主表区，并给该表生成系统字段；如果该业务数据存在关联子数据，可以在此基础上新增一个明细表，系统会自动生成明细表的系统字段；每个主数据最多支持添加三个明细区域，用户可以自定义这些区域的名称。 ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2023/08/31/A02AE0CFFFFFE5303C124819B1B7B2AE0069.png) ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2023/08/31/A02AE0CFFFFFE549886F6DECB1B7B2AE006A.png) ##### 字段配置在系统字段的基础上（系统字段不允许编辑、删除和修改），用户可以基于自己的业务去配置字段属性 ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2023/08/31/A02AE0CFFFFFE5ADA5A65A5FB1B7B2AE006C.png) ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2023/08/31/A02AE0CFFFFFE5B88BCB16C0B1B7B2AE006D.png) **下拉框和弹出框** 支持配置数据源，下拉框只支持配置系统编码，弹出框只支持配置主数据（已发布的主数据）；下拉框支持在选择的系统编码的值中进行过滤 ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2023/08/31/A02AE0CFFFFFE60AF3110B65B1B7B2AE006E.png) 对于弹出框可以选择前置字段和范围条件 ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2023/08/31/A02AE0CFFFFFE6131505C39DB1B7B2AE006F.png) ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2023/08/31/A02AE0CFFFFFE6157717A4D6B1B7B2AE0070.png) 用户也可以对新增编辑的弹框进行配置（包括展示字段，查询条件字段以及收藏展示字段） ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2023/08/31/A02AE0CFFFFFE62EB8BA713AB1B7B2AE0071.png) 以及关联赋值 ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2023/08/31/A02AE0CFFFFFE640BEA549A0B1B7B2AE0072.png) **其他类型** 支持配置字段的格式、长度校验 ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2023/08/31/A02AE0CFFFFFE663C211440EB1B7B2AE0073.png) ##### 按钮配置 ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2023/08/31/A02AE0CFFFFFE67924DCFC1DB1B7B2AE0074.png) ##### 控制规则控制规则分为两类，区域：支持动态展示；字段：支持动态展示、编辑、必填 ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2023/08/31/A02AE0CFFFFFE68E9603324CB1B7B2AE0075.png) #### 数据流向 ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2023/08/31/A02AE0CFFFFFE398EC954E52B1B7B2AE0066.png) ### 二、数据库表说明 | **数据库表** | **表注释** | **说明** | | -------------------------- | ------------------ | ---------------------------------------------------------------------------- | | MD_TEMPLATE | 主数据 | 存储所有的主数据 | | MD_TEMPLATE_LANGUAGE | 主数据语言 | 存储主数据对应的语言 | | MD_TEMPLATE_FIELD | 主数据字段配置 | 存储主数据所有配置字段信息 | | MD_TEMPLATE_FIELD_LANGUAGE | 主数据字段语言 | 存储主数据配置字段的多语言信息 | | MD_TEMPLATE_AREA | 主数据区域 | 存储主数据的区域配置 | | MD_TEMPLATE_AREA_LANGUAGE | 主数据区域语言 | 存储主数据区域配置的多语言信息 | | MD_CONFIG_BUTTON_DEF | 主数据按钮配置 | 支持通用新增、编辑、删除、启用禁用、导出按钮。如果项目存在特殊按钮，需要二开 | | MD_CONFIG_RULE | 主数据控制规则 | 存储主数据字段、区域动态展示、编辑、必填规则 | | MD_DATASOURCE_POP | 主数据字段弹窗设置 | 存储字段数据源弹框展示字段，查询字段，收藏字段信息 | | MD_DATASOURCE_RANGE | 主数据数据源范围 | 存储主数据数据源范围条件和动态规则条件，根据type来区分 | | MD_RELATE_ASSIGNMENT | 主数据关联赋值 | 字段数据源的关联赋值数据 | | MD_CONFIG_FIELDS_POOL | 字段池 | 存放字段编码，用于新增字段时赋值编码，初始为空 | | MD_CONFIG_CODE_RULE | 编码规则 | 存储key-value格式，用于获取自定义主数据编码、区域编码、字段编码的规则 | ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2023/08/31/A02AE0CFFFFFE7E46E0FA119B1B7B2AE0076.png) ### 升级说明 **由于主数据的基于配置实现增删改查，如果3.8以下项目需要升级到3.8，且有二开主数据，需要增加配置数据。** **注意：** **主数据的所有表都是联合主键 (GROUP_ID, ID)** **升级前确保要升级的主数据为发布状态，升级后重新发布模板；** **升级脚本时需要额外初始化GP00的数据(修改脚本的集团ID为GP00即可）** #### **新增/修改字段** 如果存在新增/修改字段，需要新增/修改字段数据（MD_TEMPLATE_FIELD）、字段多语言数据（MD_TEMPLATE_FIELD_LANGUAGE） **MD_TEMPLATE_FIELD 字段说明** | **字段** | **必填** | **说明** | | ------------------------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | GROUP_ID | 是 | 集团ID | | ID | 是 | 全局ID,默认uuid | | TEMPLATE_ID | 是 | 对应主数据的ID（MD_TEMPLATE表的ID） | | ALIAS_FLAG | 否 | 别名，升级可忽略 | | AREA_CODE | 是 | 所属区域编码（MD_TEMPLATE_AREA表的AREA_CODE) | | TABLE_NAME | 是 | 所属表（MD_TEMPLATE_AREA表的TABLE_NAME) | | AREA_UUID | 是 | 所属区域的uuId （MD_TEMPLATE_AREA表的AREA_UUID) | | AREA_TYPE | 是 | 区域类型，主表区1，明细区2 | | FIELD_UUID | 是 | 字段唯一ID，默认uuId | | FIELD_CODE | 是 | 字段编码，需要转为驼峰格式 | | FIELD_TYPE | 是 | 字段类型，1-文本、2-数字、3-单选、4-时间（对应数据库为字符串格式）
、5-文本域、6-多选、7-时间（数据库格式为时间戳）、8-多选（明细表多选） | | CONTROL_TYPE | 是 | 控件类型，text-文本框、textarea-文本域输入框、num-数字输入框、
amount-金额输入框、date-日期选择框、datetime-日期时间选择框、
select-单选下拉选择框、multi-select-多选下拉选择框、table-单选弹出选择框、
multi-table-多选弹出选择框、switch-开关按钮 | | LANGUAGE_KEY | 否 | 多语言表标识，升级可忽略 | | DATA_TEMPLATE_ID | 数据源为主数据时必填 | 数据源ID，只有字段为数据源类型行需要设置为对应数据源的模板ID
（MD_TEMPLATE表的ID） | | DATA_TEMPLATE_CODE | 字段为数据源时必填 | 数据源类型编码，字段为数据源或字典生效，保存对应编码 | | DATA_TEMPLATE_TYPE | 字段为数据源时必填 | 数据源类型，100-系统编码、300-主数据 | | DATA_TEMPLATE_TYPE_DETAIL | 否 | 数据源类型明细，100-系统编码、
主数据-对应MD_TEMPLATE表中的DATA_TEMPLATE_TYPE | | DATA_TEMPLATE_AREA | 字段为数据源时必填 | 数据源所属区域，多个以^分割（数据源需要查询的区域，需要几个配几个） | | SHOW_FLAG | 是 | 是否展示;0是1否. | | ADD_EDIT_FLAG | 是 | 新增编辑是否展示;0是1否. | | SUBMIT_EDIT_FLAG | 是 | 提交后是否可编辑;0是1否. | | REQUIRED_FLAG | 是 | 是否必填;0是1否. | | UNIQUE_FLAG | 是 | 是否唯一;0是1否. | | LIMIT_FORMAT | 否 | 限制格式及长度;文本时为长度（不要超过数据库长度），
数值是为小数位，时间字段为时间格式. | | DATA_CHECK_RULE | 否 | 数据校验规则，取值系统编码（BOE_FORMAT_CHECK） | | DEFAULT_VALUE | 否 | 新增时的默认值 | | DATA_SOURCE_RANGE_FLAG | 是 | 是否设置数据源范围;0是1否. | | ALTER_SETTING_FLAG | 是 | 是否设置数据源-弹窗设置;0是1否. | | RELATE_ASSIGNMENT_FLAG | 是 | 是否设置数据源-关联赋值;0是1否. | | LIST_DISPLAY_FLAG | 是 | 是否列表显示;0是1否. | | DATA_QUERY_FLAG | 是 | 是否展示查询条件;0是1否. | | DATA_QUERY_REQUIRE_FLAG | 否 | 查询条件(是否必填). 0否，1是，如果是时间框（0单边必填，1双边必填，2否） | | DATA_QUERY_INDEX_FLAG | 否 | 是否索引；0是1否. 升级默认设置为1，否则后续修改可能会有问题 | | DATA_QUERY_ORDER | 展示查询条件时必填 | 查询设置(排序)；值越小，优先级越高，默认为0 | | DATA_QUERY_DEFAULT | 否 | 查询设置(默认值). | | PUBLISH_FLAG | 是 | 操作状态;0已发布 1未发布.（md_template表中的last_state字段） | | SAVE_FLAG | 是 | 是否保存到主表，0是，1否（是否保存到主表中，如果是保存在明细表为1） | | FIELD_FLAG | 是 | 字段类型标识;
0-隐藏字段（ID,GROUP_ID,ENABLED_FLAG)、
1-系统字段（创建人、创建时间、修改人、修改时间、启用标识）、
2-固化字段、
3-自定义字段、
4-扩展字段；
注：（隐藏字段、和系统字段是固定字段、不允许添加；
隐藏字段不允许进行修改配置的任何操作，
系统字段和固化字段只允许进行配置列表展示和查询展示，
但是固化字段支持被关联赋值，系统字段不支持被关联赋值，
自定义字段和扩展字段（extendS1、extendS2...）允许配置所有配置，
但是扩展字段不允许删除；
项目二开时根据需要修改该字段为2、3、4中的一个） | | P_FLAG | 是 | 是否父级标识（0是，1否），（树状主数据需要，默认设为否） | | SORT_NUM | 是 | 排序，值越小，优先级越高 | | validity_flag | 是 | 是否启用；0是1否 | | enabled_flag | 是 | 使用有效；0是1否 | | create_by | 是 | 创建人 | | create_date | 是 | 创建时间 | | last_update_by | 是 | 修改人 | | last_update_date | 是 | 修改时间 | **MD_TEMPLATE_FIELD_LANGUAGE字段说明** | **字段** | **必填** | **说明** | | -------------- | -------------- | --------------------------------------------------------- | | GROUP_ID | 是 | 集团ID | | ID | 是 | 全局ID,默认uuid | | TEMPLATE_ID | 是 | 对应主数据的ID（MD_TEMPLATE表的ID） | | REF_ID | 是 | 关联模板字段ID（MD_TEMPLATE_FIELD表的ID） | | LANGUAGE | 是 | 语言类型 | | NAME | 是 | 字段名称 | | REMARK | 否 | 备注 | | PUBLISH_FLAG | 是 | 是否发布;0是1否.（对应MD_TEMPLATE_FIELD中的PUBLISH_FLAG） | **注意事项：多选字段最多只支持保存1000个数据，如果超过建议使用关联表；** **如果控件类型选择了开关按钮，后端默认值为0是，1否，如果后端不是存的0，1需要改成下拉框；** **如果新增字段类型为关联表中的字段或有特殊逻辑的字段，需要自己实现自定义bean实现增删查改，bean名为区域名；** **示例：cn.ztessc.service.md.MdSysProjectService** --- ```java @Service("sys_project") public class MdSysProjectService extends AbstractMdUseStrategy implements IMDQueryService { // 查询条件特殊的字段 @Override public List specialFields() { return Arrays.asList(principals, directors, cityId, fuId); } // 不在数据库中的字段 @Override public List notInFields() { return Arrays.asList(principals, directors, cityId, fuId); } // 自己实现查询sql @Override public String where(String field, Object value, String condition) { String selectField = field; if (principals.equals(field) || directors.equals(field)) { selectField = "userId"; } String conditionSql = whereCondition(selectField, value, condition, MdConfigEnums.FieldType.SINGLE.getCode()); if (StrUtil.isNotBlank(conditionSql)) { conditionSql = " and " + conditionSql; } if (principals.equals(field)) { return "exists (select 1 from sys_project_user where sys_project.id = sys_project_user.project_id " + "and sys_project_user.enabled_flag = '0' " + "and sys_project_user.type = '0' " + conditionSql + ")"; } else if (directors.equals(field)) { return "exists (select 1 from sys_project_user where sys_project.id = sys_project_user.project_id " + "and sys_project_user.enabled_flag = '0' " + "and sys_project_user.type = '1' " + conditionSql + ")"; } else if (cityId.equals(field)) { return "exists (select 1 from sys_project_area where sys_project.id = sys_project_area.project_id " + conditionSql + ")"; } else if (fuId.equals(field)) { return "exists (select 1 from sys_project_dept where sys_project.id = sys_project_dept.project_id " + conditionSql + ")"; } else { return ""; } } // 回显字段 @Override public void fillData(Map data, List fillFields, boolean aliasFlag) { String pre = aliasFlag ? TABLE_PRE : MdSqlConstants.EMPTY_STR; String id = (String) data.get(pre + "id"); if (StrUtil.isBlank(id)) { return; } if (fillFields.contains(principals) || fillFields.contains(directors)) { // 通过项目ID查询 List users = sysProjectUserService.listByProjectIdAndEnabledFlag(id, Constant.DEFAULT_FLAG_YES); if (CollUtil.isNotEmpty(users)) { Map> collect = users.stream().collect(Collectors.groupingBy(SysProjectUserEntity::getType, Collectors.mapping(SysProjectUserEntity::getUserId, Collectors.toList()))); Optional.ofNullable(collect.get(EnumType.ProjectUserType.PRINCIPAL.getCode())) .ifPresent(item -> data.put(pre + principals, CollUtil.join(item, Constant.DELIMITER_ANGLE_ESCAPE))); Optional.ofNullable(collect.get(EnumType.ProjectUserType.DIRECTOR.getCode())) .ifPresent(item -> data.put(pre + directors, CollUtil.join(item, Constant.DELIMITER_ANGLE_ESCAPE))); } } // 城市 if (fillFields.contains(cityId)) { List areas = sysProjectAreaService.findCityIdListByProjectId(id); if (CollUtil.isNotEmpty(areas)) { data.put(pre + cityId, CollUtil.join(areas, Constant.DELIMITER_ANGLE_ESCAPE)); } } // 核算主体 if (fillFields.contains(fuId)) { List fuIds = sysProjectDeptService.findFuIdsByProjectId(id); if (CollUtil.isNotEmpty(fuIds)) { data.put(pre + fuId, CollUtil.join(fuIds, Constant.DELIMITER_ANGLE_ESCAPE)); } } } // 回显字段 @Override public void fillData(List> list, List fillFields, boolean aliasFlag) { String pre = aliasFlag ? TABLE_PRE : MdSqlConstants.EMPTY_STR; String key = pre + "id"; Set keySet = MdUtils.getKeySet(list, key); if (CollUtil.isEmpty(keySet)) { return; } List keyList = new ArrayList<>(keySet); if (fillFields.contains(principals) || fillFields.contains(directors)) { // 通过项目ID查询 List users = sysProjectUserService .listByProjectIdsAndEnabledFlag(new ArrayList<>(keyList), Constant.DEFAULT_FLAG_YES); if (CollUtil.isNotEmpty(users)) { Map> collect = users.stream().collect(Collectors.groupingBy( item -> MdUtils.getKey(item.getProjectId(), item.getType()), Collectors.mapping(SysProjectUserEntity::getUserId, Collectors.toList()))); for (Map data : list) { Optional.ofNullable(collect.get(MdUtils.getKey( data.get(key), EnumType.ProjectUserType.PRINCIPAL.getCode()))) .ifPresent(item -> data.put(pre + principals, CollUtil.join(item, Constant.DELIMITER_ANGLE_ESCAPE))); Optional.ofNullable(collect.get(MdUtils.getKey( data.get(key), EnumType.ProjectUserType.DIRECTOR.getCode()))) .ifPresent(item -> data.put(pre + directors, CollUtil.join(item, Constant.DELIMITER_ANGLE_ESCAPE))); } } } // 城市 if (fillFields.contains(cityId)) { Map> cityMap = sysProjectAreaService.findCityIdListByProjectId(keyList); cityMap.forEach((k, v) -> list.stream() .filter(data -> Objects.equals(data.get(key), k)) .findFirst() .ifPresent(data -> data.put(pre + cityId, CollUtil.join(v, Constant.DELIMITER_ANGLE_ESCAPE)))); } // 核算主体 if (fillFields.contains(fuId)) { Map> fuIdMap = sysProjectDeptService.findByProjectIds(keyList); fuIdMap.forEach((k, v) -> list.stream() .filter(data -> Objects.equals(data.get(key), k)) .findFirst() .ifPresent(data -> data.put(pre + fuId, CollUtil.join(v, Constant.DELIMITER_ANGLE_ESCAPE)))); } } // 自定义新增 @Override public boolean specialAddBehind(Map> map, MainDataParam param) { if (CollUtil.isEmpty(map)) { return true; } saveProjectDetail(map, param); return true; } // 自定义修改 @Override public void specialUpdateBehind(List> list, MainDataParam param) { if (CollUtil.isEmpty(list)) { return; } List idList = MdUtils.getIdList(list); // 删除关联数据 removeProjectDetail(idList); Map> map = list.stream() .collect(Collectors.toMap(item -> (String) item.get("id"), item -> item)); // 保存关联数据 saveProjectDetail(map, param); // 删除缓存 removeCacheByIds(idList.toArray(new String[0])); } ``` #### 新增/修改弹框数据源如果新增字段存在数据源，则根据需要初始化 MD_DATASOURCE_RANGE（数据源范围，过滤条件）、MD_DATASOURCE_POP（数据源弹框的展示条件、查询条件）、MD_RELATE_ASSIGNMENT（数据源关联赋值） **MD_DATASOURCE_RANGE 主要用于过滤数据源条件（对应配置中的数据源配置-数据源范围）和级联查询条件（对应配置中的数据源配置-关联条件），如果不配置则默认展示所有数据包括启用禁用数据，MD_DATASOURCE_RANGE字段信息** | **字段** | **必填** | **说明** | | ------------------ | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | GROUP_ID | 是 | 集团ID | | ID | 是 | 全局ID,默认uuid | | TEMPLATE_ID | 是 | 对应主数据的ID（MD_TEMPLATE表的ID） | | RANGE_TYPE | 是 | 范围类型;1关联条件、2数据范围、3控制规则 | | REF_ID | 是 | 关联主表ID，RANGE_TYPE 为1、2时，为字段表ID；
为3时，为控制规则表MD_CONFIG_RULE的RULE_ID | | LEFT_AREA_CODE | RANGE_TYPE为2、3时必填 | 当前模板区域code. | | LEFT_FIELD_UUID | RANGE_TYPE为1、3时必填 | 字段Uuid，当RANGE_TYPE为2时，必须为空，否则回显有问题 | | LEFT_FIELD_CODE | 是 | 字段编码 | | LEFT_TEMPLATE_ID | 左边字段为主数据时必填 | 为左边字段的模板ID | | LEFT_FIELD_TYPE | 左边字段为数据源时必填 | 左边字段的数据源类型，100系统编码、300主数据 | | LEFT_TEMPLATE_CODE | 左边字段为数据源时必填 | LEFT_FIELD_TYPE为100时，为系统编码，200时为主数据编码 | | LEFT_FIELD_TYPE | 是 | 左边字段的控件类型，对应ME_TEMPLATE_FIELD的FIELD_TYPE | | LEFT_CONTROL_TYPE | 是 | 左边字段的控件类型，对应ME_TEMPLATE_FIELD的CONTROL_TYPE | | CONDITION_TYPE | 是 | 操作符类型，
1-为空、2-不为空、3-包含、4-不包含、5-大于、6-等于、
7-小于、8-不等于、9-大于等于、10-小于等于、12-区间；
如果RANGE_TYPE为1，则默认为6-等于； | | RIGHT_VALUE | 是 | 右边值，
如果RANGE_TYPE 为1（关联条件）时，则为关联的字段编码，
如果为2、3则为具体值 | | RIGHT_AREA_VALUE | 如果RANGE_TYPE 为1时必填 | 右边值区域;
RANGE_TYPE 为1（关联条件）时为关联的区域
RANGE_TYPE 为2、3时为空 | | LOGIC_TYPE | 是 | 逻辑类型;
1且2或. 如果有多组条件，每组的最后一条为或 | | SORT_NUM | 是 | 序号，必须需要递增 | | PUBLISH_FLAG | 是 | 是否发布;0是1否，和当前字段的发布标识保持一致 | #### 字段关联赋值 MD_RELATE_ASSIGNMENT 主要用于选择数据源字段后进行关联赋值，如果不需要则可以不配置 **MD_RELATE_ASSIGNMENT 字段信息** | **字段** | **必填** | **说明** | | ---------------------- | -------------- | --------------------------------------------- | | GROUP_ID | 是 | 集团ID | | ID | 是 | 全局ID,默认uuid | | TEMPLATE_ID | 是 | 对应主数据的ID（MD_TEMPLATE表的ID） | | REF_ID | 是 | 字段关联ID（MD_TEMPLATE_FIELD表的ID） | | CUR_FIELD_UUID | 是 | 目标字段UuId | | CUR_FIELD_CODE | 是 | 目标字段code | | CUR_AREA | 是 | 目标字段所属区域 | | CUR_DATA_TEMPLATE_CODE | 是 | 关联字段的数据源编码 | | REF_TEMPLATE_ID | 否 | 来源字段的数据源ID | | REF_FIELD_CODE | 是 | 来源字段的字段编码 | | REF_AREA | 是 | 来源字段的所属区域 | | PUBLISH_FLAG | 是 | 是否发布;0是1否，和当前字段的发布标识保持一致 | #### 新增/修改数据源弹框展示字段和查询条件字段 MD_DATASOURCE_POP 主要用于配置展示字段和查询条件字段，如果不配置，默认展示code，name，查询条件默认展示code，name **MD_DATASOURCE_POP 字段信息** | **字段** | **必填** | **说明** | | ----------------- | -------------- | ----------------------------------------------------------- | | GROUP_ID | 是 | 集团ID | | ID | 是 | 全局ID,默认uuid | | TEMPLATE_ID | 是 | 对应主数据的ID（MD_TEMPLATE表的ID） | | REF_ID | 是 | 字段关联ID（MD_TEMPLATE_FIELD表的ID） | | REF_TEMPLATE_ID | 是 | 当前字段的数据源ID（MD_TEMPLATE_FIELD表的DATA_TEMPLATE_ID） | | REF_AREA_CODE | 是 | 选择字段的区域code | | REF_FIELD_CODE | 是 | 选择字段的字段code | | LIST_DISPLAY_FLAG | 是 | 列表显示;0是1否. | | QUERY_FLAG | 是 | 查询条件;0是1否. | | FAVORITE_FALG | 是 | 收藏时是否展示该字段，如果不配置默认展示主表区name;0是1否. | | PUBLISH_FLAG | 是 | 是否发布;0是1否，和当前字段的发布标识保持一致 | #### 新增动态规则（必填，展示，编辑）如果有字段存在动态展示，编辑，必填则需要初始化控制规则表 MD_CONFIG_RULE，规则条件表 MD_DATASOURCE_RANGE，MD_DATASOURCE_RANGE在数据源范围已经介绍过了 **MD_CONFIG_RULE 字段信息** | **字段** | **必填** | **说明** | | -------------- | -------------- | --------------------------------------------- | | GROUP_ID | 是 | 集团ID | | ID | 是 | 全局ID,默认uuid | | TEMPLATE_ID | 是 | 对应主数据的ID（MD_TEMPLATE表的ID） | | AREA_UUID | 是 | 字段-所属区域UUID | | AREA | 是 | 字段-所属区域编码 | | RULE_ID | 是 | 规则ID，对应MD_DATASOURCE_RANGE的REF_ID | | INFLUENCE_TYPE | 是 | 影响类型;AREA：区域，FILED：字段. | | REF_UUID | 是 | 影响字段UUID. | | REF_CODE | 是 | 影响字段CODE | | SHOW_FLAG | 是 | 是否展示;0是1否. | | REQUIRED_FLAG | 是 | 是否必填;0是1否. | | EDIT_FLAG | 是 | 是否编辑;0是1否. | | PUBLISH_FLAG | 是 | 是否发布;0是1否，和当前字段的发布标识保持一致 | ### 三、升级步骤 #### 1.第一步：对比确定需要升级的主数据配置对比涉及表，看是否有新增字段，如有则对应的主数据需要手动升级 | 主数据 | 编码 | 涉及表 | | ------------------------- | -------------------------- | ----------------------------------------------- | | 纳税人信息 | SYS_LEGAL_PERSON | sys_legal_person | | 公司部门 | SYS_DEPT | sys_dept | | 员工信息 | SYS_EMP | sys_emp、sys_vendors_bank、sys_dept | | 项目管理 | SYS_PROJECT | sys_project | | 客商管理 | SYS_VENDORS | sys_vendors、sys_vendors_bank | | 商品管理 | SYS_TRADE_NAME | sys_trade_name、sys_trade_name_config_total | | 业务类型 | SYS_BIZ_CATEGORY | sys_biz_category、sys_biz_category_le | | 账套管理 | SYS_SOB | sys_sob | | 财务组织 | SYS_FU_LE_CC | sys_fu_le_cc | | 公司账户 | SYS_COMPANY_BANK | sys_company_bank | | 结算方式 | SYS_PAYMENT_MODE | sys_payment_mode | | 城市管理 | SYS_CITY | sys_city | | 币种管理 | SYS_CURRENCY | sys_currency | | 银联号管理 | SYS_BANK_UNITED_CODE | sys_bank_united_code | | 交通工具席别 | SYS_VEHICLE_SEAT | sys_vehicle_seat | | 火车站/机场 | SYS_STAND | sys_stand | | 银行管理 | SYS_BANK | sys_bank | | 用户管理 | SYS_USER_ACCOUNT | sys_user_account | | 科目体系 | SYS_COA_ACCOUNT_SCHEME | sys_coa_account_scheme、sys_coa_account_erp | | 税种税率 | SYS_TAX_RATE | sys_tax_rate | | 汇率方案 | SYS_EXCHANGE_RATE | sys_exchange_rate | | 现金流标识 | CASH_FLOW | cash_flow | | 科目体系类型 | SYS_SUBJECT_TYPE | sys_subject_type、sys_subject_type_config | | 科目体系类型-会计要素明细 | SYS_SUBJECT_TYPE_CONFIG | sys_subject_type_config | | 科目体系-科目明细 | SYS_COA_ACCOUNT_ERP | sys_coa_account_erp | | 维度管理 | SYS_FLEX_VALUE_SETS | sys_flex_value_sets、sys_flex_value_sets_custom | | 维度管理-自定义成员 | SYS_FLEX_VALUE_SETS_CUSTOM | sys_flex_value_sets_custom | #### 2.第二步：添加liquebase脚本 1.新建 liquebase xml脚本，并在同级目录下新建文件夹 update_md_config_up 用于存放升级csv文件。注意修改xml中文件路径（db/prd/zfs-base/V3.8.1SAAS/zfs_sys/update_md_config）为当前路径 ```xml 初始化字段(通过csv) 初始化字段弹框配置(通过csv) 初始化字段关联赋值配置(通过csv) 初始化字段关联条件配置(通过csv) 初始化字段数据源范围配置(通过csv) 初始化控制规则配置(通过csv) 清除主数据缓存 ``` 2.在liquebase入口xml文件中引入该文件，file路径修改为真实路径 ```xml ``` 注意：配置文件中的value须修改为真实的csv文件路径； #### 3.第三步：添加csv文件注：所有的脚本需要额外初始化GP00集团 ##### 1.添加字段在 update_md_config_up 下新建文件 md_template_field.csv （md_template_field.csv）列介绍： | 列名 | 必填 | 备注 | | -------------------- | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | groupId | 是 | 所有集团都需要初始化填@{groupId}，否则填集团编码 | | templateCode | 是 | 主数据模板编码 | | areaCode | 是 | 主数据区域编码 | | fieldCode | 是 | 主数据字段编码（驼峰） | | fieldType | 是 | 字段类型；1-文本、2-数字、3-单选、4-时间（对应数据库为字符串格式）、5-文本域、6-多选、
7-时间（数据库格式为时间戳）、8-多选（明细表多选） | | controlType | 是 | 控件类型；text-文本框、textarea-文本域输入框、num-数字输入框、amount-金额输入框、date-日期选择框、
datetime-日期时间选择框、select-单选下拉选择框、multi-select-多选下拉选择框、table-单选弹出选择框、
multi-table-多选弹出选择框、switch-开关按钮 | | languageKey | 否 | 多语言字段的关联key，多语言字段使用 | | dataTemplateCode | 否 | 数据源编码（主数据时为主数据编码，系统编码时为系统编码） | | dataTemplateType | 否 | 数据源类型（100系统编码，300主数据） | | dataTemplateArea | 否 | 主数据区域（dataTemplateType为300时必填，多个时用^连接），如果是多选字段，只支持填数据源的主表编码 | | showFlag | 是 | 新增，编辑页面是否展示：0是1否 | | addEditFlag | 是 | 新增是否可修改：0是1否 | | submitEditFlag | 是 | 编辑是否可修改：0是1否 | | requiredFlag | 是 | 是否必填：0是1否 | | uniqueFlag | 是 | 是否唯一：0是1否 | | limitFormat | 否 | 范围限制：
文本框、文本域填长度；
数字、金额框填小数位数；
日期框（年-year，年月-month，年月日-date） | | dataCheckRule | 否 | 格式校验：
文本框、文本域取系统编码BOE_FORMAT_CHECK；
数字、金额框填数值范围（例：-9999999.99^99999999.99）；
日期框填日期范围（例：2022-01-01^2023-01-01） | | defaultValue | 否 | 新增默认值 | | dataSourceRangeFlag | 是 | 是否配置了数据源范围：0是1否 | | dictRange | 否 | 系统编码数据源范围，多个用^隔开，dataTemplateType为100时生效，
例：001^002，表示新增编辑时只能选到编码为001和002的数据，不填查询所有 | | alterSettingFlag | 是 | 是否配置了数据源弹框：0是1否 | | relateAssignmentFlag | 是 | 是否配置了关联赋值：0是1否 | | listDisplayFlag | 是 | 列表是否展示：0是1否 | | dataQueryFlag | 是 | 是否展示查询条件：0是1否 | | dataQueryRequireFlag | 是 | 查询条件是否必填：0是1否 | | dataQueryOrder | 否 | 查询条件排序 | | dataQueryDefault | 否 | 查询条件默认值 | | sortNum | 否 | 字段排序 | | fieldFlag | 是 | 字段标识：2固化字段（不支持页面修改配置），4扩展字段（支持页面修改配置） | | saveFlag | 是 | 数据库是否有该字段：0是1否 | | cnName | 是 | 字段中文名 | | enName | 是 | 字段英文名 | csv示例： ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2023/09/12/A02AE0CFFFFF8D9BF366278AB1B7B2AE00C5.png) csv文件（根据实际业务修改）： ```csv groupId,templateCode,areaCode,fieldCode,fieldType,controlType,languageKey,dataTemplateCode,dataTemplateType,dataTemplateArea,showFlag,addEditFlag,submitEditFlag,requiredFlag,uniqueFlag,limitFormat,dataCheckRule,defaultValue,dataSourceRangeFlag,dictRange,alterSettingFlag,relateAssignmentFlag,listDisplayFlag,dataQueryFlag,dataQueryRequireFlag,dataQueryOrder,dataQueryDefault,sortNum,fieldFlag,saveFlag,cnName,enName XY,SYS_EMP,sys_emp,textField,1,text,"","","","",0,0,0,0,1,64,"","",1,"",1,1,0,1,1,"","",100,4,0,文本字段,文本字段（英文） XY,SYS_EMP,sys_emp,textareaField,5,textarea,"","","","",0,0,0,0,1,200,"","",1,"",1,1,0,1,1,"","",101,4,0,文本域字段,文本域字段（英文） XY,SYS_EMP,sys_emp,numField,2,num,"","","","",0,0,0,0,1,6,"","",1,"",1,1,0,1,1,"","",102,4,0,数字字段,数字字段（英文） XY,SYS_EMP,sys_emp,amountField,2,amount,"","","","",0,0,0,0,1,2,"","",1,"",1,1,0,1,1,"","",103,4,0,金额字段,金额字段（英文） XY,SYS_EMP,sys_emp,dateField,7,date,"","","","",0,0,0,0,1,date,"","",1,"",1,1,0,1,1,"","",104,4,0,日期字段,日期字段（英文） XY,SYS_EMP,sys_emp,datetimeField,7,datetime,"","","","",0,0,0,0,1,"","","",1,"",1,1,0,1,1,"","",105,4,0,日期时间字段,日期时间字段（英文） XY,SYS_EMP,sys_emp,selectField,3,select,"",ROLE_TYPE,100,"",0,0,0,0,1,"","","",0,0^1^2^3,1,1,0,1,1,"","",106,4,0,单选下拉框字段,单选下拉框字段（英文） XY,SYS_EMP,sys_emp,multiSelectField,6,multi-select,"",ROLE_TYPE,100,"",0,0,0,0,1,"","","",1,"",1,1,0,1,1,"","",107,4,0,多选下拉框字段,多选下拉框字段（英文） XY,SYS_EMP,sys_emp,tableField,3,table,"",SYS_DEPT,300,sys_dept,0,0,0,0,1,"","","",1,"",1,1,0,1,1,"","",108,4,0,单选弹出框字段,单选弹出框字段（英文） XY,SYS_EMP,sys_emp,multiTableField,6,multi-table,"",SYS_DEPT,300,sys_dept,0,0,0,0,1,"","","",1,"",1,1,0,1,1,"","",109,4,0,多选弹出框字段,多选弹出框字段（英文） XY,SYS_EMP,sys_emp,switchField,3,switch,"",YES_OR_NO,100,"",0,0,0,0,1,"","","",1,"",1,1,0,1,1,"","",110,4,0,开关按钮字段,开关按钮字段（英文） GP00,SYS_EMP,sys_emp,textField,1,text,"","","","",0,0,0,0,1,64,"","",1,"",1,1,0,1,1,"","",100,4,0,文本字段,文本字段（英文） GP00,SYS_EMP,sys_emp,textareaField,5,textarea,"","","","",0,0,0,0,1,200,"","",1,"",1,1,0,1,1,"","",101,4,0,文本域字段,文本域字段（英文） GP00,SYS_EMP,sys_emp,numField,2,num,"","","","",0,0,0,0,1,6,"","",1,"",1,1,0,1,1,"","",102,4,0,数字字段,数字字段（英文） GP00,SYS_EMP,sys_emp,amountField,2,amount,"","","","",0,0,0,0,1,2,"","",1,"",1,1,0,1,1,"","",103,4,0,金额字段,金额字段（英文） GP00,SYS_EMP,sys_emp,dateField,7,date,"","","","",0,0,0,0,1,date,"","",1,"",1,1,0,1,1,"","",104,4,0,日期字段,日期字段（英文） GP00,SYS_EMP,sys_emp,datetimeField,7,datetime,"","","","",0,0,0,0,1,"","","",1,"",1,1,0,1,1,"","",105,4,0,日期时间字段,日期时间字段（英文） GP00,SYS_EMP,sys_emp,selectField,3,select,"",ROLE_TYPE,100,"",0,0,0,0,1,"","","",0,0^1^2^3,1,1,0,1,1,"","",106,4,0,单选下拉框字段,单选下拉框字段（英文） GP00,SYS_EMP,sys_emp,multiSelectField,6,multi-select,"",ROLE_TYPE,100,"",0,0,0,0,1,"","","",1,"",1,1,0,1,1,"","",107,4,0,多选下拉框字段,多选下拉框字段（英文） GP00,SYS_EMP,sys_emp,tableField,3,table,"",SYS_DEPT,300,sys_dept,0,0,0,0,1,"","","",1,"",1,1,0,1,1,"","",108,4,0,单选弹出框字段,单选弹出框字段（英文） GP00,SYS_EMP,sys_emp,multiTableField,6,multi-table,"",SYS_DEPT,300,sys_dept,0,0,0,0,1,"","","",1,"",1,1,0,1,1,"","",109,4,0,多选弹出框字段,多选弹出框字段（英文） GP00,SYS_EMP,sys_emp,switchField,3,switch,"",YES_OR_NO,100,"",0,0,0,0,1,"","","",1,"",1,1,0,1,1,"","",110,4,0,开关按钮字段,开关按钮字段（英文） ``` ##### 2.字段弹框配置在 update_md_config_up 下新建文件 md_datasource_pop.csv 注：只有单选弹出框字段和多选弹出框字段支持该配置（md_datasource_pop.csv）列介绍： | 列名 | 必填 | 备注 | | --------------- | ---- | -------------------------------------------------------------------------- | | groupId | 是 | 所有集团都需要初始化填@{groupId}，否则填集团编码 | | templateCode | 是 | 配置字段模板编码 | | areaCode | 是 | 配置字段区域编码 | | fieldCode | 是 | 配置字段编码 | | refAreaCode | 是 | 配置字段所属区域编码（该区域编码是必须为关联字段dataTemplateArea中的一个） | | refFieldCode | 是 | 弹框字段编码 | | listDisplayFlag | 是 | 是否展示：0是1否 | | queryFlag | 是 | 是否查询：0是1否 | | favoriteFlag | 是 | 是否收藏：0是1否（收藏字段不允许超过3个） | csv示例： ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2023/09/12/A02AE0CFFFFF8E6A607AA441B1B7B2AE00C8.png) 该配置表示字段 tableField 的弹框展示三列（code, type, name），查询条件（code, type, name），收藏时展示name字段 csv文件（根据实际业务修改）： ```csv groupId,templateCode,areaCode,fieldCode,refAreaCode,refFieldCode,listDisplayFlag,queryFlag,favoriteFlag XY,SYS_EMP,sys_emp,tableField,sys_dept,code,0,0,1 XY,SYS_EMP,sys_emp,tableField,sys_dept,name,0,0,0 XY,SYS_EMP,sys_emp,tableField,sys_dept,type,0,0,1 GP00,SYS_EMP,sys_emp,tableField,sys_dept,code,0,0,1 GP00,SYS_EMP,sys_emp,tableField,sys_dept,name,0,0,0 GP00,SYS_EMP,sys_emp,tableField,sys_dept,type,0,0,1 ``` ##### 3.字段关联赋值配置在 update_md_config_up 下新建文件 md_relate_assignment.csv 注：只有单选弹出框字段和多选弹出框字段支持该配置（md_relate_assignment.csv）列介绍： | 列名 | 必填 | 备注 | | ------------ | ---- | ------------------------------------------------ | | groupId | 是 | 所有集团都需要初始化填@{groupId}，否则填集团编码 | | templateCode | 是 | 配置字段模板编码 | | areaCode | 是 | 配置字段区域编码 | | fieldCode | 是 | 配置字段编码 | | toFieldCode | 是 | 需要赋值的字段编码 | | refArea | 是 | 赋值来源字段区域编码 | | refFieldCode | 是 | 赋值来源字段编码 | csv示例： ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2023/09/12/A02AE0CFFFFF8F1DF270F1C4B1B7B2AE00C9.png) 该配置表示，选择 tableFIeld 字段后，把数据源的 companyId 赋值给当前区域的 companyId ，和lov的trans类似 csv文件（根据实际业务修改）： ```csv groupId,templateCode,areaCode,fieldCode,toFieldCode,refArea,refFieldCode XY,SYS_EMP,sys_emp,tableField,companyId,sys_dept,companyId GP00,SYS_EMP,sys_emp,tableField,companyId,sys_dept,companyId ``` ##### 4.字段关联条件配置在 update_md_config_up 下新建文件 md_relate_condition.csv 注：只有单选弹出框字段和多选弹出框字段支持该配置（md_relate_condition.csv）列介绍： | 列名 | 必填 | 备注 | | -------------- | ---- | ----------------------------------------------------------------------------------------------------- | | groupId | 是 | 所有集团都需要初始化填@{groupId}，否则填集团编码 | | templateCode | 是 | 配置字段模板编码 | | areaCode | 是 | 配置字段区域编码 | | fieldCode | 是 | 配置字段编码 | | leftFieldCode | 是 | 关联字段编码 | | rightAreaCode | 是 | 被关联字段所属区域 | | rightFieldCode | 是 | 被关联字段编码 | | logicType | 是 | 且/或：每一组且条件的最后一条为或（2），其余的为且（1） | | sortNum | 是 | 顺序, 每个字段从上往下，由1开始递增（必须从1开始递增，且不能重复，序号为1的数据放到同组数据的最前面） | csv示例： ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2023/09/12/A02AE0CFFFFF8F9C8FCBA74DB1B7B2AE00CA.png) 该配置表示员工主数据查询 tableField 字段时（组织数据）需带上条件（组织数据的deptId等于员工的deptId），与lov的prev类似 csv文件（根据实际业务修改）： ```csv groupId,templateCode,areaCode,fieldCode,leftFieldCode,rightAreaCode,rightFieldCode,logicType,sortNum XY,SYS_EMP,sys_emp,tableField,deptId,sys_dept,deptId,1,1 GP00,SYS_EMP,sys_emp,tableField,deptId,sys_dept,deptId,1,1 ``` ##### 5.数据源范围配置在 update_md_config_up 下新建文件 md_ds_range.csv 注：只有单选弹出框字段和多选弹出框字段支持该配置；且该条件与关联条件并列，即两个条件都需要满足（md_ds_range.csv）列介绍： | 列名 | 必填 | 备注 | | ------------- | ---- | ------------------------------------------------------------------------------------------------------------------------------ | | groupId | 是 | 所有集团都需要初始化填@{groupId}，否则填集团编码 | | templateCode | 是 | 配置字段模板编码 | | areaCode | 是 | 配置字段区域编码 | | fieldCode | 是 | 配置字段编码 | | leftAreaCode | 是 | 关联字段编码 | | leftFieldCode | 是 | 被关联字段所属区域编码 | | rightValue | 是 | 被关联字段编码 | | conditionType | 是 | 条件类型：
1-为空、2-不为空、3-包含、4-不包含、5-大于、6-等于、
7-小于、8-不等于、9-大于等于、10-小于等于、12-区间； | | logicType | 是 | 且/或：每一组且条件的最后一条为或（2），其余的为且（1） | | sortNum | 是 | 顺序, 每个字段从上往下，由1开始递增（必须从1开始递增，且不能重复，序号为1的数据放到同组数据的最前面） | csv列示例： ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2023/09/12/A02AE0CFFFFF90C330688631B1B7B2AE00CC.png) 该配置表示员工主数据查询 tableField 字段时（组织数据）需带上条件（（组织数据的类型为1或者2，且pid不为0）或者组织数据的类型为3） csv文件（根据实际业务修改）： ```csv groupId,templateCode,areaCode,fieldCode,leftAreaCode,leftFieldCode,rightValue,conditionType,logicType,sortNum XY,SYS_EMP,sys_emp,tableField,sys_dept,type,1^2,3,1,1 XY,SYS_EMP,sys_emp,tableField,sys_dept,pid,0,4,2,2 XY,SYS_EMP,sys_emp,tableField,sys_dept,type,3,3,1,3 GP00,SYS_EMP,sys_emp,tableField,sys_dept,type,1^2,3,1,1 GP00,SYS_EMP,sys_emp,tableField,sys_dept,pid,0,4,2,2 GP00,SYS_EMP,sys_emp,tableField,sys_dept,type,3,3,1,3 ``` ##### 6.控制规则配置在 update_md_config_up 下新建文件 md_config_rule.csv （md_config_rule.csv）列介绍： | 列名 | 必填 | 备注 | | ------------- | ---- | ---------------------------------------------------------------------------------------------------------------------------- | | groupId | 是 | 所有集团都需要初始化填@{groupId}，否则填集团编码 | | templateCode | 是 | 配置字段模板编码 | | areaCode | 是 | 配置区域编码 | | fieldCode | 否 | 配置字段编码（如果是区域的动态规则则不填） | | ruleId | 是 | 条件id，唯一id，每一组条件ruleId一致 | | showFlag | 是 | 动态展示：0是，1否 | | requiredFlag | 是 | 动态必填：0是，1否 | | editFlag | 是 | 动态必填：0是，1否 | | leftFieldCode | 是 | 条件字段编码 | | rightValue | 是 | 条件值 | | conditionType | 是 | 条件类型：
1-为空、2-不为空、3-包含、4-不包含、5-大于、6-等于、
7-小于、8-不等于、9-大于等于、10-小于等于、12-区间 | | logicType | 是 | 且/或：每一组且条件的最后一条为或（2），其余的为且（1） | | sortNum | 是 | 顺序, 每个字段从上往下，由1开始递增（必须从1开始递增，且不能重复，序号为1的数据放到同组数据的最前面） | csv列示例： ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2023/09/12/A02AE0CFFFFF90CC822025E8B1B7B2AE00CD.png) 该配置表示，员工的主岗为空且职务为001时，tableField字段动态展示且动态必填 csv文件（根据实际业务修改）： ```csv groupId,templateCode,areaCode,fieldCode,ruleId,showFlag,requiredFlag,editFlag,leftFieldCode,rightValue,conditionType,logicType,sortNum XY,SYS_EMP,sys_emp,tableField,458bc62a0206af96d684b1b0aeb20009,0,0,1,mainPost,"",1,1,1 XY,SYS_EMP,sys_emp,tableField,458bc62a0206af96d684b1b0aeb20009,0,0,1,position,001,3,1,2 GP00,SYS_EMP,sys_emp,tableField,458bc62a0206af96d684b1b0aeb20009,0,0,1,mainPost,"",1,1,1 GP00,SYS_EMP,sys_emp,tableField,458bc62a0206af96d684b1b0aeb20009,0,0,1,position,001,3,1,2 ``` #### 4.第四步：手动发布升级后的主数据注意：第一次升级不需要手动发布，后续升级如果主数据模板是保存状态需要手动发布。 ### 四、关键代码介绍主数据代码主要分为三大块：配置端、用户端、接口端 #### 1.配置端配置端主要功能是维护主数据模板的配置以及提供配置给用户端使用，配置端所有业务功能在base服务zfs-base-common-core模块中，建表功能在common-source模块中 **模板管理 cn.ztessc.controller.md.MdTemplateController** ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2024/08/15/1830A2CE3B470069BB22B1B7B2AE013E.png) **模板配置 cn.ztessc.controller.md.config.*** ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2024/08/15/1830A2CE3B81DE462923B1B7B2AE013F.png) **建表功能 cn.ztessc.common.table.ITableOpera** ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2024/08/15/1830A2CE3BA891B6FC36B1B7B2AE0142.png) #### 2.用户端用户端提供了统一的增删查改接口，每个主数据调用的接口都一致，如果主数据（例如固化主数据）拥有特殊逻辑，需要继承主数据通用类重写特殊逻辑， **用户端通用接口 cn.ztessc.controller.md.use.MainDataUseController** ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2024/08/15/1830A2CE3C0E3CA62A0DB1B7B2AE0143.png) **用户端增删改通用逻辑 cn.ztessc.service.md.use.AbstractMdUseStrategy** ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2024/08/15/1830A2CE3C5FF0F5E0B3B1B7B2AE0144.png) 用户端通用方法实现了接口cn.ztessc.service.md.use.SpecialUseStrategyService，这个接口定义了一些主数据的扩展方法，如果主数据存在特殊逻辑可以通过重写接口中的方法来实现 ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2024/08/15/1830A2CE3CA56367C0A6B1B7B2AE0145.png) 产品固化主数据的特殊类位于zfs-base-bus-core模块中，注意特殊逻辑类的bean名需要按格式定义。如果是主数据的主表区，bean名为主表区表名（table_name)，例如：sys_emp（员工管理）。如是明细区bean名为主表区表名+"_"+明细区表名，例如：sys_emp_sys_vendors_bank（员工银行信息） ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2024/08/15/1830A2CE3CB51EC4B6A8B1B7B2AE0147.png) **通用查询接口（弹框查询）cn.ztessc.controller.md.core.MDCoreController** ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2024/08/15/1830A2CE3D1D5EAEFD87B1B7B2AE0148.png) 如果主数据存在特殊查询字段，例如字段为多选在其他表中，则需要继承接口 cn.ztessc.service.md.core.IMDQueryService 实现。产品固化主数据特殊查询类和特殊类在同一目录下，注意：特殊查询类bean名需要定义为表名。 **通用导入接口 cn.ztessc.controller.md.sync.SyncMdController** ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2024/08/15/1830A2CE3DAE5FD04C9CB1B7B2AE014B.png) #### 3.接口端接口端主要提供了接口给其他微服务使用，其他微服务可以直接注入该类使用 cn.ztessc.common.service.md.MdDataQueryService ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2024/08/15/1830A2CE3DC4CF12A638B1B7B2AE014D.png)

3.8主数据配置器介绍及升级指引

3.8主数据配置器介绍及升级指引

关于作者

目录