# 隐患录入（API名称：addHiddenTrouble） #### 功能介绍 该接口用于添加隐患。 #### 相关API | **接口名称** | **调用说明** | |:---|:---| | [查询标准隐患列表](https://support.huaweicloud.com/devg-isdp-sr/SRisk_secd_017.html) | 隐患录入时，需要输入关联的标准隐患id，调用该接口获取到关联的标准隐患id。 | | [查询风险点列表](https://support.huaweicloud.com/devg-isdp-sr/SRisk_secd_018.html) | 隐患录入时，需要输入风险点id，调用该接口获取到录入隐患时的风险点id。 | | [查询辨识对象](https://support.huaweicloud.com/devg-isdp-sr/SRisk_secd_019.html) | 隐患录入时，需要输入作业对象id（即辨识对象），调用该接口获取到录入隐患时的作业对象id。 | | [查询隐患扩展字段](https://support.huaweicloud.com/devg-isdp-sr/SRisk_secd_020.html) | 隐患录入时，需要输入隐患扩展字段，调用该接口获取到隐患扩展属性配置。 | #### 调用流程 因为隐患录入时，前置依赖数据较多，成功调用此API需要提前获取预置的如下信息： 1. 隐患所属的标准隐患：通过调用"[查询标准隐患列表](https://support.huaweicloud.com/devg-isdp-sr/SRisk_secd_017.html)"API，获取到标准隐患。 2. 隐患所在风险点：通过调用"[查询风险点列表](https://support.huaweicloud.com/devg-isdp-sr/SRisk_secd_018.html)"API，获取到风险点。 3. 隐患所归属的辨识对象：通过调用"[查询辨识对象](https://support.huaweicloud.com/devg-isdp-sr/SRisk_secd_019.html)"API，获取到辨识对象。 4. 隐患扩展字段：通过调用"[查询隐患扩展字段](https://support.huaweicloud.com/devg-isdp-sr/SRisk_secd_020.html)"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](https://support.huaweicloud.com/devg-isdp-sr/SRisk_secd_014.html)中获取的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：成功 - 其他：失败，其他错误码说明请参考[错误码](https://support.huaweicloud.com/devg-isdp-sr/SRisk_secd_045.html) | | 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" } } } ``` #### 状态码 状态码请参见[状态码](https://support.huaweicloud.com/devg-isdp-sr/SRisk_secd_044.html)。 #### 错误码 错误码请参见[错误码](https://support.huaweicloud.com/devg-isdp-sr/SRisk_secd_045.html)。