管控策略接口

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

管控策略接口

变更记录

产品版本	更新内容	更新日期
V6.0.1	初始版本	2023年10月28日

1. 功能介绍

提供基础数据管控策略相关功能接口。
kd.bos.servicehelper.basedata.BaseDataServiceHelper
kd.bos.service.IBaseDataService

调用方式：

1、微服务方式直接调用接口
DispatchServiceHelper.invokeService(“kd.bos.service”, “bos”, “IBaseDataService”, “batchAssign”, …)

2、集成管理-api集成-微服务登记方式

3、Java实现类调用

BaseDataServiceHelper

IBaseDataService baseDataService = ServiceFactory.getService(IBaseDataService`.class);

2. API 概览

方法	说明
assign	分配
cancelAssign	取消分配
changeManageRight	管理权转让
changeCtrlStrategy	变更控制策略
individualize	维护个性化
assignQueryByData	分配查询按数据

3. API 详情

3.1 分配

BaseDataResponse assign(String entityId, Long assignOrgId, String appId, Set<Long> dataIds, Set<Long> orgIds)

参数说明：

参数名称	参数	参数类型	是否必传
实体标识	entityId	String	是
分配组织ID	assignOrgId	Long	是
应用ID	appId	String	是
数据ID	dataIds	Set<Long>	是
被分配组织ID	orgIds	Set<Long>	是

返回数据：

BaseDataResponse实体，支持序列化

参数名称	参数	参数类型	备注
是否成功	success	String
错误信息	errorMsg	String	所有都失败，只会返回errorMsg，例如没权限
错误信息详情	result	Map<Long, Map<Long, String>>	key:数据ID value 组织ID-失败原因

3.2 取消分配

CancelAssignResult cancelAssign(String entityId, Set<Long> dataIds, Set<Long> orgIds)

参数说明：

参数名称	参数	参数类型	是否必传
实体标识	entityId	String	是
数据ID	dataIds	set<Long>	是
组织ID	orgIds	set<Long>	是

返回数据：

List<CancelAssignResult> CancelAssignResult实体，支持序列化

参数名称	参数	参数类型
数据ID	dataId	Long
组织ID	orgIds	List<Long>
是否成功	isSuccess	boolean
错误信息	errorMsg	String

3.3 管理权转让

BaseDataResponse changeManageRight(String entityId, Long useOrgId, String appId, Set<Long> dataIds, Long targetOrgId)

参数说明：

参数名称	参数	参数类型	是否必传
实体标识	entityId	String	是
使用组织ID	useOrgId	Long	是
应用ID	appId	String	是
数据ID	dataIds	set<Long>	是
目标组织ID	targetOrgId	Long	是

返回数据：

BaseDataResponse实体，支持序列化

参数名称	参数	参数类型	备注
是否成功	success	String
错误信息	errorMsg	String	管理权转让暂时不支持部分成功，校验不通过都会返回失败
错误信息详情	result	Map<Long, Map<Long, String>>	key:数据ID value 组织ID-失败原因

3.4 变更控制策略

BaseDataResponse changeCtrlStrategy(String entityId, Set<Long> dataIds, String ctrlStrategy, String appId, Long useOrgId)

参数说明：

参数名称	参数	参数类型	是否必传
实体标识	entityId	String	是
数据ID	dataIds	set<Long>	是
目标控制策略	ctrlStrategy	String	是
应用ID	appId	String	是
使用组织ID	useOrgId	Long	是

返回数据：

BaseDataResponse实体，支持序列化

参数名称	参数	参数类型	备注
是否成功	success	String
错误信息	errorMsg	String	变更控制策略暂时不支持部分成功，校验不通过都会返回失败
错误信息详情	result	Map<Long, Map<Long, String>>	key:数据ID value 组织ID-失败原因

3.5 维护个性化

BaseDataResponse individualize(String entityId, Long useOrgId, String appId, Set<Long> dataIds)

参数说明：

参数名称	参数	参数类型	是否必传
实体标识	entityId	String	是
使用组织ID	useOrgId	Long	是
数据ID	dataIds	set<Long>	是
目标控制策略	ctrlStrategy	String	是
应用ID	appId	String	是
使用组织ID	useOrgId	Long	是

返回数据：

BaseDataResponse实体，支持序列化

参数名称	参数	参数类型	备注
是否成功	success	String
错误信息	errorMsg	String	变更控制策略暂时不支持部分成功，校验不通过都会返回失败
错误信息详情	result	Map<Long, Map<Long, String>>	key:数据ID value 组织ID-失败原因

3.6 按数据查询

查询对应的数据都分配给了哪些组织

AssignQueryResponse assignQueryByData(List<Long> dataIds, String entity, Long orgId, String appId)

参数说明：

参数名称	参数	参数类型	是否必传
数据ID	dataIds	set<Long>	是
实体标识	entityId	String	是
使用组织ID	orgId	Long	是
数据ID	dataIds	set<Long>	是
应用ID	appId	String	是

返回数据：

AssignQueryResponse实体，支持序列化

参数名称	参数	参数类型	备注
分配查询数据	data	Map<Long, List<Long>>	K:数据id,V:组织id集合
失败明细	errorMsgInfo	Map<Long, String>	K：失败数据id，V：失败原因，如组织无数据权限
失败消息总体	errorMsg	Map<Long, Map<Long, String>>	全部失败时的返回，如：无查询权限如：无查询权限
操作结果	success	Map<Long, Map<Long, String>>	正常查询：true，校验不通过或者异常false