文档首页/ 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"
        }
    }
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

相关文档