注册自定义配置项

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

注册自定义配置项

变更记录

产品版本	更新内容	更新日期
V5.0.025	注册自定义配置项流程优化	2023年7月27日

1 简介

1.1 功能介绍

行业或现场的实施人员可以将现场特殊或二开的配置项注册到实施配置中心，使用标准提供的权限管控，打包传输等功能。

1.2 应用场景

针对现场二次开发的配置项如果也需要使用实施配置中心进行管理。

1.3 系统路径

【基础服务云】→【实施配置中心】→【基础配置中心列表】

2 主要操作

2.1 操作步骤

在基础配置中心列表新增，填入基本信息：

步骤1：选择配置表单，选择页面实体后，会带出配置项编码、配置项名称以及列表表单类型

步骤2：选择是否受控，若受控会自动带出验权页面

步骤3：选择是否允许添加到传输包，选择对应的引入引出方式

步骤4：选择是否需要支持全量一键打包，如果需要，是否有需要排除的数据，可以选择录入过滤条件

步骤5：若该配置项需要集成方案，可在集成方案列表中添加

2.2 关键字段说明

字段	说明
配置表单	页面实体，表示当前配置项是哪一个
配置项分组	该配置项属于哪个菜单分组，一般默认只允许在末级菜单进行新增配置项
依赖配置项	多选基础资料，选择当前的这个基础配置依赖了基础配置中心里面哪些内容，在同步时如果一个包里面有多个配置项的数据，这些配置项之间有依赖关系的话，需要根据这个依赖关系来决定同步的先后顺序。选择后会自动计算依赖级次
依赖基础资料	当一个传输包中存在多个配置项时，会根据依赖级次决定同步的先后的顺序，级次小的先进行同步
依赖级次	当一个传输包中存在多个配置项时，会根据依赖级次决定同步的先后的顺序，级次小的先进行同步
是否系统预置	系统出厂预置的数据是不允许修改的，可以进行禁用启用
备注	简要的备注和说明信息
列表表单类型	如果为标准的单据或者基础资料，设置的是列表表单模板类型（可在开发平台切换到列表右侧配置查看），标准列表对应标识为bos_list，标准树列表对应的标识为bos_templatetreelist，树形列表对应的标识为bos_treelist；如果存在自定义的列表表单模板，可设置为自定义并填写自定义的列表表单模板标识
列表页面入口参数	部分单据需要特殊处理时，可在此选择输入对应的参数。
是否受控	启用受控后，如果当前环境不是源环境，则该基础配置的权限项会受到管控
验权页面	针对动态表单或者特殊表单，页面验权表单和展示表单不是同一个，比如凭证模板列表界面（编码：ai_vchtemplate_configs）属于动态表单，他不是直接在动态表单授权，而是在实体对象凭证模板(编码：ai_vchtemplate)做权限授予和验证。如果要对基础配置项做权限管控，必须配置正确的验权页面，验权页面不正确，系统无法正常对单据新增、修改权限进行管控。
支持添加到传输包	启用该参数，该配置项的数据可添加到数据包中进行上传下载和在线传输。启用该参数，必需要选择引入引出的方式。
添加传输自定义页面标识	配置项列表页面中“添加传输”功能如需要特殊设置，可通过配置自定义页面标识（动态表单）进行扩展处理。如凭证模板，在添加传输前需要先指定引入核算组织再进行添加传输包。
引入引出方式	系统提供了四种引入引出方式：一是标准产品的excel引入引出，如果该配置项的列表界面可以进行引入引出则可以选择该方式。在添加数据包时，后台会调用标准产品的引出功能，使用全量模板，将数据引出成excel。在数据包同步时，标准产品会调用标准产品的引入功能，以id为唯一键，将excel引入到系统中，引入模式为更新或新增引入，更新引入时，如果有分录，则会删除分录的所有数据，再引入excel中的分录数据。二是插件引入引出：有些配置项的引入引出是自己代码实现的应封装出了工具类，可以自己写个插件兼容业务的导入导出逻辑，用于添加到数据包和同步时进行调用，选择该方式，需要填入二开的插件，具体参考插件引入引出详解。三是动态对象序列化：原理是将配置或单据的动态对象DynamicObject序列化成Map，再转成json文件。同步时再将json反过来解析成动态对象，执行对应实体的保存操作。这种方式在导出时同时导出了基础资料的id和编码，如果环境之间基础资料的id可能不一致，可以选择用id进行匹配或用编码进行匹配，可以在初始化参数中进行设置该参数。这种导入导出方式有一定的限制：1.当前配置项是标准单据或基础资料；2.以id为唯一键；3.不支持弹性域字段、附件、分录或子分录中的多选基础资料字段的导入导出；4.实体能够通过标准save操作保存(有的在界面插件上写了保存的业务逻辑)；四是微服务引入引出：如果配置项的导入导出需要用插件实现，并且也有了对应的工具类，则可以提供引入引出的微服务接口注册到配置项中，配置项导入导出的时候调用对应的微服务进行处理，具体参考基础配置中心微服务开发引入引出功能使用指南
引入引出模板	跨环境传输时数据传输格式，设置为空时默认为“全量引入模板”
引入数据更新方式	通过excel引入操作的数据处理方式，设置为空时默认为“更新已有数据并添加新数据”，可参考人工处理时引入界面设置
数据替换规则的唯一值	用于识别数据为覆盖或新增。设置为空时默认为“内码”，可参考人工处理时引入界面设置
引入是否覆盖分录	为引入OverrideEntry参数，关闭时引入操作将通过分录内码进行匹配进行新增或者修改；开启时引入操作将先清除所有分录后再用excel表格中分录进行新增，此操作会删除表格中为匹配的数据，存在数据丢失风险，请慎重选择！！！
允许一键打包	一键打包是提供给管理员使用的便捷功能，可以快速选择配置项导出全部数据打成一个传输包，该选项勾选后可以允许一键打包，否则会进行提示
一键打包过滤条件	一键打包过滤数据的条件，满足条件的数据才会被打包，条件为空的话默认就是所有的数据都会导出
集成方案列表	可在该分录添加集成方案
帮助信息	可以根据需要录入配置项的一些说明，录好后，可以在列表界面被其他人员查看