文档首页/ ISDP/ 双预控/ API/ 隐患排查治理/ 隐患录入/ 隐患录入(API名称:addHiddenTrouble)
更新时间:2023-06-16 GMT+08:00
分享

隐患录入(API名称:addHiddenTrouble)

功能介绍

该接口用于添加隐患。

相关API

接口名称

调用说明

查询标准隐患列表

隐患录入时,需要输入关联的标准隐患id,调用该接口获取到关联的标准隐患id。

查询风险点列表

隐患录入时,需要输入风险点id,调用该接口获取到录入隐患时的风险点id。

查询辨识对象

隐患录入时,需要输入作业对象id(即辨识对象),调用该接口获取到录入隐患时的作业对象id。

查询隐患扩展字段

隐患录入时,需要输入隐患扩展字段,调用该接口获取到隐患扩展属性配置。

调用流程

因为隐患录入时,前置依赖数据较多,成功调用此API需要提前获取预置的如下信息:

  1. 隐患所属的标准隐患:通过调用“查询标准隐患列表”API,获取到标准隐患。
  2. 隐患所在风险点:通过调用“查询风险点列表”API,获取到风险点。
  3. 隐患所归属的辨识对象:通过调用“查询辨识对象”API,获取到辨识对象。
  4. 隐患扩展字段:通过调用“查询隐患扩展字段”API,获取到扩展属性的配置。

URL

请求方式

HTTPS地址

消息体类型

POST

https://AppCube域名/service/ISDP__SecurityRiskBO/1.0.1/addHiddenTrouble

application/json

请求头

参数

类型

是否必填

描述

Content-Type

String

请求体内容类型。

填写为:application/json

access-token

String

调用API要用到的访问令牌获取access_token中获取的access_token的值。

请求参数

参数

类型

是否必填

描述

action

Number

  • 0:保存草稿
  • 1:提交

issueItemId

String

关联的标准隐患id

creatorDescribe

String

隐患描述

issueLevel

Number

隐患级别:

  • 3-重大隐患
  • 4-一般隐患A
  • 5-一般隐患B
  • 6-一般隐患C

issueHandlerId

String

处理人id,多人使用‘;’间隔

说明:

不指定处理人时传空字符串或者不传。

checkUserId

String

检查人id,多人使用‘;’间隔

acceptanceUserId

String

验收人id,多人使用‘;’间隔

supervisedUserId

String

监督人id,多人使用‘;’间隔

regionId

String

风险点id

issueAttachmentList

Attachment

附件列表

signSiteId

Number

作业对象id

dueTimestamp

Number

计划完成时间戳,毫秒

issueTypeFather

String

隐患大类,格式示例:‘父类别1;父类别2’

issueType

String

隐患小类,格式示例:‘父类别1#子类别1;父类别1#子类别2;父类别2’

checkCategory

String

检查类别,隐患扩展字段枚举值,需要先查询枚举值范围

hiddenMajor

String

隐患专业,隐患扩展字段枚举值,需要先查询枚举值范围

checkDate

String

检查日期时间戳,毫秒

rectificationType

String

整改类型:

1:限期整改

2:现场整改

rectificationSolution

String

整改措施

rectificationFunds

String

整改资金

resource

String

来源

submitterAccount

String

操作人账号,不传时默认从上下文获取

todoUrlPC

String

PC端待办页面地址,不传时默认双预控预置页面

todoUrlAPP

String

APP端待办页面地址,不传时默认双预控预置页面

issueAttachmentList参数说明

参数

类型

是否必填

描述

fileId

Number

文件id

fileName

String

文件名称

响应参数

参数

类型

描述

resCode

String

响应状态码

  • 0:成功
  • 其他:失败,其他错误码说明请参考错误码

resMsg

String

响应描述,如果成功状态,通常会返回“成功”,其他情况返回具体的错误信息

result

Object

响应结果内容

result参数说明

参数

类型

描述

issueInfo

Object

创建成功的隐患信息

请求示例

{
    "action":1,
    "issueItemId":"cuCe0000013Dhjcbmd6W",
    "creatorDescribe":"cs0519-5",
    "issueLevel":3,
    "issueHandlerId":"288762;891419",
    "checkUserId":"288762;891419",
    "acceptanceUserId":"288762;891419",
    "supervisedUserId":"288762;891419",
    "regionId":"187252",
    "issueAttachmentList":[{
        "fileId":7566519,
        "fileName":"头像528k.jpg"
    }],
    "signSiteId":99064876,
    "dueTimestamp":1683907200000,
    "issueTypeFather":"类别3",
    "issueType":"类别3#通风;",
    "checkCategory":"每月检查",
    "hiddenMajor":"采煤",
    "checkDate":"1683849600000",
    "rectificationType":"1",
    "rectificationSolution":"整改措施",
    "rectificationFunds":"11111",
    "resource":"来源",
    "submitterAccount":"XXXXXX@isdp",
    "todoUrlPC":"xxxxxx",
    "todoUrlAPP":"xxxxxx"
}

响应示例

{
    "resCode": "0",
    "resMsg": "成功",
    "result": {
        "issueInfo": {
            "acceptanceUserList": [
                {
                    "userId": 288762,
                    "userType": 1
                },
                {
                    "userId": 891419,
                    "userType": 1
                }
            ],
            "action": 1,
            "adminOrganization": "35320",
            "adminOrganizationName": "XXXXXX",
            "affectedRows": 1,
            "appName": "isdp-qc-server",
            "checkUserList": [
                {
                    "userId": 288762,
                    "userType": 1
                },
                {
                    "userId": 891419,
                    "userType": 1
                }
            ],
            "code": "Issue20230522178888",
            "createName": "XXX",
            "createdBy": 288762,
            "creationDate": "2023-05-22 17:11:52",
            "creationTimestamp": 1684746711412,
            "creatorDescribe": "cs0519-5",
            "deleteFlag": 0,
            "dueTimestamp": 1683907200000,
            "entityName": "taskIssue",
            "issueAttachmentList": [
                {
                    "fileId": 7566519,
                    "fileName": "头像528k.jpg",
                    "fileType": "jpg"
                }
            ],
            "issueAttributeModel": {
                "udf1": "采煤",
                "udf2": "每月检查",
                "udf3": "1683849600000",
                "udf4": "1",
                "udf5": "整改措施",
                "udf6": "11111",
                "udf7": "来源"
            },
            "issueCarbonCopyList": [],
            "issueHandlerId": "288762;891419",
            "issueHandlerName": "XXX;XXX",
            "issueHandlerSupplierName": "--;--",
            "issueId": 373311,
            "issueInstance": "1",
            "issueItemId": "cuCe0000013Dhjcbmd6W",
            "issueLevel": 3,
            "issueRemark": null,
            "issueSource": "5",
            "issueType": "类别3#通风;",
            "issueTypeCode": "UDF8",
            "issueTypeFather": "类别3",
            "itemId": null,
            "itemName": null,
            "kcpId": null,
            "kcpName": null,
            "lastUpdateBy": 288762,
            "lastUpdateDate": "2023-05-22 17:11:52",
            "lastUpdateName": "XXX",
            "lastUpdatedBy": 288762,
            "operUserId": null,
            "operUserName": null,
            "orgPath": "-1.25245.35320",
            "problemPlanFinishDate": "2023-05-13",
            "regionId": 187252,
            "regionName": "中国",
            "regionPath": "187252",
            "riskList": [],
            "sceneTaskId": null,
            "signSiteCode": "shuNanj",
            "signSiteId": 99064876,
            "signSiteName": "shu南京华为门店",
            "slaStatus": 1,
            "status": 2,
            "submitPending": 0,
            "supervisedUserList": [
                {
                    "userId": 288762,
                    "userType": 1
                },
                {
                    "userId": 891419,
                    "userType": 1
                }
            ],
            "taskId": null,
            "templateId": null,
            "tenantId": 1745,
            "thirdUrl": "xxxxxx",
            "udf1": "采煤",
            "udf10": null,
            "udf11": null,
            "udf12": null,
            "udf13": null,
            "udf14": null,
            "udf15": null,
            "udf16": null,
            "udf17": null,
            "udf18": null,
            "udf19": null,
            "udf2": "每月检查",
            "udf20": null,
            "udf3": "1683849600000",
            "udf4": "1",
            "udf5": "整改措施",
            "udf6": "11111",
            "udf7": "来源",
            "udf8": null,
            "udf9": null,
            "url": "xxxxxx"
        }
    }
}

状态码

状态码请参见状态码

错误码

错误码请参见错误码

相关文档