批量创建多维视图 - BatchCreateView
功能介绍
本接口用于批量为指定的一个或多个M-V模型数据实例创建新的多维视图。多维视图允许用户从不同的预设维度(如设计视图、工艺视图、采购视图等)来观察和管理同一个数据对象。在同一个数据实例下,视图的标识(item)必须是唯一的。
在调用本接口前,请确保目标数据模型满足以下条件:
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
POST /rdm_{identifier}_app/publicservices/api/{modelName}/batchCreateView
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| identifier | 是 | String | 参数解释: 应用的唯一标识。 获取方法请参见获取运行服务清单 - ListEnvs。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| modelName | 是 | String | 参数解释: 数据模型的英文名称。 约束限制: 不涉及。 取值范围: 以大写字母开头,只能包含字母、数字、“_”,且长度为1-60个字符。 默认取值: 不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: IAM用户的token。 获取方法请参见获取IAM用户Token。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| applicationId | 否 | String | 参数解释: 应用ID,用于指定实例所属的应用。 当URL路径中已能明确应用上下文时,此参数可不传。 获取方法请参见获取租户下的应用清单 - ListApps。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| params | 是 | Array of MultiViewModelVersionViewCreateDTO objects | 参数解释: 请求参数对象数组,每个元素包含一个待创建多维视图的版本ID、引用对象及关系复制类型等信息。支持批量操作。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| versionId | 是 | String | 参数解释: 版本对象ID,用于指定待创建视图的基础版本实例。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| item | 是 | ObjectReferenceParamDTO object | 参数解释: 引用对象,用于指定视图绑定的多维视图项。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| workCopyType | 否 | String | 参数解释: 关系的复制类型,用于指定创建多维视图后是否继承原实例的关系实例。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| customLinkSet | 否 | Array of strings | 参数解释: 关系实体名称集合,与workCopyType的值CUSTOM配合使用。 约束限制: 仅当workCopyType为CUSTOM时生效,否则将被忽略。 取值范围: 不涉及。 默认取值: 不涉及。 |
| needSetNull | 否 | Array of strings | 参数解释: 指定不复制的属性名称列表,其值将被设置为null。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| modifier | 否 | String | 参数解释: 更新者账号,用于记录执行创建多维视图操作的用户标识。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| id | 是 | String | 参数解释: 数据实例ID,用于唯一标识引用的数据实例。 获取方法请参见分页查询实例 - ShowFindUsingPost。 约束限制: 不涉及。 取值范围: -9223372036854775808到9223372036854775807的整数。 默认取值: 不涉及。 |
| clazz | 否 | String | 参数解释: 类名,用于指定引用对象的类类型。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| result | String | 参数解释: 请求处理结果状态。 取值范围: |
| data | Array of MultiViewModelViewDTO objects | 参数解释: 请求数据。 取值范围: 不涉及。 |
| errors | Array of strings | 参数解释: 异常信息列表。当result为FAIL时,返回具体的错误描述,包含失败原因及建议处理方式。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: 视图实例的唯一标识。 取值范围: -9223372036854775808到9223372036854775807的整数。 |
| name | String | 参数解释: 视图中文名称。 取值范围: 不涉及。 |
| description | String | 参数解释: 视图描述信息。 取值范围: 不涉及。 |
| className | String | 参数解释: 数据模型的类名称。 取值范围: 不涉及。 |
| creator | String | 参数解释: 视图的创建者账号。 取值范围: 不涉及。 |
| createTime | String | 参数解释: 视图的创建时间,使用UTC+0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。 取值范围: 不涉及。 |
| modifier | String | 参数解释: 视图的更新者账号。 取值范围: 不涉及。 |
| lastUpdateTime | String | 参数解释: 视图最后更新时间。使用UTC+0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。 取值范围: 不涉及。 |
| rdmVersion | Integer | 参数解释: 系统版本号。 取值范围: 不涉及。 |
| rdmDeleteFlag | Integer | 参数解释: 软删除标识。 取值范围: |
| rdmExtensionType | String | 参数解释: 扩展类型,标识数据模型的扩展分类。 取值范围: 不涉及。 |
| kiaguid | String | 参数解释: KIA密级。 取值范围: |
| securityLevel | String | 参数解释: 安全密级。 取值范围: |
| version | String | 参数解释: 版本号,标识该视图的版本标识。 取值范围: 不涉及。 |
| versionCode | Integer | 参数解释: 业务版本内码,用于系统内部版本管理。 取值范围: 不涉及。 |
| iteration | Integer | 参数解释: 迭代版本号,标识该视图在当前版本下的迭代次数。 取值范围: 不涉及。 |
| latest | Boolean | 参数解释: 是否为最新版本。 取值范围: |
| latestVersion | Boolean | 参数解释: 是否为最新修订版本。 取值范围: |
| latestIteration | Boolean | 参数解释: 是否为最新迭代版本。 取值范围: |
| workingCopy | Boolean | 参数解释: 是否已检出。 取值范围: |
| workingState | WorkingState object | 参数解释: 工作状态,包含状态编码、中英文名称及别名。 取值范围: 不涉及。 |
| checkOutUserName | String | 参数解释: 检出人。 取值范围: 不涉及。 |
| checkOutTime | String | 参数解释: 检出时间。使用UTC+0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。 取值范围: 不涉及。 |
| preVersionId | String | 参数解释: 前序版本实例ID。 取值范围: 不涉及。 |
| master | MultiViewModelMasterViewDTO object | 参数解释: 主对象。 取值范围: 不涉及。 |
| branch | MultiViewModelBranchViewDTO object | 参数解释: 分支对象。 取值范围: 不涉及。 |
| item | MultiViewItemViewDTO object | 参数解释: 绑定的多视图(Item)信息,包含Item的基本属性及租户信息。 取值范围: 不涉及。 |
| tenant | TenantViewDTO object | 参数解释: 租户信息。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| alias | String | 参数解释: 工作状态别名,用于系统内部的状态标。 取值范围: 不涉及。 |
| cnName | String | 参数解释: 工作状态中文名称。 取值范围: 不涉及。 |
| code | String | 参数解释: 工作状态编码。 取值范围: 不涉及。 |
| enName | String | 参数解释: 工作状态英文名称。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| className | String | 参数解释: 类名。 取值范围: 不涉及。 |
| createTime | String | 参数解释: 创建时间。使用UTC+0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。 取值范围: 不涉及。 |
| creator | String | 参数解释: 创建者账号。 取值范围: 不涉及。 |
| id | String | 参数解释: 唯一标识。 取值范围: -9223372036854775808到9223372036854775807的整数。 |
| lastUpdateTime | String | 参数解释: 最后更新时间。使用UTC+0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。 取值范围: 不涉及。 |
| modifier | String | 参数解释: 更新者账号。 取值范围: 不涉及。 |
| rdmDeleteFlag | Integer | 参数解释: 软删除标识。 取值范围: |
| rdmExtensionType | String | 参数解释: 扩展类型。 取值范围: 不涉及。 |
| rdmVersion | Integer | 参数解释: 系统版本。 取值范围: 不涉及。 |
| tenant | TenantViewDTO object | 参数解释: 租户信息。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: 唯一标识。 取值范围: -9223372036854775808到9223372036854775807的整数。 |
| className | String | 参数解释: 类名。 取值范围: 不涉及。 |
| createTime | String | 参数解释: 创建时间。使用UTC+0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。 取值范围: 不涉及。 |
| creator | String | 参数解释: 创建者账号。 取值范围: 不涉及。 |
| lastUpdateTime | String | 参数解释: 最后更新时间。使用UTC+0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。 取值范围: 不涉及。 |
| modifier | String | 参数解释: 更新者账号。 取值范围: 不涉及。 |
| rdmDeleteFlag | Integer | 参数解释: 软删除标识。 取值范围: |
| rdmExtensionType | String | 参数解释: 扩展类型。 取值范围: 不涉及。 |
| rdmVersion | Integer | 参数解释: 系统版本。 取值范围: 不涉及。 |
| tenant | TenantViewDTO object | 参数解释: 租户信息。 取值范围: 不涉及。 |
| version | String | 参数解释: 版本号。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| className | String | 参数解释: 类名。 取值范围: 不涉及。 |
| createTime | String | 参数解释: 创建时间。使用UTC+0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。 取值范围: 不涉及。 |
| creator | String | 参数解释: 创建者账号。 取值范围: 不涉及。 |
| id | String | 参数解释: 唯一标识。 取值范围: -9223372036854775808到9223372036854775807的整数。 |
| rdmDeleteFlag | Integer | 参数解释: 软删除标识。 取值范围: |
| rdmExtensionType | String | 参数解释: 扩展类型。 取值范围: 不涉及。 |
| rdmVersion | Integer | 参数解释: 系统版本。 取值范围: 不涉及。 |
| modifier | String | 参数解释: 更新者账号。 取值范围: 不涉及。 |
| lastUpdateTime | AnyType | 参数解释: 最后更新时间。使用UTC+0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。 取值范围: 不涉及。 |
| tenant | TenantViewDTO object | 参数解释: 租户信息。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| className | String | 参数解释: 租户对象的类名。 取值范围: 不涉及。 |
| code | String | 参数解释: 租户编码,用于多租户场景下的租户唯一标识。 取值范围: 不涉及。 |
| createTime | String | 参数解释: 租户对象的创建时间。使用UTC+0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。 取值范围: 不涉及。 |
| creator | String | 参数解释: 租户对象的创建者账号。 取值范围: 不涉及。 |
| dataSource | String | 参数解释: 租户使用的数据源名称,用于多租户数据隔离。 取值范围: 不涉及。 |
| description | String | 参数解释: 租户描述信息。 取值范围: 不涉及。 |
| disableFlag | Boolean | 参数解释: 租户失效标识,用于标识租户是否已失效。 取值范围: |
| id | String | 参数解释: 租户的唯一标识。 取值范围: -9223372036854775808到9223372036854775807的整数。 |
| kiaguid | String | 参数解释: 租户KIA密级。 取值范围: 不涉及。 |
| lastUpdateTime | String | 参数解释: 租户的最后更新时间。使用UTC+0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。 取值范围: 不涉及。 |
| modifier | String | 参数解释: 租户的更新者账号。 取值范围: 不涉及。 |
| name | String | 参数解释: 租户中文名称。 取值范围: 不涉及。 |
| nameEn | String | 参数解释: 租户英文名称。 取值范围: 不涉及。 |
| rdmDeleteFlag | Integer | 参数解释: 软删除标识。 取值范围: |
| rdmExtensionType | String | 参数解释: 租户扩展类型。 取值范围: 不涉及。 |
| rdmVersion | Integer | 参数解释: 租户对象的系统版本号。 取值范围: 不涉及。 |
| securityLevel | String | 参数解释: 租户安全密级,用于标识租户信息的安全等级。 取值范围: |
| tenant | TenantViewDTO object | 参数解释: 租户信息,表示当前租户的父租户信息。 取值范围: 不涉及。 |
请求示例
示例:批量基于指定版本创建多视图新视图
版本ID(versionId)为1的版本创建新视图,指定操作人(modifier)为test1,并传入关联的多视图项(item)信息,其中项ID(id)为1,类名(clazz)为MultiViewItem。
使用test1的用户根据versionId=1的版本创建新的视图1。
POST https://dme.cn-north-4.huaweicloud.com/rdm_04219627d6794f37ae26e8aba250415d_app/publicservices/api/MultiViewModel/batchCreateView
{
"applicationId" : "04219627d6794f37ae26e8aba250415d",
"params" : [ {
"versionId" : "1",
"modifier" : "test1",
"item" : {
"id" : "1",
"clazz" : "MultiViewItem"
}
} ]
} 响应示例
状态码:200
OK,表示请求成功。
{
"result": "SUCCESS",
"data": [
{
"id": "610123340111159296",
"creator": "test1",
"modifier": "test1",
"createTime": 2024-02-19T06:38:10.406+0000,
"lastUpdateTime": 2024-02-19T06:56:43.319+0000,
"rdmVersion": 1,
"rdmDeleteFlag": 0,
"rdmExtensionType": "MultiViewModel",
"tenant": {
"id": "-1",
"creator": "xdmAdmin",
"modifier": "xdmAdmin",
"createTime": 2023-12-01T01:25:21.000+0000,
"lastUpdateTime": 2023-12-01T01:25:21.000+0000,
"rdmVersion": 1,
"rdmDeleteFlag": 0,
"rdmExtensionType": "Tenant",
"tenant": null,
"className": "Tenant",
"name": "basicTenant",
"description": "默认租户",
"kiaguid": null,
"securityLevel": "internal",
"nameEn": null,
"code": "basicTenant",
"disableFlag": false,
"dataSource": "DefaultDataSource"
},
"className": "MultiViewModel",
"name": "多视图管理",
"description": "多视图管理",
"kiaguid": "18409de0386546f8af4bb6c1dc5cf50f",
"securityLevel": "internal",
"master": {
"id": "2",
"creator": "test1",
"modifier": "test1",
"createTime": 2024-02-19T06:38:10.419+0000,
"lastUpdateTime": 2024-02-19T06:56:43.319+0000,
"rdmVersion": 1,
"rdmDeleteFlag": 0,
"rdmExtensionType": "MultiViewModelMaster",
"tenant": {
"id": "-1",
"creator": "xdmAdmin",
"modifier": "xdmAdmin",
"createTime": 2023-12-01T01:25:21.000+0000,
"lastUpdateTime": 2023-12-01T01:25:21.000+0000,
"rdmVersion": 1,
"rdmDeleteFlag": 0,
"rdmExtensionType": "Tenant",
"tenant": null,
"className": "Tenant",
"name": "basicTenant",
"description": "默认租户",
"kiaguid": null,
"securityLevel": "internal",
"nameEn": null,
"code": "basicTenant",
"disableFlag": false,
"dataSource": "DefaultDataSource"
},
"className": "MultiViewModelMaster"
},
"branch": {
"id": "601060080799981568",
"creator": "test1",
"modifier": "test1",
"createTime": 2024-02-19T06:38:10.464+0000,
"lastUpdateTime": 2024-02-19T06:56:43.319+0000,
"rdmVersion": 1,
"rdmDeleteFlag": 0,
"rdmExtensionType": "MultiViewModelBranch",
"tenant": {
"id": "-1",
"creator": "xdmAdmin",
"modifier": "xdmAdmin",
"createTime": 2023-12-01T01:25:21.000+0000,
"lastUpdateTime": 2023-12-01T01:25:21.000+0000,
"rdmVersion": 1,
"rdmDeleteFlag": 0,
"rdmExtensionType": "Tenant",
"tenant": null,
"className": "Tenant",
"name": "basicTenant",
"description": "默认租户",
"kiaguid": null,
"securityLevel": "internal",
"nameEn": null,
"code": "basicTenant",
"disableFlag": false,
"dataSource": "DefaultDataSource"
},
"className": "MultiViewModelBranch",
"version": "A"
},
"latest": true,
"latestIteration": true,
"versionCode": 1,
"iteration": 1,
"version": "A",
"latestVersion": true,
"workingCopy": false,
"workingState": {
"code": "CHECKED_IN",
"cnName": "已检入",
"enName": "checked in",
"alias": "CHECKED_IN"
},
"checkOutUserName": null,
"checkOutTime": null,
"preVersionId": "1",
"item": {
"id": "1",
"creator": "test1",
"modifier": "test1",
"createTime": 2024-02-19T06:38:10.464+0000,
"lastUpdateTime": 2024-02-19T06:56:43.319+0000,
"rdmVersion": 1,
"rdmDeleteFlag": 0,
"rdmExtensionType": "MultiViewItem",
"tenant": {
"id": "-1",
"creator": "xdmAdmin",
"modifier": "xdmAdmin",
"createTime": 2023-12-01T01:25:21.000+0000,
"lastUpdateTime": 2023-12-01T01:25:21.000+0000,
"rdmVersion": 1,
"rdmDeleteFlag": 0,
"rdmExtensionType": "Tenant",
"tenant": null,
"className": "Tenant",
"name": "basicTenant",
"description": "默认租户",
"kiaguid": null,
"securityLevel": "internal",
"nameEn": null,
"code": "basicTenant",
"disableFlag": false,
"dataSource": "DefaultDataSource"
},
"className": "MultiViewItem"
}
}
],
"errors": []
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK,表示请求成功。 |
错误码
请参见错误码。