简要描述:

  • 批量保存接口使用post请求,必须确保主键、batO存在

    接口版本:

版本号 制定人 制定日期 修订日期
v3 陈碧贵 2019-01-20 xxxx-xx-xx

请求URL:

  • {mkey} 对应mapper文件
  • {resField} 对应 {mkey}里面 responseField键

请求地址参数:

参数名 是否必须 类型 说明
_pidsuffix string 主键编号前缀,配合雪花ID使用,如DEP”

请求方式:

  • POST

请求头:

参数名 是否必须 类型 说明
XownerId string 项目唯一ID,对应bo_project {ownerId}
XsysId string 所属系统 对应 bo_system 表
XtenantId string 所属租户 对应 owner_bo_tenant 里面 ti_tenant_info 表
XuserFromFirstShareId string 一级分享用户ID, bo_user user_id
XuserFromSecondShareId string 二级分享用户ID, bo_user user_id
XverifyApi string 加密规则encryptByDES(`${newGuid()}
XfilterAreaCode string 行政区编码, 对应 bo_sys_area area_code
Content-Type: string application/json; charset=utf-8 请求类型
Authorization string 当前用户认证信息,通过登录接口获取 Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6

请求参数:

[
{
        depName: "只修改",
        batO: "U",
        depId: "bt-deve-bt-20200-3329b1f8-0f68-4a6b",
},
{
        depName: "只新增",
        batO: "I",
        depId: "bt-deve-bt-20200-3329b1f8-0f68-4a6b",
    },
{
        depName: "修改失败新增",
        batO: "UI",
        depId: "bt-deve-bt-20200-3329b1f8-0f68-4a6b",
    },
{
        depName: "只删除",
        batO: "D",
        depId: "bt-deve-bt-20200-3329b1f8-0f68-4a6b",
    }
]
参数名 是否必须 类型 说明
depId string 主键唯一标识值 (名称根据实际进行调整)
_nodejs string common-data 对应/Config/AppNodeJs/Plugins/fn- common-data.js, 通过nodejs插件,对响应结果进行二次处理 common-data 普通数据(小写驼峰)common-data-under 普通数据下划线
_queues string 主键唯一标识值 (名称根据实际进行调整) {ownerId}

返回示例:

正确时返回:

{
        code: 0,
        success: true,
        data:[{
           id:null
        }],
        message:
          "批量保存:总数7条,新增成功0条,新增失败0条,删除成功0条,删除失败0条,修改成功7条,修改失败0条。",
      }

错误时返回:

{
    "code": 0,
    "message": ""
    "error":{
      errorCode:null,
      errorText:null
    }
    "success": false,
}

返回参数说明:

参数名 类型 说明
success bool true 表示数据请求成功(跟code=0一致),调用者优先使用
code int true 表示数据请求成功(跟code=0一致),调用者优先使用
data object 响应的结果数据 name:显示的名称 value:交互的数据库中值 id:通常和value一致,树形结构需要 parentId: 父节点,树形结构需要level:等级,树形结构需要
cacheType string redis/sqlite/local 数据来源缓存 的类型(便于开发调试和性能优化)
cacheDate date 最后数据获取时间
文档更新时间: 2023-12-11 08:10   作者:admin