v1.0.0

0.公共

POST 业务分类查询

POST /common/classify

功能描述：根据筛选条件获取系统页面筛选条件码表数据，

涉及页面：审计数据查询页面展现业务分类标签数据

实现逻辑：

涉及到的表：系统码表
数据关联条件：无
数据过滤条件：编码分组(CODE_TYPE)、父编码键(PRAENT_CODE_KEY)
注：父编码键非必传
传：按照父编码和分组编码定位码值信息
不传：则直接匹配编码分组
数据分组：无
数据排序：字段排序

返回数据：

系统码表

编码分组字段（codeType）
编码键字段（codeKey）
编码值字段（codeValue）
字段排序字段（orderId）
父编码分组字段（parentCodeType）
父编码键字段（parentCodeKey）
表名字段（tableName）

Body 请求参数

{
  "type": "object",
  "properties": {
    "codeType": {
      "type": "string",
      "description": "编码分组->BUSI_TYPE(业务类型),DATA_DOMAIN(业务归属域),INTER_DUTY(运营单位),OBJ_LEVEL_CODE(所属层),ORIGINAL_SYSTEM(来源系统),STATUS(状态),SUBJECT_CHILD_DOMAIN(主题子域),SUBJECT_DOMAIN(主题域),SERV_TYPE(服务模式)"
    },
    "parentCodeKey": {
      "type": "string",
      "description": "父编码键\t",
      "nullable": true
    }
  },
  "required": [
    "codeType",
    "parentCodeKey"
  ]
}

请求参数

名称	位置	类型	必选	说明
body	body	object	false	none
» codeType	body	string	true	编码分组->BUSI_TYPE(业务类型),DATA_DOMAIN(业务归属域),INTER_DUTY(运营单位),OBJ_LEVEL_CODE(所属层),ORIGINAL_SYSTEM(来源系统),STATUS(状态),SUBJECT_CHILD_DOMAIN(主题子域),SUBJECT_DOMAIN(主题域),SERV_TYPE(服务模式)
» parentCodeKey	body	string¦null	true	父编码键

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": [
    {
      "codeType": "1",
      "codeKey": "39",
      "codeValue": "35",
      "orderId": 66,
      "parentCodeType": "37",
      "parentCodeKey": "66",
      "tableName": "品把住清"
    },
    {
      "codeType": "1",
      "codeKey": "8",
      "codeValue": "19",
      "orderId": 88,
      "parentCodeType": "38",
      "parentCodeKey": "36",
      "tableName": "度大治育"
    },
    {
      "codeType": "1",
      "codeKey": "27",
      "codeValue": "95",
      "orderId": 60,
      "parentCodeType": "15",
      "parentCodeKey": "86",
      "tableName": "你候水金复步包"
    }
  ]
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» msg	string	true	none	none
» data	[object]	true	none	none
»» codeType	string	true	none	none
»» codeKey	string	true	none	none
»» codeValue	string	true	none	none
»» orderId	integer	true	none	none
»» parentCodeType	string	true	none	none
»» parentCodeKey	string	true	none	none
»» tableName	string	true	none	none

GET 获取角色接口

GET /common/current/role

功能描述：获取角色信息接口

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": "role_id_xxxxx"
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» msg	string	true	none	none
» data	string	true	none	none

GET 数据标签列查询

GET /common/label

功能描述：根据状态获取数据标签码表

涉及页面：审计数据查询页面展现数据标签

实现逻辑：

涉及到的表：标签表
数据关联条件：无
数据过滤条件：状态
数据分组：无
数据排序：无

返回数据：

标签表

标签编码（labelId）
标签名称（labelValue）
上级标签编码（parentLabelId）
状态（sts）
操作人（optStaffId）
操作时间（optDate）

sql：

查询标签表

select
label_id,
label_value,
parent_label_id,
sts,
operator_id,
operate_date
from
bdam_label
where sts = #{sts,jdbcType=VARCHAR}
and parent_label_id = #{parentLabelId,jdbcType=VARCHAR}

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": [
    {
      "labelId": "66",
      "labelValue": "proident cupidatat dolore magna",
      "parentLabelId": "30",
      "sts": "ut dolore aute",
      "optStaffId": "13",
      "optDate": "1982-09-04"
    },
    {
      "labelId": "66",
      "labelValue": "proident cupidatat dolore magna",
      "parentLabelId": "30",
      "sts": "ut dolore aute",
      "optStaffId": "13",
      "optDate": "1982-09-04"
    }
  ]
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» msg	string	true	none	none
» data	[object]	true	none	none
»» labelId	string	true	none	none
»» labelValue	string	true	none	none
»» parentLabelId	string	true	none	none
»» sts	string	true	none	none
»» optStaffId	string	true	none	none
»» optDate	string	true	none	none

GET 数据标签树查询

GET /common/label/tree

功能描述：根据状态获取数据标签码表

涉及页面：审计数据查询页面展现数据标签

实现逻辑：

涉及到的表：标签表
数据关联条件：无
数据过滤条件：状态
数据分组：无
数据排序：无

返回数据：

标签表

标签编码（labelId）
标签名称（labelValue）
上级标签编码（parentLabelId）
状态（sts）
操作人（optStaffId）
修改状态（flag）
操作时间（optDate）
子标签列表（list<>）

sql：

查询标签表 -- 函数
select
label_id,
label_value,
parent_label_id,
sts,
false flag，
operator_id,
operate_date
from
bdam_label
where sts = #{sts,jdbcType=VARCHAR}
and parent_label_id = #{parentLabelId,jdbcType=VARCHAR}

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": [
    {
      "labelId": "95",
      "labelValue": "dolore magna Ut",
      "parentLabelId": "32",
      "sts": "mollit",
      "optStaffId": "3",
      "optDate": "1973-02-13",
      "flag": false,
      "childList": [
        {
          "labelId": "91",
          "labelValue": "nisi enim ut velit",
          "parentLabelId": "86",
          "sts": "pariatur reprehenderit in officia exercitation",
          "optStaffId": "53",
          "optDate": "1977-07-06",
          "flag": false,
          "childList": [
            {
              "labelId": "97",
              "labelValue": "velit nostrud",
              "parentLabelId": "30",
              "sts": "sint Duis consectetur enim",
              "optStaffId": "34",
              "optDate": "1989-10-16",
              "flag": false
            }
          ]
        },
        {
          "labelId": "41",
          "labelValue": "enim",
          "parentLabelId": "66",
          "sts": "consequat eiusmod velit",
          "optStaffId": "80",
          "optDate": "2016-08-13",
          "flag": false,
          "childList": [
            {
              "labelId": "32",
              "labelValue": "enim consequat id do ut",
              "parentLabelId": "10",
              "sts": "commodo",
              "optStaffId": "95",
              "optDate": "1985-05-26",
              "flag": false
            },
            {
              "labelId": "59",
              "labelValue": "aliquip deserunt",
              "parentLabelId": "91",
              "sts": "officia",
              "optStaffId": "55",
              "optDate": "1999-04-16",
              "flag": false
            },
            {
              "labelId": "58",
              "labelValue": "Ut dolore laborum Excepteur",
              "parentLabelId": "68",
              "sts": "reprehenderit culpa sunt",
              "optStaffId": "63",
              "optDate": "1997-02-19",
              "flag": false
            },
            {
              "labelId": "39",
              "labelValue": "in laboris laborum eiusmod",
              "parentLabelId": "2",
              "sts": "aliquip",
              "optStaffId": "63",
              "optDate": "1970-02-26",
              "flag": false
            }
          ]
        },
        {
          "labelId": "48",
          "labelValue": "sint Ut",
          "parentLabelId": "40",
          "sts": "ut enim Excepteur",
          "optStaffId": "24",
          "optDate": "1999-07-07",
          "flag": false,
          "childList": [
            {
              "labelId": "49",
              "labelValue": "non dolor nulla ullamco fugiat",
              "parentLabelId": "35",
              "sts": "nulla ad",
              "optStaffId": "41",
              "optDate": "2006-02-11",
              "flag": false
            },
            {
              "labelId": "84",
              "labelValue": "consequat ad",
              "parentLabelId": "36",
              "sts": "aliqua",
              "optStaffId": "94",
              "optDate": "1993-09-21",
              "flag": false
            },
            {
              "labelId": "31",
              "labelValue": "enim Lorem fugiat",
              "parentLabelId": "76",
              "sts": "ea nulla",
              "optStaffId": "83",
              "optDate": "2011-03-16",
              "flag": false
            }
          ]
        },
        {
          "labelId": "90",
          "labelValue": "sed irure enim culpa exercitation",
          "parentLabelId": "44",
          "sts": "sed sint",
          "optStaffId": "30",
          "optDate": "2013-10-05",
          "flag": false,
          "childList": [
            {
              "labelId": "86",
              "labelValue": "in",
              "parentLabelId": "38",
              "sts": "dolor exercitation non aute",
              "optStaffId": "52",
              "optDate": "2007-12-31",
              "flag": false
            },
            {
              "labelId": "2",
              "labelValue": "magna do id",
              "parentLabelId": "63",
              "sts": "qui",
              "optStaffId": "90",
              "optDate": "1985-11-08",
              "flag": false
            },
            {
              "labelId": "83",
              "labelValue": "ex sit",
              "parentLabelId": "27",
              "sts": "mollit",
              "optStaffId": "66",
              "optDate": "1980-01-20",
              "flag": false
            }
          ]
        },
        {
          "labelId": "97",
          "labelValue": "Ut ullamco",
          "parentLabelId": "38",
          "sts": "et pariatur ea consequat",
          "optStaffId": "92",
          "optDate": "1996-12-26",
          "flag": false,
          "childList": [
            {
              "labelId": "42",
              "labelValue": "quis",
              "parentLabelId": "96",
              "sts": "Lorem ut",
              "optStaffId": "79",
              "optDate": "1987-02-23",
              "flag": false
            }
          ]
        }
      ]
    },
    {
      "labelId": "25",
      "labelValue": "reprehenderit irure deserunt Lorem",
      "parentLabelId": "35",
      "sts": "sed qui id cupidatat in",
      "optStaffId": "11",
      "optDate": "1978-01-25",
      "flag": false,
      "childList": [
        {
          "labelId": "18",
          "labelValue": "aute irure dolor ut",
          "parentLabelId": "88",
          "sts": "ea cillum",
          "optStaffId": "47",
          "optDate": "1990-10-10",
          "flag": false,
          "childList": [
            {
              "labelId": "62",
              "labelValue": "ipsum reprehenderit",
              "parentLabelId": "40",
              "sts": "irure enim",
              "optStaffId": "29",
              "optDate": "2012-01-03",
              "flag": false
            },
            {
              "labelId": "7",
              "labelValue": "officia magna commodo",
              "parentLabelId": "24",
              "sts": "incididunt minim amet dolore",
              "optStaffId": "59",
              "optDate": "2007-07-12",
              "flag": false
            },
            {
              "labelId": "35",
              "labelValue": "deserunt consectetur ex anim",
              "parentLabelId": "37",
              "sts": "adipisicing enim anim proident exercitation",
              "optStaffId": "39",
              "optDate": "1971-01-18",
              "flag": false
            }
          ]
        },
        {
          "labelId": "72",
          "labelValue": "eu ad sed",
          "parentLabelId": "22",
          "sts": "ea dolore aliquip ad voluptate",
          "optStaffId": "99",
          "optDate": "1990-05-17",
          "flag": false,
          "childList": [
            {
              "labelId": "52",
              "labelValue": "laboris",
              "parentLabelId": "12",
              "sts": "qui",
              "optStaffId": "59",
              "optDate": "2012-10-13",
              "flag": false
            },
            {
              "labelId": "83",
              "labelValue": "mollit fugiat",
              "parentLabelId": "18",
              "sts": "ullamco laborum est occaecat dolor",
              "optStaffId": "65",
              "optDate": "1978-08-22",
              "flag": false
            },
            {
              "labelId": "81",
              "labelValue": "veniam proident in aute",
              "parentLabelId": "29",
              "sts": "sint occaecat sed anim incididunt",
              "optStaffId": "30",
              "optDate": "2013-08-04",
              "flag": false
            },
            {
              "labelId": "39",
              "labelValue": "eu officia occaecat",
              "parentLabelId": "5",
              "sts": "Ut officia",
              "optStaffId": "70",
              "optDate": "2012-01-28",
              "flag": false
            }
          ]
        },
        {
          "labelId": "15",
          "labelValue": "nulla eu officia proident sit",
          "parentLabelId": "26",
          "sts": "nisi commodo qui",
          "optStaffId": "84",
          "optDate": "1985-10-07",
          "flag": false,
          "childList": [
            {
              "labelId": "45",
              "labelValue": "consectetur sunt et veniam ipsum",
              "parentLabelId": "25",
              "sts": "sunt sit qui",
              "optStaffId": "31",
              "optDate": "2014-01-11",
              "flag": false
            },
            {
              "labelId": "77",
              "labelValue": "velit",
              "parentLabelId": "38",
              "sts": "officia consequat",
              "optStaffId": "65",
              "optDate": "1989-02-03",
              "flag": false
            }
          ]
        },
        {
          "labelId": "3",
          "labelValue": "tempor minim voluptate culpa Lorem",
          "parentLabelId": "73",
          "sts": "aute laboris nisi ex labore",
          "optStaffId": "72",
          "optDate": "1991-05-02",
          "flag": false,
          "childList": [
            {
              "labelId": "89",
              "labelValue": "occaecat",
              "parentLabelId": "98",
              "sts": "nisi",
              "optStaffId": "89",
              "optDate": "2020-05-31",
              "flag": false
            },
            {
              "labelId": "25",
              "labelValue": "dolore dolore in nisi pariatur",
              "parentLabelId": "6",
              "sts": "fugiat adipisicing in est",
              "optStaffId": "92",
              "optDate": "1987-12-28",
              "flag": false
            }
          ]
        },
        {
          "labelId": "41",
          "labelValue": "sed",
          "parentLabelId": "12",
          "sts": "occaecat anim",
          "optStaffId": "59",
          "optDate": "1998-04-01",
          "flag": false,
          "childList": [
            {
              "labelId": "31",
              "labelValue": "quis",
              "parentLabelId": "44",
              "sts": "ex sit cillum",
              "optStaffId": "84",
              "optDate": "2001-06-08",
              "flag": false
            },
            {
              "labelId": "58",
              "labelValue": "in quis sit ex",
              "parentLabelId": "11",
              "sts": "cupidatat incididunt sed non",
              "optStaffId": "48",
              "optDate": "1971-12-25",
              "flag": false
            },
            {
              "labelId": "48",
              "labelValue": "consequat Ut",
              "parentLabelId": "49",
              "sts": "Ut ad",
              "optStaffId": "21",
              "optDate": "1971-03-04",
              "flag": false
            },
            {
              "labelId": "37",
              "labelValue": "ullamco sunt cupidatat",
              "parentLabelId": "88",
              "sts": "ea deserunt adipisicing ut",
              "optStaffId": "58",
              "optDate": "1977-08-04",
              "flag": false
            },
            {
              "labelId": "82",
              "labelValue": "sunt",
              "parentLabelId": "39",
              "sts": "anim aliquip",
              "optStaffId": "13",
              "optDate": "1997-03-13",
              "flag": false
            }
          ]
        }
      ]
    }
  ]
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» msg	string	true	none	none
» data	[object]	true	none	none
»» labelId	string	false	none	none
»» labelValue	string	false	none	none
»» parentLabelId	string	false	none	none
»» sts	string	false	none	none
»» optStaffId	string	false	none	none
»» optDate	string	false	none	none
»» flag	string	true	none	none
»» childList	[object]	false	none	none
»»» labelId	string	false	none	none
»»» labelValue	string	false	none	none
»»» parentLabelId	string	false	none	none
»»» sts	string	false	none	none
»»» optStaffId	string	false	none	none
»»» optDate	string	false	none	none
»»» flag	string	true	none	none
»»» childList	[object]	false	none	none
»»»» labelId	string	false	none	none
»»»» labelValue	string	false	none	none
»»»» parentLabelId	string	false	none	none
»»»» sts	string	false	none	none
»»»» optStaffId	string	false	none	none
»»»» optDate	string	false	none	none
»»»» flag	string	true	none	none

GET 获取业务分类统计数

GET /common/business/{level}

功能描述 `查询接口数据按业务类型统计数`

涉及页面：

用于【审计信息视图】页面展现【数据总数】部分数据
用于【数据目录】页面展现【业务分类】部分数据

表操作`查询`

实现逻辑

涉及到的表：资产表，系统码表
数据关联条件
系统码表.编码分组 = 业务分类分组值 AND
资产表.业务分类 = 系统码表.编码键
数据过滤条件：资产表.所属层编码 = ${level}
数据分组：资产表.业务分类
数据排序：无

返回数据

业务分类总数：资产表总数
业务分类键：系统码表.编码键
业务分类名：系统码表.编码值

请求参数

名称	位置	类型	必选	说明
level	path	string	true	所属层编码: ALL-全部查询 OD-接口层 DM-模型层 DA-应用层

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": {
    "key1": {
      "text": "财务",
      "num": 76
    },
    "key2": {
      "text": "合同",
      "num": 93
    },
    "key3": {
      "text": "客户",
      "num": 71
    }
  }
}

{
  "code": "-1",
  "msg": "调用异常"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» msg	string	true	none	none
» data	object	true	none	none
»» key1	object	true	none	none
»»» text	string	true	none	none
»»» num	integer	true	none	none
»» key2	object	true	none	none
»»» text	string	true	none	none
»»» num	integer	true	none	none
»» key3	object	true	none	none
»»» text	string	true	none	none
»»» num	integer	true	none	none

POST 文件上传

POST /file/upload

文件上传至服务器并录入附件表
返回附件id

Body 请求参数

type: object
properties:
  file:
    type: string
    description: 附件
    format: binary
required:
  - file

请求参数

名称	位置	类型	必选	说明
body	body	object	false	none
» file	body	string(binary)	true	附件

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": "1222"
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» msg	string	true	none	none
» data	string	true	none	附件id

1.审计信息视图

GET 获取审计信息视图统计数

GET /audit/count

功能描述： `用于【审计信息视图】页面展现【数据总数】部分数据`

表操作：`查询`

实现逻辑：

涉及到的表：资产表
数据关联条件：无
数据过滤条件：无
数据分组：所属层编码
数据排序：无

返回数据：

数据总数：对应层总数之和
对应层总数：资产表总数

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": {
    "sum": 69,
    "od": 63,
    "dm": 51,
    "da": 18
  }
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» msg	string	true	none	none
» data	object	false	none	none
»» sum	integer	true	none	none
»» od	integer	true	none	none
»» dm	integer	true	none	none
»» da	integer	true	none	none

GET 获取接口层业务归属域统计数

GET /audit/domain

功能描述：`用于【审计信息视图】页面展现【接口层业务归属域】部分数据`

表操作：`查询`

实现逻辑：

涉及到的表：资产表，系统码表
数据关联条件：
系统码表.编码分组 = 业务归属域分组值 AND
资产表.业务归属域 = 系统码表.编码键
数据过滤条件：资产表.所属层编码 = 'OD'
数据分组：资产表.业务归属域
数据排序：系统码表.字段排序

返回数据：

业务归属域总数：资产表总数
业务归属域编码键：系统码表.编码键

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": {
    "B": 6,
    "M": 91,
    "O": 5
  }
}

{
  "code": "-1",
  "msg": "调用失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» msg	string	false	none	none
» data	object	false	none	none
»» B域	integer	true	none	none
»» M域	integer	true	none	none
»» O域	integer	true	none	none

GET 获取接口层业务归属域来源系统统计数

GET /audit/system/{domain}

功能描述：`用于【审计信息视图】页面展现【接口层业务归属域】-【来源系统】部分数据`

表操作：`查询`

实现逻辑：

涉及到的表：资产表，系统码表
数据关联条件：
系统码表.编码分组 = 来源系统分组值 AND
资产表.业务归属域 = 系统码表.编码键
数据过滤条件：
系统码表.所属层编码 = 'OD' AND
系统码表.业务归属域 = ${domain} AND
系统码表.父编码键 = ${domain}
数据分组：资产表.来源系统
数据排序：系统码表.字段排序

返回数据：

来源系统总数：资产表总数
来源系统尖：系统码表.编码键

请求参数

名称	位置	类型	必选	说明
domain	path	string	true	业务归属域编码 B-B域 M-M域 O-O域

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": {
    "key1": {
      "text": "CRM系统",
      "num": 58
    },
    "key2": {
      "text": "报账系统",
      "num": 69
    },
    "key3": {
      "text": "预算系统",
      "num": 41
    }
  }
}

{
  "code": "-1",
  "msg": "调用失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» msg	string	true	none	none
» data	object	true	none	none
»» key1	object	true	none	none
»»» text	string	true	none	none
»»» num	integer	true	none	none
»» key2	object	true	none	none
»»» text	string	true	none	none
»»» num	integer	true	none	none
»» key3	object	true	none	none
»»» text	string	true	none	none
»»» num	integer	true	none	none

2.接口数据视图

GET 接口数据统计

GET /interface/statistics

功能描述：`用于【接口信息视图】页面展现统计数据`

表操作：`查询`

实现逻辑：

涉及到的表：资产表
数据关联条件：无
数据过滤条件：
数据总数：资产表.所属层编码 = OD
近30天新增：资产表.所属层编码 = OD AND 资产表.状态!=3
近30天删除：资产表.所属层编码 = OD AND 资产表.状态=3
数据分组：无
数据排序：
数据总数：不需要排序
近30天新增：ORDER BY 创建时间.
近30天删除：ORDER BY 创建时间.

返回数据

数据总数：统计接口总数
近30天新增：统计近30天新增的接口总数
近30天删除：统计近30天删除的接口总数

返回示例

成功

{
  "code": "0",
  "data": {
    "count": "1",
    "countAdd": "2",
    "countDelete": "3"
  }
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» data	object	true	none	none
»» count	string	true	none	数据总数
»» countAdd	string	true	none	近30天新增
»» countDelete	string	true	none	近30天删除

POST 接口数据查询

POST /interface/list/{pageNo}/{pageSize}

功能描述：`用于【接口信息视图】页面展现查询数据`

表操作：`查询`

实现逻辑：

涉及到的表：
元数据表，资产表
数据关联条件：
元数据表.元数据编码 = 资产表.元数据编码
数据过滤条件：
资产表.业务分类
资产表.业务主题域
资产表.业务归属域
资产表.来源系统
资产表.数据状态
资产表.数据覆盖单位
关键字
数据分组：无
数据排序
资产表.创建时间

返回数据

接口表英文名称：元数据表.接口表英文名称
接口表中文名称：接口元数据信息表.接口表中文名称
接口编码：接口元数据信息表.接口编码
业务主题域：资产表.业务主题域
二级主题域：资产表.二级主题域
业务归属域：资产表.业务归属域
来源系统：资产表.来源系统
数据覆盖单位：资产表.数据覆盖单位
是否结构化数据：资产表.是否结构化数据
最早数据时间：元数据表.最早数据时间
数据生成时：资产表.数据生成时间
存储周期：元数据表.存储周期
数据状态：资产表.数据状态

Body 请求参数

{
  "type": "object",
  "properties": {
    "busiType": {
      "type": "string",
      "description": "业务分类（资产表）"
    },
    "subjectDomainCode": {
      "type": "string",
      "description": "业务主题域（资产表）"
    },
    "dataDomain": {
      "type": "string",
      "description": "业务归属域（资产表）"
    },
    "originalSystem": {
      "type": "string",
      "description": "来源系统（资产表）"
    },
    "status": {
      "type": "string",
      "description": "数据状态（资产表）"
    },
    "dataScope": {
      "type": "string",
      "description": "数据覆盖单位（资产表）"
    },
    "keyword": {
      "type": "string",
      "description": "关键字"
    }
  },
  "required": [
    "busiType",
    "subjectDomainCode",
    "dataDomain",
    "originalSystem",
    "status",
    "dataScope",
    "keyword"
  ]
}

请求参数

名称	位置	类型	必选	说明
pageNo	path	string	true	none
pageSize	path	string	true	none
body	body	object	false	none
» busiType	body	string	true	业务分类（资产表）
» subjectDomainCode	body	string	true	业务主题域（资产表）
» dataDomain	body	string	true	业务归属域（资产表）
» originalSystem	body	string	true	来源系统（资产表）
» status	body	string	true	数据状态（资产表）
» dataScope	body	string	true	数据覆盖单位（资产表）
» keyword	body	string	true	关键字

返回示例

成功

{
  "code": "0",
  "data": {
    "rows": [
      {
        "code": "57",
        "interName": "便导种类",
        "interId": "76",
        "subjectDomainCode": "74",
        "subjectChildDomain": "r.djv@qq.com",
        "dataDomain": "g.hlfuehqr@qq.com",
        "originalSystem": "quis adipisicing",
        "dataScope": "Excepteur amet dolore ut adipisicing",
        "structFlag": "sit labore quis in Lorem",
        "earliestDataTime": "2012-01-29 19:11:30",
        "createDate": "1982-06-18",
        "storageCycle": "reprehenderit et",
        "status": "nulla quis fugiat in voluptate"
      }
    ],
    "total": "consequat"
  }
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» data	object	true	none	none
»» rows	[object]	true	none	none
»»» code	string	true	none	元数据表.接口表英文名称
»»» name	string	true	none	元数据表.接口表中文名
»»» assetCode	string	true	none	资产表.资产编码
»»» interId	string	true	none	接口元数据信息表.接口编码
»»» subjectDomainCode	string	true	none	资产表.业务主题域
»»» subjectChildDomain	string	true	none	资产表.二级主题域
»»» dataDomain	string	true	none	资产表.业务归属域
»»» originalSystem	string	true	none	资产表.来源系统
»»» dataScope	string	true	none	资产表.数据覆盖单位
»»» structFlag	string	true	none	资产表.是否结构化数据
»»» earliestDataTime	string	true	none	元数据表.最早数据时间
»»» createDate	string	true	none	资产表.数据生成时间
»»» storageCycle	string	true	none	元数据表.存储周期
»»» status	string	true	none	资产表.数据状态
»» total	string	true	none	none

3.审计数据查询

GET 开放数据接口

GET /catalog/count

功能描述：`用于【审计数据管理-资产详情页面】页面展现开放数据部分（现阶段不使用状态进行条件筛选）`

表操作：`查询`

实现逻辑：

涉及到的表：资产表
数据关联条件：无
数据过滤条件：无
数据分组：无
数据排序：无

返回数据：

资产数量（assetNum）

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": {
    "assetNum": 53
  }
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» msg	string	true	none	none
» data	object	true	none	none
»» assetNum	integer	true	none	开放数据（个）

4.数据目录

GET 数据详情查询

GET /catalog/detail/{assetId}

功能描述：`用于【数据目录】页面展现列表数据`

表操作：`查询`

实现逻辑：

涉及到的表：
元数据表，元数据表结构，资产表
数据关联条件：
元数据表.元数据编码 = 资产表.元数据编码 AND 元数据表.元数据编码 = 元数据表结构.元数据编码
数据过滤条件：
资产表.资产id
数据分组：无
数据排序：无

返回数据：
数据来源：资产表.数据来源
数据编码：资产表.数据编码
最早数据时间：元数据表.最早数据时间
最晚数据时间：元数据表.最晚数据时间
服务模式：资产表.服务模式
数据管理单位：资产表.数据管理单位
数据覆盖范围：元数据表.数据覆盖范围
表结构：按元数据编码查询表结构

请求参数

名称	位置	类型	必选	说明
assetId	path	string	true	元数据编码

返回示例

成功

{
  "code": "0",
  "data": {
    "originalSystem": "irure Lorem ut et laborum",
    "dateRange": "irure occaecat Excepteur aute",
    "servType": "sed aliqua ipsum ullamco eu",
    "managerDuty": "fugiat occaecat Ut dolore consequat",
    "dataScope": "in",
    "fields": [
      {
        "fieldName": "离心支说厂导",
        "fieldCode": "70"
      },
      {
        "fieldName": "飞常共",
        "fieldCode": "18"
      },
      {
        "fieldName": "条节满面技",
        "fieldCode": "69"
      }
    ]
  }
}

"{\r\n\"code\":\"-1\"\r\n\"msg\":\"失败\"\r\n}"

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» data	object	true	none	none
»» originalSystem	string	true	none	资产表.数据来源
»» assetCode	string	true	none	资产表.数据编码
»» earliestDataTime	string	true	none	元数据表.最早数据时间
»» recentDataTime	string	true	none	元数据表.最晚数据时间
»» servType	string	true	none	资产表.服务模式
»» managerDuty	string	true	none	资产表.数据管理单位
»» dataScope	string	true	none	元数据表.数据覆盖范围
»» fields	[object]	true	none	表结构
»»» fieldName	string	true	none	字段中文名（元数据表结构）
»»» fieldCode	string	true	none	字段英文名（元数据表结构）

POST 数据目录查询

POST /catalog/list/{pageNo}/{pageSize}

功能描述：`用于【数据目录】页面展现列表数据`

表操作：`查询`

实现逻辑：

涉及到的表：
元数据表，元数据表结构，资产表
数据关联条件：
元数据表.元数据编码 = 资产表.元数据编码 AND
元数据表.元数据编码 = 元数据表结构.元数据编码
数据过滤条件：
资产表.业务分类，关键字
数据分组：无
数据排序
资产表.创建时间

返回数据：
表名：元数据表.表名
中文表名：元数据表.中文表名
资产描述：资产表.资产描述
关键字匹配上的字段：like到的字段用逗号拼接

Body 请求参数

{
  "type": "object",
  "properties": {
    "busiType": {
      "type": "string",
      "description": "业务分类（资产表）"
    },
    "keyword": {
      "type": "string",
      "description": "关键字"
    },
    "labelIds": {
      "type": "string",
      "description": "标签集合，逗号分隔"
    }
  },
  "required": [
    "busiType",
    "keyword",
    "labelIds"
  ]
}

请求参数

名称	位置	类型	必选	说明
pageNo	path	string	true	none
pageSize	path	string	true	none
body	body	object	false	none
» busiType	body	string	true	业务分类（资产表）
» keyword	body	string	true	关键字
» labelIds	body	string	true	标签集合，逗号分隔

返回示例

成功

{
  "code": "0",
  "data": {
    "rows": [
      {
        "code": "99",
        "name": "王行住快",
        "assetMemo": "nisi",
        "fields": "voluptate"
      }
    ],
    "total": "1"
  }
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» data	object	true	none	none
»» rows	[object]	true	none	none
»»» code	string	true	none	元数据表.表名
»»» name	string	true	none	元数据表.中文表名
»»» assetMemo	string	true	none	资产表.资产描述
»»» fields	string	true	none	关键字匹配上的字段
»»» labelIds	string	true	none	标签id集合
»»» labelNames	string	true	none	标签名称集合
»» total	string	true	none	none

5.审计数据管理

GET 资产数据统计接口

GET /manager/statistics

功能描述：`用于【审计数据管理】页面展现【数据总数、未注册、未上线、已上线】部分数据`

表操作：`查询`

实现逻辑：

涉及到的表：资产表
数据关联条件：无
数据过滤条件：无
数据分组：资产状态【status】
数据排序：无

返回数据：

数据总数：资产表总数
未注册：资产状态【status】= 0
未上线：资产状态【status】= 1
已上线：资产状态【status】= 2

返回示例

成功

{
  "code": "0",
  "msg": "处理成功",
  "data": {
    "all": "1000",
    "unregistered": "200",
    "offOnline": "500",
    "online": "300"
  }
}

{
  "code": "-1",
  "msg": "处理失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	业务状态
» msg	string	true	none	消息
» data	object	false	none	如果code为0时，才存在
»» all	string	true	none	资产总数
»» unregistered	string	true	none	未注册资产数
»» notOnline	string	true	none	未上线资产数
»» online	string	true	none	已上线资产数

GET 资产数据导出excel接口

GET /manager/export

功能描述：用于【审计数据管理】页面展现导出资产列表数据

表操作：`查询`

实现逻辑：与查询列表逻辑一致

请求参数

名称	位置	类型	必选	说明
sortType	query	string	false	排序类型，前端可以不传，升序:asc 降序:desc
busiType	query	string	false	业务分类：FW,服务 FWSY,服务使用 HT,合同 KF,客服 KH,客户 QT,其他 T1,4G T10,武器 T11,原神 T12,游戏 T13,音乐 T14,特朗普 T15,美国内战 T16,新冠 T17,华为 T18,手机 T19,小米 T2,量子 T20,苹果 T21,蔚来 T22,一汽 T3,光子 T4,云计算 T5,大数据 T7,石油 T8,电能 T9,核能 ZW,账务 ZY,资源
dataDomain	query	string	false	业务归属域：B,B域 M,M域 O,O域
originalSystem	query	string	false	来源系统：4G,4Gboss AC,内审云自助分析平台 AD,能力开放平台 AM,资产管理 AMA,资产手机APP AMC,资产管理系统 BB,BBOSS BD,本地业务系统 BO,省公司BOSS系统 BP,省公司经分系统 C0,一级客服 CC,一证五号 CD,卡号资源 CI,CMIOT系统 CM,合同系统 CP,集中数据存储共享平台 CR,省公司CRM系统 DM,终端管理系统 DS,决策支持 DZ,定制终端 E0,一级电渠 EAM,资产系统 EAS,报账系统 EBS,银企系统 ECP,电商基地 ELB,电子招投标系统 ERP,ERP系统 ERP1,集中化ERP系统 ES,政企EBOSS系统 FMS,资金系统 FS,内容计费结算系统 GB,政企经分系统 GW,上报网关 HBL,海波龙系统 HDB,HADOOP三期二（回传TD库） HDBN,HADOOP三期二（非回传主库） HDO,HADOOP三期一 HDO2,HADOOP二期二 HDT,HADOOP租户域 HK,香港万众 HY,行研系统 I0,国际局清算 I1,国际局结算系统 IB,国际业务系统 IC,互联网公司系统 ICB,物联网内容计费 IM,国际彩信 IMS,国际彩信结算系统 IN,国际信令系统 IO,物联网公司系统 IOP,一级IOP IPS,IP子系统 IR,国际漫游BOSS系统 IS,国际短信 ISM,国际短信结算系统 IT,智能终端综合管理系统 IWS,国际wlan结算系统 JK,中移金科系统 JQR,久其系统 JY,集中运营系统 M0,全网用户敏感信息访问日志集中管控平台 MA,MAS平台 MB,魔百和系统 MDM,主数据 MP,中间号平台 MPP,信息港MPP MPP1,哈池MPP MRS,移动转售系统 N0,网络域用户敏感信息访问日志集中管控平台 NB,新业务营销 NR,国际非漫游系统 OC,外呼系统 OL,在线公司系统 P1,PBOSS PTM,一级终端管理系统 RBS,影像系统 S0,四期清算 SCA,沉默客户激活系统 Silent customer activation system SCM,供应链系统 SE,国际公司系统 SP,垃圾短信黑白名单 STAT,综合统计 SY,苏研系统 T0,三期清算 TBM,预算系统 TD,TD数据库 URP,统一充值支付中心 VGOP,一级VGOP XI,融合通信管控平台 XY,逍遥系统 XZ,携号转网系统 ZP,发票系统
keyWord	query	string	false	关键字

返回示例

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

POST 批量上线或下线

POST /manager/batchHandel

上线
update bdam_asset t set t.STATUS='上线码值' where ASSET_ID in ();
下线
update bdam_asset t set t.STATUS='下线码值' where ASSET_ID in ();

Body 请求参数

{
  "type": "object",
  "properties": {
    "optType": {
      "type": "string",
      "description": "操作类型 \nonline-上线\noffline-下线"
    },
    "assetIds": {
      "type": "string",
      "description": "多个id用逗号分割"
    }
  },
  "required": [
    "optType",
    "assetIds"
  ]
}

请求参数

名称	位置	类型	必选	说明
body	body	object	false	none
» optType	body	string	true	操作类型
» assetIds	body	string	true	多个id用逗号分割

详细说明

» optType: 操作类型
online-上线
offline-下线

返回示例

成功

{
  "code": "0",
  "msg": "成功"
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» msg	string	true	none	none

POST 查询资产列表

POST /manager/list/{pageNo}/{pageSize}

功能描述：`用于【审计数据管理】页面展现【数据总数、未注册、未上线、已上线】部分数据`

表操作：`查询`

实现逻辑：

涉及到的表：资产表【bdam_asset】、元数据表【bdam_meta_table】、元数据表结构【bdam_meta_table_struct】
数据关联条件：
资产表.元数据编码 = 元数据表.元数据编码
数据过滤条件：
- 资产表->业务分类【BUSI_TYPE】
- 资产表->数据状态【STATUS】
- 资产表->业务归属域【DATA_DOMAIN】
- 资产表->来源系统【ORIGINAL_SYSTEM】
- like关键字匹配：
  - 资产表：
    - 资产编码
    - 资产描述
  - 元数据表：
    - 中文名称
    - 英文名称
  - 元数据表：
    - 字段描述
数据分组：无
数据排序：元数据表【bdam_meta_table】-> 存储量【DATA_SIZE】- 根据排序类型参数：sortType

返回数据：

资产ID: 资产表【bdam_asset】-> ASSET_ID
对象英文名称：元数据表【bdam_meta_table】-> CODE
对象中文名称：元数据表【bdam_meta_table】-> NAME
来源系统：资产表【bdam_asset】-> ORIGINAL_SYSTEM
所属层：资产表【bdam_asset】-> OBJ_LEVEL_CODE
业务主题域：资产表【bdam_asset】-> SUBJECT_DOMAIN_CODE
最早数据时间：元数据表【bdam_meta_table】-> EARLIEST_DATA_TIME
最晚数据时间：元数据表【bdam_meta_table】-> RECENT_DATA_TIME
存储量：元数据表【bdam_meta_table】-> DATA_SIZE
数据运维单位：资产表【bdam_asset】-> INTER_DUTY
数据状态：资产表【bdam_asset】-> STATUS

Body 请求参数

{
  "type": "object",
  "properties": {
    "busiType": {
      "type": "string",
      "description": "业务分类:HT,合同KF,客服KH,客户FW,服务FWSY,服务使用ZW,账务ZY,资源QT,其他"
    },
    "status": {
      "type": "string",
      "description": "数据状态：0,未注册 1,未上线 2,已上线 3,已下线"
    },
    "dataDomain": {
      "type": "string",
      "description": "业务归属域B-B域M-M域O-O域"
    },
    "originalSystem": {
      "type": "string",
      "description": "来源系统EAS,报账系统FMS,资金系统CM,合同系统EAM,资产系统EBS,银企系统ERP,ERP系统ERP1,集中化ERP系统JQR,久其系统TBM,预算系统MDM,主数据STAT,综合统计HBL,海波龙系统ZP,发票系统RBS,影像系统ELB,电子招投标系统SCM,供应链系统BP,省公司经分系统CR,省公司CRM系统BO,省公司BOSS系统GB,政企经分系统ES,政企EBOSS系统OC,外呼系统OL,在线公司系统SE,国际公司系统HK,香港万众IC,互联网公司系统MB,魔百和系统IO,物联网公司系统DM,终端管理系统ECP,电商基地HY,行研系统SY,苏研系统JK,中移金科系统GW,上报网关IN,国际信令系统IT,智能终端综合管理系统AC,内审云自助分析平台URP,统一充值支付中心IB,国际业务系统DZ,定制终端FS,内容计费结算系统MRS,移动转售系统P1,PBOSSBB,BBOSSCI,CMIOT系统ICB,物联网内容计费T0,三期清算IPS,IP子系统IWS,国际wlan结算系统IMS,国际彩信结算系统ISM,国际短信结算系统I1,国际局结算系统E0,一级电渠CC,一证五号IR,国际漫游BOSS系统C0,一级客服PTM,一级终端管理系统XZ,携号转网系统AD,能力开放平台S0,四期清算MP,中间号平台M0,全网用户敏感信息访问日志集中管控平台N0,网络域用户敏感信息访问日志集中管控平台SCA,沉默客户激活系统 Silent customer activation system4G,4GbossI0,国际局清算AMC,资产管理系统AMA,资产手机APPNR,国际非漫游系统CD,卡号资源AM,资产管理NB,新业务营销SP,垃圾短信黑白名单DS,决策支持MA,MAS平台CP,集中数据存储共享平台IS,国际短信IM,国际彩信JY,集中运营系统BD,本地业务系统XI,融合通信管控平台IOP,一级IOPVGOP,一级VGOPXY,逍遥系统TD,TD数据库MPP,信息港MPPMPP1,哈池MPPHDB,HADOOP三期二（非回传主库）HDB,HADOOP三期二（回传TD库）HDO,HADOOP三期一HDO2,HADOOP二期二HDT,HADOOP租户域"
    },
    "sortType": {
      "type": "string",
      "description": "排序类型-asc  or desc",
      "default": "asc or desc"
    },
    "keyWord": {
      "type": "string",
      "description": "关键字"
    },
    "subjectDomainCode": {
      "type": "string",
      "description": "业务主题域"
    }
  },
  "required": [
    "sortType",
    "subjectDomainCode"
  ],
  "description": "查询条件"
}

请求参数

名称	位置	类型	必选	说明
pageNo	path	string	true	当前页码
pageSize	path	string	true	每页显示数据量
body	body	object	false	none
» busiType	body	string	false	业务分类:HT,合同KF,客服KH,客户FW,服务FWSY,服务使用ZW,账务ZY,资源QT,其他
» status	body	string	false	数据状态：0,未注册 1,未上线 2,已上线 3,已下线
» dataDomain	body	string	false	业务归属域B-B域M-M域O-O域
» originalSystem	body	string	false	来源系统EAS,报账系统FMS,资金系统CM,合同系统EAM,资产系统EBS,银企系统ERP,ERP系统ERP1,集中化ERP系统JQR,久其系统TBM,预算系统MDM,主数据STAT,综合统计HBL,海波龙系统ZP,发票系统RBS,影像系统ELB,电子招投标系统SCM,供应链系统BP,省公司经分系统CR,省公司CRM系统BO,省公司BOSS系统GB,政企经分系统ES,政企EBOSS系统OC,外呼系统OL,在线公司系统SE,国际公司系统HK,香港万众IC,互联网公司系统MB,魔百和系统IO,物联网公司系统DM,终端管理系统ECP,电商基地HY,行研系统SY,苏研系统JK,中移金科系统GW,上报网关IN,国际信令系统IT,智能终端综合管理系统AC,内审云自助分析平台URP,统一充值支付中心IB,国际业务系统DZ,定制终端FS,内容计费结算系统MRS,移动转售系统P1,PBOSSBB,BBOSSCI,CMIOT系统ICB,物联网内容计费T0,三期清算IPS,IP子系统IWS,国际wlan结算系统IMS,国际彩信结算系统ISM,国际短信结算系统I1,国际局结算系统E0,一级电渠CC,一证五号IR,国际漫游BOSS系统C0,一级客服PTM,一级终端管理系统XZ,携号转网系统AD,能力开放平台S0,四期清算MP,中间号平台M0,全网用户敏感信息访问日志集中管控平台N0,网络域用户敏感信息访问日志集中管控平台SCA,沉默客户激活系统 Silent customer activation system4G,4GbossI0,国际局清算AMC,资产管理系统AMA,资产手机APPNR,国际非漫游系统CD,卡号资源AM,资产管理NB,新业务营销SP,垃圾短信黑白名单DS,决策支持MA,MAS平台CP,集中数据存储共享平台IS,国际短信IM,国际彩信JY,集中运营系统BD,本地业务系统XI,融合通信管控平台IOP,一级IOPVGOP,一级VGOPXY,逍遥系统TD,TD数据库MPP,信息港MPPMPP1,哈池MPPHDB,HADOOP三期二（非回传主库）HDB,HADOOP三期二（回传TD库）HDO,HADOOP三期一HDO2,HADOOP二期二HDT,HADOOP租户域
» sortType	body	string	true	排序类型-asc or desc
» keyWord	body	string	false	关键字
» subjectDomainCode	body	string	true	业务主题域

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": {
    "total": "1",
    "rows": [
      {
        "assetId": "92",
        "code": "test",
        "name": "测试表",
        "originalSystem": "系统编码",
        "objLevelCode": "65",
        "subjectDomainCode": "51",
        "earliestDataTime": "2007-12-20 00:34:24",
        "recentDataTime": "2014-01-19 17:34:08",
        "dataSize": "100GB",
        "interDuty": "运维部",
        "status": "1"
      }
    ]
  }
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	响应状态码
» msg	string	true	none	消息
» data	object	true	none	none
»» total	integer	true	none	数据总数
»» rows	[object]	true	none	数据
»»» assetId	string	false	none	资产ID
»»» code	string	false	none	对象英文名称
»»» name	string	false	none	对象中文名称
»»» originalSystem	string	false	none	来源系统
»»» objLevelCode	string	false	none	所属层
»»» subjectDomainCode	string	false	none	业务主题域
»»» earliestDataTime	string	false	none	最早数据时间
»»» recentDataTime	string	false	none	最晚数据时间
»»» dataSize	string	false	none	存储量
»»» interDuty	string	false	none	数据运维单位
»»» status	string	false	none	数据状态

6.注册申请

POST 资产注册接口

POST /manager/register

功能描述：用于【注册申请】页面，提供资产注册功能

表操作：`更新`

实现逻辑：

根据资产id【ASSET_ID】字段，更新资产表字段:
- 资产名称(ASSET_NAME)
- 服务模式(SERV_TYPE)
- 业务分类(BUSI_TYPE)
- 需求说明(REQ_MEMO)
- 数据描述(ASSET_MEMO)
  +备注信息(MEMO)
- 资产状态(STATUS)
- 注册时间(REGISTER_TIME)
涉及到的表：资产表
数据过滤条件：资产表.资产ID={assetId}

返回数据：

返回更新操作结果

Body 请求参数

{
  "type": "object",
  "properties": {
    "assetName": {
      "type": "string",
      "description": "审计数据名称"
    },
    "servType": {
      "type": "string",
      "description": "服务模式-多个情况下使用逗号分割\nDB：数据库\nDA：批量数据"
    },
    "busiType": {
      "type": "string",
      "description": "业务分类(单选)\nHT,合同\nKF,客服\nKH,客户\nFW,服务\nFWSY,服务使用\nZW,账务\nZY,资源\nQT,其他\n"
    },
    "reqMemo": {
      "type": "string",
      "description": "需求说明"
    },
    "assetMemo": {
      "type": "string",
      "description": "数据描述"
    },
    "memo": {
      "type": "string",
      "description": "备注信息"
    },
    "assetId": {
      "type": "string",
      "description": "资产id"
    },
    "labelIds": {
      "type": "string",
      "description": "标签信息 多个以逗号分开"
    }
  },
  "required": [
    "assetName",
    "servType",
    "busiType",
    "reqMemo",
    "assetMemo",
    "memo",
    "assetId",
    "labelIds"
  ]
}

请求参数

名称	位置	类型	必选	说明
body	body	object	false	none
» assetName	body	string	true	审计数据名称
» servType	body	string	true	服务模式-多个情况下使用逗号分割
» busiType	body	string	true	业务分类(单选)
» reqMemo	body	string	true	需求说明
» assetMemo	body	string	true	数据描述
» memo	body	string	true	备注信息
» assetId	body	string	true	资产id
» labelIds	body	string	true	标签信息多个以逗号分开

详细说明

» servType: 服务模式-多个情况下使用逗号分割
DB：数据库
DA：批量数据

» busiType: 业务分类(单选)
HT,合同
KF,客服
KH,客户
FW,服务
FWSY,服务使用
ZW,账务
ZY,资源
QT,其他

返回示例

成功

{
  "code": "0",
  "msg": "处理成功"
}

{
  "code": "-1",
  "msg": "处理失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	响应状态码
» msg	string	true	none	消息

GET 根据资产id查询资产信息

GET /manager/detail/{assetId}

功能描述：`用于【注册申请】页面展现【资产信息】部分数据`

表操作：`查询`

实现逻辑：

涉及到的表：资产表【bdam_asset】、元数据表【bdam_meta_table】
数据关联条件：
资产表.元数据编码 = 元数据表.元数据编码
数据过滤条件：
资产表.资产ID={assetId}
数据分组：无
数据排序：无

返回数据：

对象英文名称：元数据表【bdam_meta_table】-> CODE
对象中文名称：元数据表【bdam_meta_table】-> NAME
来源：元数据表【bdam_meta_table】-> CLUSTER_NAME + OWNER（所属集群与所属数据库拼接）
存储数据日期：元数据表【bdam_meta_table】-> EARLIEST_DATA_TIME + RECENT_DATA_TIME（数据最早时间与数据最晚时间拼接）
数据状态：资产表【bdam_asset】-> STATUS

请求参数

名称	位置	类型	必选	说明
assetId	path	string	true	资产id

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": {
    "code": "20",
    "name": "代完始料",
    "source": "irure ut amet anim",
    "storageTime": "1983-06-21 17:54:02",
    "status": "1",
    "assetMemo": "资产描述",
    "reqMemo": "123",
    "memo": "321",
    "labelList": [
      {
        "labelId": "1",
        "labelValue": "标签1"
      },
      {
        "labelId": "2",
        "labelValue": "标签2"
      }
    ]
  }
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» msg	string	true	none	none
» data	object	true	none	none
»» code	string	true	none	源接口表英文名称
»» name	string	true	none	源接口表中文名称
»» source	string	true	none	来源
»» storageTime	string	true	none	存储数据日期
»» status	string	true	none	数据状态
»» assetMemo	string	true	none	资产描述
»» labelList	[object]	true	none	none
»»» labelId	string	true	none	标签id
»»» labelValue	string	true	none	标签名称
»» reqMemo	string	true	none	需求说明
»» memo	string	true	none	备注信息

7.数据详情

GET 存储空间趋势接口

GET /detail/storage/{assetId}

功能描述：`用于【资产详情页面】页面展现【存储空间趋势】部分数据（根据资产id查询近7天元数据动态信息表）`

实现逻辑：

涉及到的表：资产表，元数据动态信息表
数据关联条件：
资产表.元数据编码 = 元数据动态信息表.元数据编码
数据过滤条件：资产id，数据获取账期取前7天（不包含当天）
数据分组：无
数据排序：数据获取账期

返回数据：

表：元数据动态信息表

元数据编码（originalOid）
总存储量(条)（storageTotal）
数据量大小(GB)（dataSize）
数据获取账期（acctDate）

请求参数

名称	位置	类型	必选	说明
assetId	path	string	true	资产id

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": [
    {
      "originalOid": "11",
      "storageTotal": "10G",
      "dataSize": "1000000",
      "acctDate": "2020/11/30"
    },
    {
      "originalOid": "11",
      "storageTotal": "11G",
      "dataSize": "2000000",
      "acctDate": "2020/12/1"
    },
    {
      "originalOid": "11",
      "storageTotal": "12G",
      "dataSize": "3000000",
      "acctDate": "2020/12/2"
    }
  ]
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» msg	string	true	none	none
» data	[object]	true	none	none
»» originalOid	string	true	none	元数据编码
»» storageTotal	string	true	none	总存储量(条)
»» dataSize	string	true	none	数据量大小(GB)
»» acctDate	string	true	none	数据获取账期

POST 资产样例数据查询接口

POST /detail/sample/{pageNo}/{pageSize}

功能描述：`用于【审计数据管理-资产详情页面】页面展现【样例数据】部分数据（资产样例数据查询）`

实现逻辑：

涉及到的表：资产样例数据
数据关联条件：无
数据过滤条件：资产id
数据分组：无
数据排序：无

返回数据：

表：资产样例数据

Body 请求参数

{
  "type": "object",
  "properties": {
    "assetId": {
      "type": "string",
      "description": "资产ID"
    }
  },
  "required": [
    "assetId"
  ]
}

请求参数

名称	位置	类型	必选	说明
pageNo	path	string	true	页数
pageSize	path	string	true	每页行数
body	body	object	false	none
» assetId	body	string	true	资产ID

返回示例

成功

{
  "msg": "成功",
  "code": "0",
  "data": {
    "total": 1,
    "rows": [
      {
        "originalOid": "1",
        "fieldValue": "{\"id\":\"3\",\"age\":\"30\",\"name\":\"wangwu\"}"
      }
    ]
  }
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» msg	string	true	none	none
» code	string	true	none	none
» data	object	true	none	none
»» total	integer	true	none	none
»» rows	[object]	true	none	none
»»» originalOid	string	false	none	元数据编码
»»» fieldValue	string	false	none	字段值

GET 物理表结构接口(全量)

GET /detail/struct/{assetId}

功能描述：`用于【审计数据管理-资产详情页面】页面展现【物理表结构信息】部分数据（根据资产id查询表结构信息）`

实现逻辑：

涉及到的表： 资产表，元数据表结构
数据关联条件： 资产表.元数据编码 = 元数据表结构.元数据编码
数据过滤条件： 资产id
数据分组：无
数据排序： 元数据表结构.字段顺序

返回数据：

表：元数据表结构

字段英文名（fieldCode）
字段中文名（fieldName）
是否主键（ifPrmKey）
字段类型（dataType）
字段长度（fieldLength）
是否可空（isNullable）
字段顺序（fieldOrd）
字段注释（comment）

请求参数

名称	位置	类型	必选	说明
assetId	path	string	true	资产ID

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": [
    {
      "ifPrmKey": "0",
      "fieldName": "当农名里",
      "fieldLength": "62",
      "comment": "应例日五易点统标果入积满起际。商拉在广应四起生感规务日素。候需给原化习场这路林参出界着。受权设存建元农它证六达因过八细。铁程活龙准准北青安少都积半二。",
      "fieldCode": "WRD_ABE",
      "fieldOrd": 13,
      "isNullable": "1",
      "dataType": "varchar"
    },
    {
      "comment": "和华原选需土系马用达示究道。厂南派加平整山加节文么机。保金立生调积式部增间教劳区列管统。党资众油阶向军越去便才些才般林需机该。论下角定图活红火但难眼知门日劳可科只。",
      "dataType": "varchar",
      "fieldOrd": 14,
      "isNullable": "1",
      "fieldCode": "NJF_LNX",
      "fieldName": "定分最光却",
      "ifPrmKey": "0",
      "fieldLength": "91"
    },
    {
      "ifPrmKey": "1",
      "dataType": "varchar",
      "fieldCode": "UJS_PW",
      "comment": "开快细受京明等总体没照众运月住方。群路她的科里证光式还水革最些。战已属东共科而验形劳存间并真一外。住多构方子动习算立只例多些思教。",
      "fieldLength": "89",
      "fieldOrd": 15,
      "fieldName": "亲头指",
      "isNullable": "0"
    },
    {
      "fieldCode": "HB_JWE",
      "dataType": "varchar",
      "ifPrmKey": "1",
      "fieldName": "半万比",
      "fieldOrd": 16,
      "isNullable": "1",
      "comment": "更转决毛示集化学分位美报查思族利水。白第统复百三半基解具什家算。速切需变该许理总问相别准者开金织。已易化导克调平技程照度声越响任。当出步术图切度品接关风至火队他必。",
      "fieldLength": "61"
    },
    {
      "fieldOrd": 17,
      "comment": "记华京化四指只合往真量设出文。车系看部适报联组相大用们实物花建品。活石力史等天面至还众断车增然值会非。叫给马看引火体生周红值表接色三。保国权易题战究百历最着中于水群直题。教外电接空法毛道习式热点质。",
      "fieldLength": "75",
      "fieldName": "及除建",
      "ifPrmKey": "1",
      "fieldCode": "TR_DT",
      "isNullable": "0",
      "dataType": "varchar"
    }
  ]
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» msg	string	true	none	none
» data	[object]	true	none	none
»» fieldCode	string	false	none	字段编码
»» fieldName	string	false	none	字段名称
»» ifPrmKey	string	false	none	是否主键
»» dataType	string	false	none	字段类型
»» fieldLength	string	false	none	字段长度
»» isNullable	string	false	none	是否为空
»» fieldOrd	integer	false	none	字段顺序
»» comment	string	false	none	字段注释

POST 物理表结构接口

POST /detail/struct/{pageNo}/{pageSize}

功能描述：`用于【审计数据管理-资产详情页面】页面展现【物理表结构信息】部分数据（根据资产id查询表结构信息）`

实现逻辑：

涉及到的表： 资产表，元数据表结构
数据关联条件： 资产表.元数据编码 = 元数据表结构.元数据编码
数据过滤条件： 资产id
数据分组：无
数据排序： 元数据表结构.字段顺序

返回数据：

表：元数据表结构

字段英文名（fieldCode）
字段中文名（fieldName）
是否主键（ifPrmKey）
字段类型（dataType）
字段长度（fieldLength）
是否可空（isNullable）
字段顺序（fieldOrd）
字段注释（comment）

Body 请求参数

{
  "type": "object",
  "properties": {
    "assetId": {
      "type": "string"
    }
  },
  "required": [
    "assetId"
  ]
}

请求参数

名称	位置	类型	必选	说明
pageNo	path	string	true	页数
pageSize	path	string	true	单页大小
body	body	object	false	none
» assetId	body	string	true	none

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": {
    "total": 100,
    "rows": [
      {
        "fieldCode": "asset_id",
        "fieldName": "资产名称",
        "ifPrmKey": "1",
        "dataType": "varchar(255)",
        "fieldLength": "100",
        "isNullable": "0",
        "fieldOrd": 1,
        "comment": "test"
      }
    ]
  }
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» msg	string	true	none	none
» data	object	true	none	none
»» total	integer	true	none	none
»» rows	[object]	true	none	none
»»» fieldCode	string	false	none	字段英文名
»»» fieldName	string	false	none	字段中文名称
»»» ifPrmKey	string	false	none	主键
»»» dataType	string	false	none	字段类型
»»» fieldLength	string	false	none	字段长度
»»» isNullable	string	false	none	是否可空
»»» fieldOrd	integer	false	none	字段顺序
»»» comment	string	true	none	字段注释

GET 基础信息接口

GET /detail/basic/{assetId}

功能描述：`用于【资产详情页面】页面展现【重点关注+基础信息】部分数据（根据资产id查询详情信息）`

实现逻辑：

涉及到的表：资产表，元数据表，接口元数据信息表，资产使用说明附件关系表，附件表
数据关联条件：
资产表.元数据编码 = 元数据表.元数据编码
元数据表.接口编码 = 接口元数据信息表.接口编码 AND
元数据表.来源系统 = 接口元数据信息表.来源系统
资产表.资产ID = 资产使用说明附件关系表.资产ID
资产使用说明附件关系表.附件编码 = 附件表.附件编码
数据过滤条件：资产id
数据分组：无
数据排序：无

返回数据：

表：资产表

资产名称（assetName）
资产编码（assetCode）
状态（status）
资产类型（modelType）
数据管理单位（managerDuty）
业务归属域（dataDomain）
来源系统（originalSystem）
业务分类（busiType）
资产描述（assetMemo）
创建时间（createDate）
是否结构化数据（structFlag）
数据运维单位（interDuty）
数据覆盖单位（dataScope）
服务模式（servType）
备注信息（memo）
数据评价（assetEst）
需求描述（reqMemo）

表：元数据表

表名（code）
表中文名（name）
数据描述（desc）
采集周期（collecCycle）
最早数据时间（earliestDataTime）
最晚数据时间（recentDataTime）
所属数据库（owner）
存储周期（storageCycle）
所属集群（clusterName）
所属数据库用户名（ownerUser）

表：接口元数据信息表

接口编码（interId）
接口名称（interName）
采集方式（collecMethod）
对应接口规范（interStd）

表：附件表

附件编码（attachmentId）
附件名称（attachmentName）
附件路径（attachmentPath）
其他字段
数据权限（dataPermission）- 写死（已具备权限）
数据浏览数（dataViewNum） - 写死（-）
数据申请数（dataRequestNum） - 写死（-）
数据推送次数（dataPushNum） - 写死（-）

请求参数

名称	位置	类型	必选	说明
assetId	path	string	true	资产id

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": {
    "assetCode": "98",
    "assetName": "造一支后",
    "status": "eiusmod aliqua sint commodo minim",
    "modelType": "proident sint in enim tempor",
    "managerDuty": "eu reprehenderit magna",
    "dataDomain": "o.hxmxt@qq.com",
    "originalSystem": "nulla laborum laboris consequat enim",
    "busiType": "Lorem consequat cupidatat anim",
    "assetMemo": "incididunt Ut magna Excepteur",
    "createDate": "1971-12-12",
    "structFlag": "adipisicing",
    "interDuty": "in dolore",
    "dataScope": "Excepteur laboris pariatur qui",
    "servType": "数据库",
    "memo": "test",
    "assetEst": "9.0",
    "code": "sdgx21",
    "name": "235sfdg",
    "desc": "labore sit",
    "collecCycle": "velit in irure mollit",
    "earliestDataTime": "2003-08-06 20:21:44",
    "recentDataTime": "1981-05-10 00:29:59",
    "owner": "ullamco magna",
    "ownerUser": "bonc",
    "clusterName": "ullamco magna",
    "storageCycle": "Excepteur adipisicing consequat sed",
    "interId": "15",
    "interName": "学第组细众时都",
    "collecMethod": "ad dolor aute amet",
    "interStd": "minim mollit",
    "attachmentId": "11dsxgds",
    "attachmentName": "测试文档",
    "attachmentPath": "/home/ftp/test/"
  }
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» msg	string	true	none	none
» data	object	true	none	none
»» assetCode	string	true	none	数据编码
»» assetName	string	true	none	数据名称
»» status	string	true	none	数据状态
»» modelType	string	true	none	数据类型
»» managerDuty	string	true	none	数据管理单位
»» dataDomain	string	true	none	业务归属域
»» originalSystem	string	true	none	来源系统
»» busiType	string	true	none	业务分类
»» assetMemo	string	true	none	数据内容描述
»» createDate	string	true	none	创建时间
»» structFlag	string	true	none	是否结构化数据
»» interDuty	string	true	none	数据运维单位
»» dataScope	string	true	none	数据覆盖单位
»» field3	string	true	none	none
»» memo	string	true	none	备注信息
»» assetEst	string	true	none	数据评价
»» code	string	true	none	对象英文名称
»» name	string	true	none	对象中文名称
»» desc	string	true	none	数据内容
»» collecCycle	string	true	none	采集周期
»» earliestDataTime	string	true	none	最早数据时间
»» recentDataTime	string	true	none	最晚数据时间
»» owner	string	true	none	所属数据库
»» clusterName	string	true	none	所属集群
»» ownerUser	string	true	none	所属数据库用户名
»» storageCycle	string	true	none	源系统留存周期
»» interId	string	true	none	接口编码
»» interName	string	true	none	接口名称
»» collecMethod	string	true	none	采集方式
»» interStd	string	true	none	说明文档
»» servType	string	true	none	服务模式
»» attachmentId	string	true	none	附件编码
»» attachmentName	string	true	none	附件名称
»» attachmentPath	string	true	none	附件路径

8.系统初始化

GET 初始化系统码值

GET /init/system/dic

返回示例

成功

{
  "code": "0"
}

{
  "code": "-1"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none

9.数据标注

POST 数据标注

POST /asset/mark/submit

功能描述：`用于【数据标注页面】资产标注功能`

实现逻辑：

涉及到的表：资产表，资产标签，资产使用说明附件关系表，附件表
数据关联条件：无
数据过滤条件：无
数据分组：无
数据排序：无

sql：

插入资产标签

delete from bdam_asset_label where asset_id = #{assetId, jdbcType=VARCHAR}
insert into bdam_asset_label (asset_id, label_id, opt_staff_id, opt_date, opt_type) values ( )

插入附件表 -- ftp用id写

ftp重传
delete from attachment where attachment_id = (select attachment_id where asset_id = #{assetId, jdbcType=VARCHAR})
insert into attachment (attachment_id, attachment_name, attachment_path, sts, attachment_type) values ( )

插入资产附件关系表

delete from bdam_asset_int_attachment where asset_id = #{assetId, jdbcType=VARCHAR}
insert into bdam_asset_int_attachment (attachment_id, asset_id, opt_staff_id, opt_date, opt_type) values ( )

更新资产表资产评价字段

update bdam_asset set ASSET_EST = #{assetEst, jdbcType=VARCHAR} where asset_id = #{assetId, jdbcType=VARCHAR}

Body 请求参数

type: object
properties:
  type:
    type: string
    example: multipart
  file:
    type: string
    description: 附件
  assetId:
    type: string
    description: 资产id
  labelIds:
    type: string
    description: 标签id集合
  dataDesc:
    type: string
    description: 数据描述
  dataEst:
    type: string
    description: 数据评价
  attachmentType:
    type: string
    description: 文件类型
  attachmentId:
    type: string
    description: 附件ID
required:
  - type

请求参数

名称	位置	类型	必选	说明
body	body	object	false	none
» type	body	string	true	none
» file	body	string	false	附件
» assetId	body	string	false	资产id
» labelIds	body	string	false	标签id集合
» dataDesc	body	string	false	数据描述
» dataEst	body	string	false	数据评价
» attachmentType	body	string	false	文件类型
» attachmentId	body	string	false	附件ID

返回示例

成功

{
  "code": "0",
  "msg": "成功"
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» msg	string	true	none	none

GET 资产标注回显

GET /asset/tag/{assetId}

功能描述：`用于【数据标注页面】资产描述回显`

实现逻辑：

涉及到的表：资产表，资产标签，标签表，附件表，资产使用说明附件关系表
数据关联条件：无
数据过滤条件：资产编码
数据分组：无
数据排序：无

sql：

根据资产ID查询资产描述

SELECT
a.asset_id assetId,
a.asset_memo assetMemo,
bdat.attachment_id attachmentId,
bdat.attachment_name attachmentName,
bdat.attachment_path attachmentPath,
GROUP_CONCAT(bdl.label_id SEPARATOR ',') AS labelIds,
GROUP_CONCAT(bdl.label_value SEPARATOR ',') AS labelNames
FROM (SELECT
asset_id,
asset_memo
FROM bdam_asset
WHERE asset_id = #{assetId,jdbcType=VARCHAR}) a
LEFT JOIN bdam_asset_label bdal
ON a.asset_id = bdal.ASSET_ID
LEFT JOIN bdam_asset_int_attachment baia
ON a.asset_id = baia.ASSET_ID
LEFT JOIN bdam_attachment bdat
ON baia.ATTACHMENT_ID = bdat.ATTACHMENT_ID
LEFT JOIN bdam_label bdl
ON bdal.LABEL_ID = bdl.LABEL_ID
GROUP BY a.asset_id

请求参数

名称	位置	类型	必选	说明
assetId	path	string	true	资产ID

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": {
    "assetMemo": "anim elit eu commodo",
    "labelList": [
      {
        "labelId": "43",
        "labelValue": "装保她利眼生"
      },
      {
        "labelId": "16",
        "labelValue": "义听天十需青联"
      },
      {
        "labelId": "98",
        "labelValue": "眼取区亲县"
      },
      {
        "labelId": "48",
        "labelValue": "改们据该见矿"
      }
    ],
    "assetId": "49",
    "attachmentId": "81",
    "attachmentName": "信品所少",
    "assetEst": "9.0",
    "attachmentPath": "ipsum Lorem incididunt pariatur et"
  }
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» msg	string	true	none	none
» data	object	true	none	none
»» assetMemo	string	true	none	资产描述
»» assetId	string	true	none	资产编码
»» assetEst	string	true	none	资产评价
»» attachmentId	string	true	none	附件编码
»» attachmentName	string	true	none	附件名称
»» attachmentPath	string	true	none	附件路径
»» labelList	[object]	true	none	标签集合
»»» labelId	string	true	none	标签ID
»»» labelValue	string	true	none	标签名称

POST 数据标注 FOR ie9

POST /asset/mark/submitForIE

功能描述：`用于【数据标注页面】资产标注功能`

实现逻辑：

涉及到的表：资产表，资产标签，资产使用说明附件关系表，附件表
数据关联条件：无
数据过滤条件：无
数据分组：无
数据排序：无

sql：

插入资产标签

delete from bdam_asset_label where asset_id = #{assetId, jdbcType=VARCHAR}
insert into bdam_asset_label (asset_id, label_id, opt_staff_id, opt_date, opt_type) values ( )

插入附件表 -- ftp用id写

插入资产附件关系表

delete from bdam_asset_int_attachment where asset_id = #{assetId, jdbcType=VARCHAR}
insert into bdam_asset_int_attachment (attachment_id, asset_id, opt_staff_id, opt_date, opt_type) values ( )

更新资产表资产评价字段

update bdam_asset set ASSET_EST = #{assetEst, jdbcType=VARCHAR} where asset_id = #{assetId, jdbcType=VARCHAR}

Body 请求参数

{
  "type": "object",
  "properties": {
    "assetId": {
      "type": "string",
      "description": "资产id"
    },
    "labelIds": {
      "type": "string",
      "description": "标签id集合"
    },
    "dataDesc": {
      "type": "string",
      "description": "数据描述"
    },
    "dataEst": {
      "type": "string",
      "description": "数据评价"
    },
    "attachmentId": {
      "type": "string",
      "description": "附件id"
    }
  },
  "required": [
    "assetId",
    "labelIds",
    "dataDesc",
    "dataEst",
    "attachmentId"
  ]
}

请求参数

名称	位置	类型	必选	说明
body	body	object	false	none
» assetId	body	string	true	资产id
» labelIds	body	string	true	标签id集合
» dataDesc	body	string	true	数据描述
» dataEst	body	string	true	数据评价
» attachmentId	body	string	true	附件id

返回示例

成功

{
  "code": "0",
  "msg": "成功"
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» msg	string	true	none	none

10.数据标签维护

POST 标签列表

POST /label/list/{pageNo}/{pageSize}

用于【标签维护】页面查询标签列表
select t.LABEL_ID,t.LABEL_VALUE,t.PARENT_LABEL_ID,(select LABEL_VALUE from bdam_label tt where tt.LABEL_ID=t.LABEL_ID) PARENT_LABEL_VALUE from bdam_label t WHERE STS="A"

Body 请求参数

{
  "type": "object",
  "properties": {
    "labelValue": {
      "type": "string",
      "description": "标签名称"
    }
  }
}

请求参数

名称	位置	类型	必选	说明
pageNo	path	string	true	页码
pageSize	path	string	true	none
body	body	object	false	none
» labelValue	body	string	false	标签名称

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": {
    "total": 1,
    "rows": [
      {
        "labelId": "2",
        "lableValue": "标签二",
        "parentLabelId": "1",
        "parentLabelValue": "标签一",
        "createDate": "2020-12-27 20:21:19"
      }
    ]
  }
}

{
  "code": "-1",
  "msg": "失败",
  "data": null
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» msg	string	true	none	none
» data	object	true	none	none
»» total	integer	true	none	行数
»» rows	[object]	true	none	none
»»» labelId	string	false	none	标签id
»»» labelValue	string	false	none	标签名称
»»» parentLabelId	string	false	none	父级标签id
»»» parentLabelValue	string	false	none	父级标签名称
»»» createDate	string	true	none	创建时间

GET 标签统计

GET /label/statistics

用于【标签维护】页面统计标签总数，一级标签数量、二级标签数量
select count(1), 'all' from bdam_label t WHERE STS="A"
union all
select count(1), 'one' from bdam_label t where t.PARENT_LABEL_ID='{rootId}' AND STS="A" union all select count(1), 'two' from bdam_label t where t.PARENT_LABEL_ID in (select LABEL_ID from bdam_label where PARENT_LABEL_ID='{rootId}') AND STS="A"

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": {
    "all": 194,
    "levelOne": 54,
    "levelTwo": 69
  }
}

{
  "code": "-1",
  "msg": "失败",
  "data": {}
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	响应状态码
» msg	string	true	none	消息
» data	object	true	none	none
»» all	integer	true	none	标签总数
»» levelOne	integer	true	none	一级标签数量
»» levelTwo	integer	true	none	二级标签数量

POST 新增标签

POST /label/add

用于【标签维护】页面新增标签
insert into bdam_label (LABEL_ID,LABEL_VALUE,PARENT_LABEL_ID,STS,CREATE_STAFF_ID,CREATE_DATE);

Body 请求参数

{
  "type": "object",
  "properties": {
    "labelValue": {
      "type": "string",
      "description": "标签名称"
    },
    "parentLabelId": {
      "type": "string",
      "description": "父级标签id"
    }
  },
  "required": [
    "labelValue",
    "parentLabelId"
  ]
}

请求参数

名称	位置	类型	必选	说明
body	body	object	false	none
» labelValue	body	string	true	标签名称
» parentLabelId	body	string	true	父级标签id

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": {}
}

{
  "code": "-1",
  "msg": "失败",
  "data": {}
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	响应状态码
» msg	string	true	none	消息
» data	object	true	none	none

POST 修改、删除标签

POST /label/edit/{optType}

用于【标签维护】页面编辑标签信息（修改&&删除）
根据操作类型判断
optType: upd-修改 del-删除
修改：
update bdam_label t set t.LABEL_VALUE="{value}" , t.MODI_STAFF_ID="{staffId}" ,t.MODI_DATE=current_date
where LABEL_ID="{labelId}"; 删除： update bdam_label t set t.sts='P' where t.LABEL_ID="{labelId}";

Body 请求参数

{
  "type": "object",
  "properties": {
    "labelValue": {
      "type": "string",
      "description": "标签名称:如果是删除操作 ，该值不需要传"
    },
    "labelId": {
      "type": "string",
      "description": "标签id"
    }
  },
  "required": [
    "labelValue",
    "labelId"
  ]
}

请求参数

名称	位置	类型	必选	说明
optType	path	string	true	upd-修改 del-删除
body	body	object	false	none
» labelValue	body	string	true	标签名称:如果是删除操作，该值不需要传
» labelId	body	string	true	标签id

返回示例

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	响应状态码
» msg	string	true	none	消息
» data	object	true	none	none

11.血缘关系

POST 刷新血缘关系数据

POST /relation/refreshRelation

返回示例

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

GET 根据节点id获得下级血缘关系

GET /relation/getById/{nodeId}

请求参数

名称	位置	类型	必选	说明
nodeId	path	string	true	元数据编码

返回示例

成功

{
  "msg": "成功",
  "code": "0",
  "data": [
    {
      "level": -1,
      "detailTable": [
        {
          "type": "中文名",
          "desc": "银行存款明细表"
        },
        {
          "type": "英文名",
          "desc": "DWI_M_FIN_AP_BANKACCOUNT_DETAILS"
        },
        {
          "type": "所属集群",
          "desc": "集市集群"
        },
        {
          "type": "所属库",
          "desc": "zhsj"
        },
        {
          "type": "来源(0)",
          "desc": ""
        },
        {
          "type": "去向(1)",
          "desc": "采购项目信息列表(非电子化)"
        }
      ],
      "name": "1",
      "links": [
        "2"
      ],
      "text": "银行存款明细表",
      "category": "2",
      "parents": []
    },
    {
      "level": -1,
      "detailTable": [
        {
          "type": "中文名",
          "desc": "风险业务及或有事项情况表"
        },
        {
          "type": "英文名",
          "desc": "ODS_Y_FIN_GL_RISK_BUSISS"
        },
        {
          "type": "所属集群",
          "desc": "主仓集群"
        },
        {
          "type": "所属库",
          "desc": "provdb"
        },
        {
          "type": "来源(0)",
          "desc": ""
        },
        {
          "type": "去向(1)",
          "desc": "采购项目信息列表(非电子化)"
        }
      ],
      "name": "5",
      "links": [
        "2"
      ],
      "text": "风险业务及或有事项情况表",
      "category": "2",
      "parents": []
    },
    {
      "level": 0,
      "detailTable": [
        {
          "type": "中文名",
          "desc": "采购项目信息列表(非电子化)"
        },
        {
          "type": "英文名",
          "desc": "DWI_M_PUR_PRJ_NON_ELECT_INFO_LIST"
        },
        {
          "type": "所属集群",
          "desc": "集市集群"
        },
        {
          "type": "所属库",
          "desc": "zhsj"
        },
        {
          "type": "来源(2)",
          "desc": "银行存款明细表,风险业务及或有事项情况表"
        },
        {
          "type": "去向(1)",
          "desc": "电子采购项目"
        }
      ],
      "name": "2",
      "links": [
        "3"
      ],
      "text": "采购项目信息列表(非电子化)",
      "category": "2",
      "parents": [
        "1",
        "5"
      ]
    },
    {
      "level": 1,
      "detailTable": [
        {
          "type": "中文名",
          "desc": "电子采购项目"
        },
        {
          "type": "英文名",
          "desc": "DWI_M_PUR_PRJ_EPROCUREMENT"
        },
        {
          "type": "所属集群",
          "desc": "集市集群"
        },
        {
          "type": "所属库",
          "desc": "zhsj"
        },
        {
          "type": "来源(1)",
          "desc": "采购项目信息列表(非电子化)"
        },
        {
          "type": "去向(2)",
          "desc": "科目余额表,资格预审采购项目供应商应答文件上传记录头表"
        }
      ],
      "name": "3",
      "links": [
        "6",
        "4"
      ],
      "text": "电子采购项目",
      "category": "2",
      "parents": [
        "2"
      ]
    },
    {
      "level": 2,
      "detailTable": [
        {
          "type": "中文名",
          "desc": "科目余额表"
        },
        {
          "type": "英文名",
          "desc": "ODS_M_FIN_PRJ_SUBBAL"
        },
        {
          "type": "所属集群",
          "desc": "主仓集群"
        },
        {
          "type": "所属库",
          "desc": "sj_centra_m_data"
        },
        {
          "type": "来源(1)",
          "desc": "电子采购项目"
        },
        {
          "type": "去向(1)",
          "desc": "资产负债表"
        }
      ],
      "name": "6",
      "links": [
        "7"
      ],
      "text": "科目余额表",
      "category": "2",
      "parents": [
        "3"
      ]
    },
    {
      "level": 2,
      "detailTable": [
        {
          "type": "中文名",
          "desc": "资格预审采购项目供应商应答文件上传记录头表"
        },
        {
          "type": "英文名",
          "desc": "ODS_M_PUR_PRJ_SUPPLIER_RESPONSE_UPLOADFILE_HEADER"
        },
        {
          "type": "所属集群",
          "desc": "主仓集群"
        },
        {
          "type": "所属库",
          "desc": "sj_centra_m_data"
        },
        {
          "type": "来源(1)",
          "desc": "电子采购项目"
        },
        {
          "type": "去向(0)",
          "desc": ""
        }
      ],
      "name": "4",
      "links": [],
      "text": "资格预审采购项目供应商应答文件上传记录头表",
      "category": "2",
      "parents": [
        "3"
      ]
    },
    {
      "level": 3,
      "detailTable": [
        {
          "type": "中文名",
          "desc": "资产负债表"
        },
        {
          "type": "英文名",
          "desc": "ODS_Y_FIN_GL_ALI"
        },
        {
          "type": "所属集群",
          "desc": "主仓集群"
        },
        {
          "type": "所属库",
          "desc": "provdb"
        },
        {
          "type": "来源(1)",
          "desc": "科目余额表"
        },
        {
          "type": "去向(0)",
          "desc": ""
        }
      ],
      "name": "7",
      "links": [],
      "text": "资产负债表",
      "category": "2",
      "parents": [
        "6"
      ]
    }
  ]
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» msg	string	true	none	none
» code	string	true	none	none
» data	[object]	true	none	none
»» level	integer	false	none	层级
»» detailTable	[object]	false	none	节点详情
»»» type	string	true	none	标题
»»» desc	string	true	none	描述
»» name	string	false	none	表名字
»» links	[string]	false	none	子节点
»» text	string	false	none	表中文名
»» category	integer	false	none	分类2：应用层 1：模型层 0：基础层
»» selected	boolean	false	none	是否是主节点
»» parents	[string]	false	none	父节点

12.购物车

GET 查询购物车资产列表

GET /cart/list

功能描述： `用于【购物车】页面【查询资产列表】`

表操作：`query`

实现逻辑：

涉及到的表：购物车表[bdam_shopping_cart] 资产表[bdam_asset ] 资产元数据表[bdam_meta_table ]
步骤：
1、查询购物车表
select
t1.asset_id,
t2.asset_code,
t3.code,
t3.name,
t2.original_system
t1.prov_id
from
bdam_shopping_cart t1
left join bdam_asset t2 on (t1.asset_id=t2.asset_id)
left join bdam_meta_table t3 on (t2.original_oid=t3.original_oid)
where
login_id=${loginid}
2、通过缓存获取省份名称

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": [
    {
      "dataCode": "DASJ01M02111000113",
      "objCode": "WIL_LQR_WA",
      "objName": "体关义劳面",
      "originalSystem": "WZ",
      "assetId": "8aC6ACd4-a47b-dc9a-1db4-Ce3CdA6dCdeC",
      "provIds": [
        {
          "code": "1001675",
          "name": "新疆维吾尔自治区"
        },
        {
          "code": "1001652",
          "name": "广东省"
        },
        {
          "code": "1001488",
          "name": "内蒙古自治区"
        },
        {
          "code": "1001100",
          "name": "海外"
        },
        {
          "code": "1001412",
          "name": "湖南省"
        }
      ]
    },
    {
      "dataCode": "DASJ01M02111000131",
      "objCode": "PL_PWI_TO",
      "objName": "因至色业段",
      "originalSystem": "PN",
      "assetId": "c6A230fB-B239-dc2B-740C-CEA7E4Edfd40",
      "provIds": [
        {
          "code": "1001147",
          "name": "浙江省"
        },
        {
          "code": "1001128",
          "name": "天津"
        }
      ]
    },
    {
      "dataCode": "DASJ01M02111000115",
      "objCode": "PU_VZQ_JJK",
      "objName": "个识后低素",
      "originalSystem": "NX",
      "provIds": [
        {
          "code": "1001631",
          "name": "内蒙古自治区"
        },
        {
          "code": "1001255",
          "name": "广东省"
        },
        {
          "code": "1001102",
          "name": "江苏省"
        },
        {
          "code": "1001995",
          "name": "广东省"
        },
        {
          "code": "1001768",
          "name": "甘肃省"
        }
      ],
      "assetId": "225aBCDb-88b6-9cb3-e7aE-fE8179D43d9E"
    }
  ]
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» msg	string	true	none	none
» data	[object]	true	none	none
»» assetId	string	false	none	资产id
»» dataCode	string	true	none	数据编码
»» objCode	string	true	none	对象英文名
»» objName	string	true	none	对象中文名
»» originalSystem	string	true	none	来源系统
»» provIds	[object]	false	none	省份
»»» code	string	true	none	省份编码
»»» name	string	true	none	省份名称

POST 更新购物车中资产相关信息

POST /cart/update

功能描述： `用于【购物车】页面【数据订购列表中修改字段、省份、账期时间】`

表操作：`update`

实现逻辑：

涉及到的表：购物车表[bdam_shopping_cart]
逻辑：
1、更新购物车表
update bdam_shopping_cart set
PROV_ID={PROV_ID} where login_id={系统登录用户ID} and
asset_id=${assetId}

Body 请求参数

type: object
properties:
  assetId:
    type: string
    description: 资产ID
    example: CC35D09F8FF24638A38B716C2C52BBAC
  provId:
    type: string
    description: 省份ID(多个逗号分隔)
    example: 000,001
required:
  - assetId
  - provId

请求参数

名称	位置	类型	必选	说明
body	body	object	false	none
» assetId	body	string	true	资产ID
» provId	body	string	true	省份ID(多个逗号分隔)

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": "1"
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	状态码
» msg	string	true	none	消息
» data	integer	true	none	更新条数

GET 查询购物车资产数

GET /cart/count

功能描述： `用于【数据目录】页面【购物车中资产数量查询】`

表操作：`query`

实现逻辑：

涉及到的表：购物车表[bdam_shopping_cart]
步骤: SELECT COUNT(1) AS assetCount FROM bdam_shopping_cart WHERE login_id=${登录用户ID}

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": "10"
}

"{\r\n\"code\":\"-1\"\r\n\"msg\":\"失败\"\r\n}"

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	状态码
» msg	string	true	none	消息
» data	string	true	none	资产数量

POST 删除购物车中资产

POST /cart/delete

功能描述： `用于【购物车】页面【删除资产】`

表操作：`delete`

实现逻辑：

涉及到的表：购物车表[bdam_shopping_cart]
步骤：
1、删除购物车表
delete from bdam_shopping_cart where login_id={loginId} and asset_id in {assetId}

Body 请求参数

{
  "type": "array",
  "items": {
    "type": "string",
    "description": "资产ID"
  }
}

请求参数

名称	位置	类型	必选	说明
body	body	array[string]	false	none

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": "66"
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	状态码
» msg	string	true	none	消息
» data	integer	true	none	删除条数

POST 添加购物车

POST /cart/add/{assetId}

功能描述： `用于【资产目录】页面【加入购物车】`

表操作：`insert` `select`

实现逻辑：

涉及到的表：购物车表[bdam_shopping_cart]
步骤:
1、检查是否已经加入购物车
select count(1) from bdam_shopping_cart where login_id={loginId} and assetId={assetId}
2、添加到购物车(根据步骤1的结果而定)
insert into bdam_shopping_cart (login_id,asset_id) value({loginId},{assetId})

请求参数

名称	位置	类型	必选	说明
assetId	path	string	true	资产ID

返回示例

成功

{
  "code": "0",
  "msg": "成功"
}

{
  "code": "-1",
  "msg": "失败"
}

{
  "code": "1",
  "msg": "该资产已经添加购物车"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	none
» msg	string	true	none	none

13.项目信息

GET 项目信息查询接口

GET /project/list

功能描述： `用于【购物车】页面查询【所属项目】下拉菜单`

表操作：`query`

实现逻辑：

涉及到的表：项目表[bdam_project_info] 项目用户表[bdam_project_user_info ]
步骤：
1、查询项目表和项目用户表
select
t2.project_id,
t2.project_name,
t2.planaudit_starttime,
t2.planaudit_starttime
from
bdam_project_user_info t1
inner join bdam_project_info t2 on (t1.project_id=t2.project_id)
where
t1.user_phone =${usermobile}

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": [
    {
      "projectId": "410000202007077142",
      "projectName": "指办龙毛称此声快片",
      "planauditStarttime": "2006-07-13",
      "planauditEndtime": "2010-02-02"
    },
    {
      "projectId": "820000197009274652",
      "projectName": "流总格第再速提所身民正",
      "planauditStarttime": "1974-05-18",
      "planauditEndtime": "2014-11-19"
    },
    {
      "projectId": "460000197508317138",
      "projectName": "王手按么光被思新果",
      "planauditStarttime": "1980-03-20",
      "planauditEndtime": "2011-11-21"
    }
  ]
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	状态码
» msg	string	true	none	消息
» data	[object]	true	none	数据
»» projectId	string	true	none	项目ID
»» projectName	string	true	none	项目名称
»» planauditStarttime	string	true	none	开始时间
»» planauditEndtime	string	true	none	结束时间

GET 项目用户查询接口

GET /project/user/{projectId}

功能描述： `用于【购物车】页面查询【数据使用人员】表格`

表操作：`query`

实现逻辑：

涉及到的表：项目用户表[bdam_project_user_info ]
步骤：
SELECT
USER_ID,
USER_NAME,
USER_TYPE,
PREDICTED_START_TIME,
PREDICTED_END_TIME,
USER_DEPARTMENT_NAME,
USER_PHONE
FROM
bdam_project_user_info
WHERE
PROJECT_ID=${projectId}

请求参数

名称	位置	类型	必选	说明
projectId	path	string	true	项目ID

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": [
    {
      "userId": "450000201108115155",
      "userName": "段军",
      "userType": "物每科史片想",
      "predictedStartTime": "1997-12-28",
      "predictedEndTime": "1991-10-15",
      "userDepartmentName": "写况形世群究式想参",
      "userPhone": "13147977447"
    },
    {
      "userId": "31000019990513258X",
      "userName": "黎敏",
      "userType": "型被养毛解",
      "predictedStartTime": "1989-03-04",
      "predictedEndTime": "2008-12-19",
      "userDepartmentName": "步西主精用主将治题单",
      "userPhone": "18129446201"
    }
  ]
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	状态码
» msg	string	true	none	消息
» data	[object]	true	none	数据
»» userId	string	true	none	用户ID
»» userName	string	true	none	用户名称
»» userType	string	true	none	项目角色
»» predictedStartTime	string	true	none	开始时间
»» predictedEndTime	string	true	none	结束时间
»» userDepartmentName	string	true	none	所属公司
»» userPhone	string	true	none	手机号

14.资产定购

POST 资产订购列表接口

POST /order/list/{pageNo}/{pageSize}

功能描述： `用于【我的申请】页面展现数据列表`

表操作：`select`

实现逻辑：

涉及到的表：资产订购表[bdam_asset_order] 项目信息表[bdam_asset_order_detail]
步骤：
1、查询列表
select
t1.order_id,
t1.status,
t1.apply_time,
t2.project_name,
t2.project_code，
t1.project_user_id
from
bdam_asset_order t1
left join bdam_project_info t2 on (t1.project_id = t2.project_id)
where
t1.login_id={系统登录用户ID} and t1.apply_time between{orderStartTime} and {orderEndTime} and t2.project_code={projectCode}

Body 请求参数

{
  "type": "object",
  "properties": {
    "orderStartTime": {
      "type": "string",
      "description": "订购时间(起始)"
    },
    "orderEndTime": {
      "type": "string",
      "description": "订购时间(终止)"
    },
    "projectCode": {
      "type": "string",
      "description": "项目编码"
    }
  }
}

请求参数

名称	位置	类型	必选	说明
pageNo	path	string	true	页码
pageSize	path	string	true	每页条数
body	body	object	false	none
» orderStartTime	body	string	false	订购时间(起始)
» orderEndTime	body	string	false	订购时间(终止)
» projectCode	body	string	false	项目编码

返回示例

成功

{
  "code": "['0'",
  "msg": "成功",
  "data": {
    "rows": [
      {
        "status": "已撤销",
        "applyTime": "2008-03-15  04:56:11",
        "projectCode": "HQ2019035",
        "orderId": "8822B33C-BE1b-b734-FfBD-782Fe2dEFb3f",
        "projectName": "品以细史总和京争"
      },
      {
        "projectName": "量响共酸切来干复究命",
        "orderId": "7F6e8BEc-D5B3-5Af6-ffB8-D32b7e41cF2e",
        "projectCode": "HQ2019064",
        "applyTime": "2008-04-17  16:06:06",
        "status": "已撤销"
      },
      {
        "status": "已撤销",
        "orderId": "Ef17745E-d2Bb-6A29-f1E6-B38FD165f47E",
        "projectName": "十常改机相",
        "applyTime": "1998-04-15  17:27:14",
        "projectCode": "HQ2019034"
      },
      {
        "applyTime": "1978-05-11  03:05:57",
        "status": "未通过",
        "projectName": "所包示广正方实",
        "projectCode": "HQ2019054",
        "orderId": "fCeCccD9-9ECc-66Dc-F998-AEcf879fDB19"
      }
    ],
    "total": "66"
  }
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	状态码
» msg	string	true	none	消息
» data	object	true	none	none
»» rows	[object]	true	none	数据行
»»» projectName	string	false	none	项目名称
»»» projectCode	string	false	none	项目编码
»»» applyTime	string	false	none	申请时间
»»» status	string	false	none	状态
»»» orderId	string	false	none	申请编码
»» total	string	true	none	总数

POST 资产订购接口

POST /order/submit

功能描述： `用于【购物车】页面点击【提交】按钮`

表操作：`insert` `delete`

实现逻辑：

涉及到的表：资产订购表[bdam_asset_order] 资产订购详情表[bdam_asset_order_detail] 购物车表[bdam_shopping_cart]
步骤：
1、生成订单
insert into bdam_asset_order values(
{生成id},{工作流ID},
{系统时间},{登录用户ID},
{order_reason},{project_id},
{project_user_id},{attachment_id},
2 --1审批中 2已通过 3未通过 4已撤销 5已推送
);
2、生成订单详情
insert into bdam_asset_order_detail
select
{生成id}, asset_id, prov_id, from bdam_shopping_cart where login_id={登录用户ID}
3、清空购物车
delete from bdam_shopping_cart where login_id=${登录用户ID}

Body 请求参数

{
  "type": "object",
  "properties": {
    "assets": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "assetId": {
            "type": "string",
            "description": "资产ID"
          },
          "provIds": {
            "type": "string",
            "description": "省份ID(多个逗号分隔)"
          }
        },
        "required": [
          "assetId",
          "provIds"
        ]
      },
      "description": "资产信息"
    },
    "orderReason": {
      "type": "string",
      "description": "订购原因"
    },
    "projectId": {
      "type": "string",
      "description": "项目ID"
    },
    "projectUserId": {
      "type": "string",
      "description": "项目用户ID"
    },
    "attachmentId": {
      "type": "string",
      "description": "附件ID"
    }
  },
  "required": [
    "assets",
    "orderReason",
    "projectId",
    "projectUserId"
  ]
}

请求参数

名称	位置	类型	必选	说明
body	body	object	false	none
» assets	body	[object]	true	资产信息
»» assetId	body	string	true	资产ID
»» provIds	body	string	true	省份ID(多个逗号分隔)
» orderReason	body	string	true	订购原因
» projectId	body	string	true	项目ID
» projectUserId	body	string	true	项目用户ID
» attachmentId	body	string	false	附件ID

返回示例

成功

{
  "code": "0",
  "msg": "成功"
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	状态码
» msg	string	true	none	消息

GET 资产订购详情接口

GET /order/detail/{orderId}

功能描述： `用于【数据订购详情】页面展现数据`

表操作：`select`

实现逻辑：

涉及到的表：资产订购表[bdam_asset_order] 项目信息表[bdam_asset_order_detail] 项目用户表[bdam_project_user_info] 资产表[bdam_asset] 资产元数据表[bdam_meta_table]
步骤：
1、查询订购数据
select
t2.project_name,
t2.planaudit_starttime,
t2.planaudit_endtime,
t1.order_reason,
t1.attachment_id,
t1.status,
t1.order_result,
t1.apply_time,
t1.login_id,
t1.project_user_id
from
bdam_asset_order t1
left join bdam_project_info t2 on (t1.project_id = t2.project_id)
where
t1.order_id={orderid} 2、查询资产数据 select t2.asset_code, t3.code, t3.name, t2.original_system, t1.prov_id from bdam_asset_order_detail t1 left join bdam_asset t2 on (t1.asset_id = t2.asset_id) left join bdam_meta_table t3 on (t2.original_oid=t3.original_oid) where t1.order_id={orderid}
3、查询项目用户数据
select
user_name,
user_type,
predicted_start_time,
predicted_end_time,
user_department_name,
user_phone
from
bdam_project_user_info
where
user_id in ${projectuserid}
4、调用系统管理模块获取申请人信息

请求参数

名称	位置	类型	必选	说明
orderId	path	string	true	订购ID

返回示例

成功

{
  "code": "0",
  "msg": "成功",
  "data": {
    "assets": [
      {
        "assetCode": "DASJ01M02111000335",
        "objCode": "WV_XS_PX",
        "objName": "办达养是标花",
        "originalSystem": "ZL",
        "provName": "青海省"
      },
      {
        "assetCode": "DASJ01M02111000246",
        "objCode": "ET_HYP_GDP",
        "objName": "影内人局常感济",
        "originalSystem": "KM",
        "provName": "海外"
      },
      {
        "assetCode": "DASJ01M02111000468",
        "objCode": "OP_NAG_TJ",
        "objName": "种府断克油育",
        "originalSystem": "MD",
        "provName": "香港特别行政区"
      },
      {
        "assetCode": "DASJ01M02111000933",
        "objCode": "DM_SS_ZGL",
        "objName": "里听几整省等",
        "originalSystem": "XN",
        "provName": "河北省"
      },
      {
        "assetCode": "DASJ01M02111000432",
        "objCode": "TDL_BK_YNU",
        "objName": "命则名指市",
        "originalSystem": "HW",
        "provName": "湖南省"
      }
    ],
    "projectName": "料器生众书流",
    "projectTime": "2021/03/28  0:00 - 2021/5/28  0:00",
    "users": [
      {
        "userName": "唐霞",
        "userType": "样元位改反断当率着干现",
        "predictedStartTime": "2013-12-16",
        "predictedEndTime": "1989-05-22",
        "userDepartmentName": "拉那合广",
        "userPhone": "18161195453"
      },
      {
        "userName": "方超",
        "userType": "有声器米天多长除式置",
        "predictedStartTime": "1987-06-20",
        "predictedEndTime": "2021-02-20",
        "userDepartmentName": "白素格太始",
        "userPhone": "18618182871"
      },
      {
        "userName": "黎杰",
        "userType": "书题利中运王型还区后",
        "predictedStartTime": "1988-06-25",
        "predictedEndTime": "2017-08-04",
        "userDepartmentName": "圆治决包别律面",
        "userPhone": "18182674161"
      }
    ],
    "orderReason": "步知求识书习之想列小中即场国。委九来安离意是行起龙可清数马。基复层上名在意识权究近由。世志器风值展志响习值用行音增。斯住成构经斗少些用达力王运直断米选。",
    "attachmentId": "799E0FB1-419b-dEB4-8C88-CAd7e1CCdfeB",
    "status": "审批中",
    "orderResult": "日入办定光持县经近号构压联族办。自经只效题位一务这太达江好约。接属铁层置前利民却制年照结。",
    "applyuser": "吕敏",
    "applyTime": "1984-03-10  08:45:37",
    "orgName": "广温前造",
    "userMobile": "18122538217"
  }
}

{
  "code": "-1",
  "msg": "失败"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	string	true	none	状态码
» msg	string	true	none	消息
» data	object	true	none	none
»» assets	[object]	true	none	none
»»» assetCode	string	true	none	数据编码
»»» objCode	string	true	none	对象英文名
»»» objName	string	true	none	对象中文名
»»» originalSystem	string	true	none	来源系统
»»» provName	string	true	none	省份名称
»» projectName	string	true	none	项目名称
»» projectTime	string	true	none	项目时间
»» users	[object]	true	none	none
»»» userName	string	true	none	用户名
»»» userType	string	true	none	项目角色
»»» predictedStartTime	string	true	none	开始时间
»»» predictedEndTime	string	true	none	结束时间
»»» userDepartmentName	string	true	none	所属公司
»»» userPhone	string	true	none	手机号
»» orderReason	string	true	none	订购原因
»» attachmentId	string	true	none	附件ID
»» status	string	true	none	订购状态
»» orderResult	string	true	none	订购结果
»» applyuser	string	true	none	申请人
»» applyTime	string	true	none	申请时间
»» orgName	string	true	none	所属单位
»» userMobile	string	true	none	联系电话

审计资产管理 v1.0.0

0.公共

POST 业务分类查询

功能描述：根据筛选条件获取系统页面筛选条件码表数据，

涉及页面：审计数据查询页面展现业务分类标签数据

实现逻辑：

返回数据：

请求参数

返回结果

返回数据结构

GET 获取角色接口

功能描述：获取角色信息接口

返回结果

返回数据结构

GET 数据标签列查询

功能描述：根据状态获取数据标签码表

涉及页面：审计数据查询页面展现数据标签

实现逻辑：

返回数据：

sql：

返回结果

返回数据结构

GET 数据标签树查询

功能描述：根据状态获取数据标签码表

涉及页面：审计数据查询页面展现数据标签

实现逻辑：

返回数据：

sql：

返回结果

返回数据结构

GET 获取业务分类统计数

功能描述 查询接口数据按业务类型统计数

涉及页面：

表操作查询

实现逻辑

返回数据

请求参数

返回结果

返回数据结构

POST 文件上传

请求参数

返回结果

返回数据结构

1.审计信息视图

GET 获取审计信息视图统计数

功能描述： 用于【审计信息视图】页面展现【数据总数】部分数据

表操作：查询

实现逻辑：

返回数据：

返回结果

返回数据结构

GET 获取接口层业务归属域统计数

功能描述：用于【审计信息视图】页面展现【接口层业务归属域】部分数据

表操作：查询

实现逻辑：

返回数据：

返回结果

返回数据结构

GET 获取接口层业务归属域来源系统统计数

功能描述：用于【审计信息视图】页面展现【接口层业务归属域】-【来源系统】部分数据

表操作：查询

实现逻辑：

返回数据：

请求参数

返回结果

返回数据结构

2.接口数据视图

GET 接口数据统计

功能描述：用于【接口信息视图】页面展现统计数据

表操作：查询

实现逻辑：

返回数据

返回结果

返回数据结构

POST 接口数据查询

功能描述：用于【接口信息视图】页面展现查询数据

表操作：查询

实现逻辑：

返回数据

请求参数

功能描述 `查询接口数据按业务类型统计数`

表操作`查询`

功能描述： `用于【审计信息视图】页面展现【数据总数】部分数据`

表操作：`查询`

功能描述：`用于【审计信息视图】页面展现【接口层业务归属域】部分数据`

表操作：`查询`

功能描述：`用于【审计信息视图】页面展现【接口层业务归属域】-【来源系统】部分数据`

表操作：`查询`

功能描述：`用于【接口信息视图】页面展现统计数据`

表操作：`查询`

功能描述：`用于【接口信息视图】页面展现查询数据`

表操作：`查询`

功能描述：`用于【审计数据管理-资产详情页面】页面展现开放数据部分（现阶段不使用状态进行条件筛选）`

表操作：`查询`

功能描述：`用于【数据目录】页面展现列表数据`

表操作：`查询`

功能描述：`用于【数据目录】页面展现列表数据`

表操作：`查询`

功能描述：`用于【审计数据管理】页面展现【数据总数、未注册、未上线、已上线】部分数据`

表操作：`查询`

表操作：`查询`

功能描述：`用于【审计数据管理】页面展现【数据总数、未注册、未上线、已上线】部分数据`

表操作：`查询`

表操作：`更新`

功能描述：`用于【注册申请】页面展现【资产信息】部分数据`

表操作：`查询`