在介绍受控基础资料开发流程前，先来几个灵魂拷问。

什么是管控策略？

在一个视图范围内，定义一些规则，把基础资料的使用权共享或分配给其他组织使用。这里的规则就是管控策略（也叫控制策略）。

更多关于管控策略的知识，可参考文章：要想搞懂“基础数据管控”，再不看这篇就晚了。

管控策略有什么用？

管控策略可用于确定基础资料的使用权和使用方式，如哪些组织能使用哪些基础资料，以什么规则来共享或分配。

什么是受控基础资料？

被规则限定的带有创建组织的基础资料，就是受控基础资料。

了解什么是受控基础资料后，该如何选择受控基础资料模板呢？

目前总共有三种受控基础资料模板：基础资料带组织模板(bos_baseorgtpl)、分组基础资料带组织模板(bos_basegrouporgtpl)、树形基础资料带组织模板(bos_basetreeorgtpl)。

基础资料带组织模板：普通带组织的基础资料，例如税率、银行账户、供应商地点等。
分组基础资料带组织模板：包含引用另一个基础资料作为分类的基础资料，例如物料、供应商、仓库等。
树形基础资料带组织模板：包含上下级关系的基础资料，例如：费用项目、现金流量项目、项目分类等。

选择受控基础资料模板的具体路径为：【开发服务云】→【基对象模板】→【基础资料】。

基础资料模板示例

在开发之前，我们首先要根据基础资料的特性，对开发的基础资料进行初步的模型选择。根据实际业务场景，选择合适的模板继承。

接下来，我们开启“受控基础资料”的开发之旅。

整体步骤如下：

1. 继承模板，创建基础资料

2. 配置“受控基础资料”必填参数

3. 配置“基础数据管控策略”

4. 配置“控制规则”

5. 配置“字段规则”

6. 调用“管控策略接口”

下面，小编为大家逐一介绍每个步骤的具体操作内容。

1 开发步骤

Step1 继承模板，创建基础资料

在新建基础资料时，选择一个带组织的模板，通过继承模板的方式创建基础资料。

Step2 配置“受控基础资料”必填参数

根据模板生成资料后，按照格式填写表名，另外需要注意：将创建组织字段、控制策略字段要设置为新增、修改、审核、提交锁定。

接下来，设置【权限控制】参数。

权限控制设置

【权限控制主字段】：选择“创建组织”。选择主业务组织会联动更新该字段。

【权限发布应用】（非必填项）：如果该基础资料需要发布到元数据所在应用以外的应用，需要填写该项，才能在其他应用里去分应用授权，否则校验权限的时候只会校验元数据所在的应用权限。

关于如何配置【权限发布应用】，可参考文章：少侠，你遗漏了一项配置--“权限发布应用”、少侠，你遗漏了一项配置--“权限发布应用”（续集）。

Step3 配置“基础数据管控策略”

接下来需要将新增的基础资料配置到“基础数据管控策略”。

为什么需要配置呢？因为基础资料的管控策略都是基于组织视图的基础上，去实现各种数据的分配和共享。管控策略 = 基础资料 + 视图 + 策略，三者具备才是完整的，缺一不可。

配置“基础数据管控策略”的路径为：【系统服务云】→【基础服务】→【管控策略】→【基础数据管控策略】。

配置基础数据管控策略

【基础资料】：这里的基础资料必须是已经挂在启用应用下的，并且是继承了模板的基础资料才能过滤出来。

【默认控制策略】：共有5种策略可选：全局共享、管控范围内共享、自由分配、逐级分配、私有。

关于控制策略的更多知识，可参考文章：要想搞懂“基础数据管控”，再不看这篇就晚了。

【控制视图】：共有3种视图可选：主数据视图、业务视图、自定义视图。

注意：此处如果要选择业务视图，需要设置基础资料的创建组织的职能，例如如果设置为核算职能，那么该资料选择控制视图时，只可以选择核算职能相关的视图，如果不设置，则只能选择主数据视图相关的视图。一般来说要跨职能使用的资料，例如客户，供应商，物料这种，需要选择主数据视图。会计科目，现金流项目则只在核算职能的组织中使用，所以设置创建组织职能为核算组织，选择控制视图为核算组织默认视图即可。

【插件】(非必填项)：提供业务干预管控策略操作的一系列接口类，详情请看后文的步骤6-管控策略接口

Step4 配置“控制规则”

【控制规则】属于非必填项。

【控制规则】表格里的“控制策略”字段，是控制组织新增基础数据时所用的策略，如果没有配置，采用基础信息里的默认控制策略。

配置控制规则

引入基础资料时，按照配置的控制策略引入，EXCEL模板上填写的控制策略没有意义，不需要填写，会在新增引入时，取默认或者创建组织设置的策略。

如果【控制规则】的“控制策略”配置了具体创建组织，则只有这些组织可以新增资料，没有配置到里面的其他组织将无法新增基础数据。

【控制规则】为空的情况下，当前资料控制视图上的所有组织都可以新增资料，且使用默认控制策略。列表里的“控制策略”和默认控制策略同时存在时，优先取控制规则上组织设置的策略。

报错提示示例

Step5 配置“字段规则”

【字段规则】也属于非必填项。

控制基础资料分配到其他组织的时候，哪些字段可以查看或者修改。

配置字段规则

字段规则应用案例：

（1）将“付款条件”设为不共享、“结算方式”可修改。

设置字段规则

（2）“下一代金蝶云苍穹测试2024”创建数据，并分配给“环*集团”。

创建数据并分配组织

效果显示：

（1）在创建组织“下一代金蝶云苍穹测试2024”下，“付款条件”、“结算方式”均可见。

（2）在“环球集团”个性化后，“付款条件”不可见，“结算方式”可以修改。

可能会有用户在设置规则时没有超链接（即无法在【基础数据管控策略】→【控制规则】中设置字段规则），这是怎么回事呢？

这是因为设置规则需要在【开发平台】→【基础数据管控字段配置】(bd_ctrlstgyfieldcfg)列表，新增某个基础资料的某些字段的配置。如果列表没有配置，设置规则就不会有超链接。该基础资料字段默认都是可共享、不可修改。

Step6 调用“管控策略接口”

目前管控策略接口有两类：

一类是可以在基础数据管控策略配置一个插件，实现基础资料接口，插件名称为kd.bos.servicehelper.basedata.IBaseDataCtrlPlugin。

对基础资料的分配、变更控制策略、管理权转让时，会调用实现了该接口的类。对业务进行校验判断后，返回布尔类型的值，控制是否能执行这些操作。由业务逻辑干预管控策略，以满足相应的业务场景。

另一类是通用类，路径如下：

kd.bos.servicehelper.basedata.BaseDataServiceHelper

该通用类主要提供一些通用场景的接口，比如查某组织可以使用哪些基础资料、基础资料个性化、获取基础资料的控制视图、分配、检查基础数据是否受控、检查基础数据是否存在重复等。

2 管控策略相关表介绍

受控基础资料相关的表，主要有三张：登记表、排除表、使用范围表。在元数据保存的时候生成相关表，但前提是必须继承了受控基础资料模板。

登记表：记录分配、使用关系。表名 = 基础资料主表+ usereg后缀，例如供应商t_bd_supplierusereg。

排除表：当基础资料做个性化后，需要排除掉原来的那条数据，此时需要记录一条组织ID和基础资料ID的记录。表名=基础资料主表 + exc后缀，例如供应商t_bd_supplierexc。

使用范围表：记录某个组织能使用哪些ID基础资料，业务需要重点关注这张表。表名=基础资料主表 + _u后缀，例如供应商t_bd_supplier_u。

还有一点要注意的是，“全局共享”的数据不存在这张表，只存在基础资料的主表。所以，调用获取基础资料过滤接口返回的QFlilter过滤条件是status =‘C’ and ctrlstrategy = ‘5’or id in (111,222,333)。

3 常见问题和解决方案

Q1：我误继承了受控基础资料模板，但是我不需要用管控策略，怎么办？

A1：禁用模板的表单插件、操作插件、列表插件。

Q2：我以前继承了受控基础资料模板，当时没想好需不需做组织隔离，现在想用管控策略了，需要做什么呢？

A2：首先，排查现有数据，fmasterid是否为0，控制策略是否为空，如果有则需要修复数据。

用物料举个例子：

修复fmasterid为0的数据：update t_bd_material set fmasterid = fid where fmasterid = 0；

修复控制策略为逐级分配(这里按需修改)：update material set fctrlstrategy =’1’ where fctrlstrategy = ‘ ‘。

注：fctrlstrategy的数据字典如下所示：

“1” 代表逐级分配
“2” 代表自由分配
“5” 代表全局共享
“6” 代表管控范围共享
“7” 代表私有

接着，检查继承的模板表单插件、列表插件、操作插件是否都开启。

确认数据、插件没问题之后，将基础资料配置到基础数据管控策略。配置完成后，测试新增、分配、分配查询功能是否正常，几张相关表里的数据是否保存。

Q3：我继承了受控基础资料模板，保存元数据也成功了，但是没有生成usereg、exc、_u这三张表，是什么原因？

A3：可能是表名定义过长，超过19位，加上这三张表的后缀，超过了25个字符，而苍穹表名定义不能超过25位。

Q4：引入数据的时候，显示“找不到有权创建的业务组织，请检查功能权限或控制规则是否配置正确。”的报错信息，是什么原因？

A4：有两种可能：（1）没有授权，没有这个组织的基础资料的新增、查询权限；（2）没有配置基础数据管控策略的具体组织。

Q5：怎么获取一个组织能使用哪些基础资料？

A5：调用接口获取QFilter ，再用QFilter获取基础资料。相关代码如下：

// entityID:基础资料标识  orgID:组织ID
kd.bos.servicehelper.basedata.BaseDataServiceHelper.getBaseDataFilter(String entityID, Long orgID)
eg:
QFilter qFilter = BaseDataServiceHelper.getBaseDataFilter(entityID, orgID);
QFilter[]filters = new QFilter[]{qFilter};
DynamicObject[] objs = BusinessDataServiceHelper.load(entityID, selectProperties, filters);

Q6：我直接插件修改了基础资料的创建组织，在新的创建组织列表中，查不到数据，只能在原来的组织中查到，是什么原因？

A6：修改创建组织，必须使用列表中“管理-管理权转让”的功能。因为数据是从使用登记表_u查出来的，直接修改创建组织，没有经过接口去维护使用登记表的数据，所以查不出来。

修改控制策略也是一样的，不能直接修改，必须通过“管理-变更控制策略”去修改。

Q7：列表中的业务组织为什么有些组织显示不出来？

A7：有两种可能：（1）没有该组织的权限；（2）该组织非CU组织，仅限于控制视图是主数据视图的情况，业务视图所有的组织单元必须是CU组织。

注：CU指的是控制单元，只有控制单元才可以显示在列表的业务组织中，才能去做增删查改等其他操作。非CU就是非管控单元，只有数据的查询使用权。

#往期推荐#

# 用“一块布料”教你秒懂“基础数据个性化”

# 要想搞懂“基础数据管控”，再不看这篇就晚了

# “普通基础资料”如何改造为“受控基础资料”？

# 凡事要有个度—管理员管辖范围的权限管控

更多精彩内容，“码”上了解！↓

必须要了解的“受控基础资料开发流程”

必须要了解的“受控基础资料开发流程”

恭喜您！