开发工具
开发工具是面向开发者的租户级维护工具集,提供缓存管理、元数据迁移与删除、密钥生成以及服务端加解密等能力。
概述
从 开发中心 → 开发设置 → 开发工具 进入开发工具页面。该页签对全部开发者可见,所有工具仅作用于当前租户。
页面自上而下提供五个工具:
| 工具 | 作用 |
|---|---|
| 缓存管理工具 | 清除当前租户的所有身份权限缓存 |
| 元数据迁移工具 | 将元数据(对象、页面、数据字典、消息模板)迁移到指定目标应用 |
| 元数据删除工具 | 按类型删除应用、对象、表单、视图、接口或审批流 |
| 生成加密密钥 | 生成一段 Base64 编码的 AES 密钥 |
| CBC 服务端解密 | 使用服务端安全密钥对文本进行 CBC 加密或解密 |
高风险操作
元数据迁移与元数据删除会直接改动或删除平台元 数据,删除操作不可恢复,请在明确影响范围后操作。
缓存管理工具
用于在权限配置变更后强制刷新缓存。点击清除所有身份权限缓存按钮并确认后,当前租户的全部身份权限缓存将被清除,后续请求会重新加载权限数据。
元数据迁移工具
用于把某条元数据挂载到另一个应用下,通常用于调整元数据的归属应用。
配置项
| 配置项 | 说明 |
|---|---|
| 元数据类型 | 迁移的元数据类型,可选对象、页面、数据字典、消息模板 |
| 元数据 | 根据所选类型选择具体的元数据 |
| 目标应用 | 迁移到的目标应用,必填 |
迁移内容
当元数据类型为对象时,会一并迁移该对象下的字段、表单、视图、接口、审批流与流程版本。
元数据删除工具
用于按类型删除元数据。选择删除类型与目标后点击**删除(不可恢复)**并确认。
配置项
| 配置项 | 说明 |
|---|---|
| 删除类型 | 可选应用、对象、表单、视图、接口、审批流 |
| 目标 | 选择或填写对应的元数据标识 |
各类型的删除范围
| 删除类型 | 说明 |
|---|---|
| 应用 | 删除应用及其下的对象、字段、表单、视图、接口、审批流、流程版本、页面、数据字典、消息模板 |
| 对象 | 删除对象及其字段、表单、视图、接口、审批流与流程版本,并移除对象对应的物理表 |
| 表单 / 视图 | 删除该条表单 / 视图 |
| 接口 / 审批流 | 删除该条接口 / 审批流及其流程版本 |
生成加密密钥
用于生成一段 Base64 编码的 32 字节 AES 密钥。点击重新生成生成新密钥,点击复制复制到剪贴板。
CBC 服务端解密
用于使用服务端安全密钥进行 CBC 模式的加解密。在加密文本/结果输入框中输入内容,点击加密得到密文,点击解密还原明文。
下一步
- 系统工具 - 按租户批量执行平台维护脚本
- OpenAPI 文档 - 在线查看开放接口
工具参数与接口明细
以下内容面向技术实现与 AI 检索。
缓存管理工具
| 项目 | 说明 |
|---|---|
| 接口 | POST /api/SystemTool/RemoveAllPermissionsCache |
| 入参 | 无 |
| 作用 | 调用 IPermissionService.RemoveAllPermissionsCacheAsync(),清除当前租户全部身份权限缓存 |
元数据迁移工具
| 项目 | 说明 |
|---|---|
| 接口 | POST /api/SystemTool/MetaDataMigrate |
| 入参 | { Parameters: { MetaDataType, MetaObjectId, MetaPageId, DataDictionaryId, MessageTemplateId, MetaAppId } } |
| 参数名 | 类型 | 含义 | 取值 |
|---|---|---|---|
MetaDataType | string | 迁移类型 | metaObject / metaPage / dataDictionary / messageTemplate |
MetaObjectId | string(GUID) | 对象 ID | MetaDataType = metaObject 时必填 |
MetaPageId | string(GUID) | 页面 ID | MetaDataType = metaPage 时必填 |
DataDictionaryId | string(GUID) | 数据字典 ID | MetaDataType = dataDictionary 时必填 |
MessageTemplateId | string(GUID) | 消息模板 ID | MetaDataType = messageTemplate 时必填 |
MetaAppId | string(GUID) | 目标应用 ID | 必填 |
metaObject 类型迁移时,会同时更新该对象下的 MetaField、MetaForm、MetaView、MetaInterface、MetaWorkflow 以及流程版本 MetaFlowVersion 的 AppId。
{
"Parameters": {
"MetaDataType": "metaObject",
"MetaObjectId": "60ce31a5-2a0d-4946-b699-24da06bdf2db",
"MetaPageId": "",
"DataDictionaryId": "",
"MessageTemplateId": "",
"MetaAppId": "9f1c0b2e-2d3a-4e6f-9c11-0f7a5b8d2e10"
}
}
元数据删除工具
| 项目 | 说明 |
|---|---|
| 接口 | POST /api/SystemTool/MetaDataDelete |
| 入参 | { Parameters: { type, id } } |
| 参数名 | 类型 | 含义 | 取值 |
|---|---|---|---|
type | string | 删除类型 | metaApp / metaObject / metaForm / metaView / metaInterface / metaWorkflow |
id | string(GUID) | 元数据 ID | 对应类型的主键 |
{
"Parameters": {
"type": "metaObject",
"id": "60ce31a5-2a0d-4946-b699-24da06bdf2db"
}
}
生成加密密钥
| 项目 | 说明 |
|---|---|
| 接口 | POST /api/SystemTool/GetSecurityKey |
| 入参 | 无 |
| 返回 | Base64 编码的 32 字节 AES 密钥(AesHelper.GenerateSecretKey(32)) |
CBC 服务端解密
| 接口 | 方法 | 说明 |
|---|---|---|
/api/SystemTool/CbcEncryptByServerSecurityKey | POST | 使用服务端安全密钥(ServerEncryptKey)对 content 做 CBC 加密 |
/api/SystemTool/CbcDecryptByServerSecurityKey | POST | 使用服务端安全密钥对 content 做 CBC 解密 |
| 参数名 | 类型 | 含义 |
|---|---|---|
content | string | 待加密的明文或待解密的密文 |