# 创建风险管控任务（API名称：createRiskControlTask） #### 功能介绍 该接口用于创建风险管控任务。 #### 相关API | **接口名称** | **调用说明** | |:---|:---| | [查询风险辨识库](https://support.huaweicloud.com/devg-isdp-sr/SRisk_secd_029.html) | 创建风险管控任务时，需要风险和措施相关信息，调用该接口获取到风险和措施相关信息。 | #### 调用流程 因为创建风险管控任务时，前置依赖数据较多，成功调用此API需要提前获取预置的如下信息： 创建风险管控任务涉及到的风险和措施信息：通过调用"[查询风险辨识库](https://support.huaweicloud.com/devg-isdp-sr/SRisk_secd_029.html)"API，获取到风险和措施信息。 #### URL | **请求方式** | **HTTPS地址** | **消息体类型** | |:---|:---|:---| | POST | https://***AppCube域名***/service/ISDP__SecurityRiskBO/1.0.1/createRiskControlTask | 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的值。 | #### 请求参数 | **参数** | **类型** | **是否必填** | **描述** | |:---|:---|:---|:---| | templateName | String | 否 | 检查单模板名称，自动生成规则：FXJCD+时间戳 | | locationId | String | 是 | 风险点id | | locationCode | String | 是 | 风险点编码 | | locationName | String | 是 | 风险点名称 | | riskIdentityList | Object | 是 | 辨识风险列表 | | controlSceneName | String | 否 | 管控场景名称，自动生成规则：GKCJ+时间戳 | | adminOrganizationName | String | 是 | 组织名称 | | adminOrganizationCode | Number | 是 | 组织id | | sceneRemark | String | 否 | 场景描述 | | controlTaskName | String | 否 | 管控任务名称，自动生成规则：GKRW+时间戳 | | taskBasicAttribute | TaskBasicField | 否 | 管控任务基础属性 | | planBeginDate | Number | 否 | 计划开始时间，毫秒级 | | planEndDate | Number | 否 | 计划结束时间，毫秒级 | | shifts | String | 否 | 班次 | | controlType | String | 否 | 管控类型 | | todoUrlPC | String | 否 | PC端待办页面地址，不传时默认双预控预置页面 | | todoUrlAPP | String | 否 | APP端待办页面地址，不传时默认双预控预置页面 | | taskExtendFieldList | TaskExtendField | 否 | 任务扩展属性列表，需要系统中存在该扩展属性 | | userId | String | 否 | 用户id，输入后替换上下文用户id | taskExtendFieldList参数说明 | **参数** | **类型** | **是否必填** | **描述** | |:---|:---|:---|:---| | fieldName | String | 否 | 扩展属性名称 | | extendValue | String | 否 | 扩展属性值 | taskBasicAttribute参数说明 | **参数** | **类型** | **是否必填** | **描述** | |:---|:---|:---|:---| | signSiteId | Number | 否 | 作业对象ID | | signSiteName | String | 否 | 作业对象名称 | | signSiteCode | String | 否 | 作业对象编码 | | administrativeDivisionName | String | 否 | 行政区域 | | address | String | 否 | 任务地址 | | projectName | String | 否 | 项目名称 | | projectNo | String | 否 | 项目编码 | | supplierName | String | 否 | 供应商 | | customerId | Number | 否 | 客户ID | | customerName | String | 否 | 客户名称 | | jobDuration | String | 否 | 标准作业时长 | | projectDuration | String | 否 | 工期 | | requiredStartTime | Number | 否 | 要求开始时间 | | requiredEndTime | Number | 否 | 要求完成时间 | | skill | String | 否 | 要求技能 | | schedulingMode | String | 否 | 调度模式 | | taskDescription | String | 否 | 任务描述 | | ccPersonType | Number | 否 | 抄送人员类型： - 4：单个人员 - 6：群组 | | ccPerson | String | 否 | 抄送人员名称，单个人员账号或群组名称 | | ownerType | Number | 否 | 责任人员类型： - 5：单个人员 - 7：群组 | | owner | String | 否 | 责任人员名称，单个人员账号或群组名称 | FileItem参数说明 | **参数** | **类型** | **是否必填** | **描述** | |:---|:---|:---|:---| | fileId | Number | 否 | 文件id | | fileName | String | 否 | 文件名称 | | fileType | String | 否 | 文件类型 | | fileSize | Number | 否 | 文件大小 | #### 响应参数 | **参数** | **类型** | **描述** | |:---|:---|:---| | resCode | String | 响应状态码 - 0：成功 - 其他：失败，其他错误码说明请参考[错误码](https://support.huaweicloud.com/devg-isdp-sr/SRisk_secd_045.html) | | resMsg | String | 响应描述，如果成功状态，通常会返回"成功"，其他情况返回具体的错误信息 | | result | Object | 响应结果内容 | result参数说明 | **参数** | **类型** | **描述** | |:---|:---|:---| | taskId | Number | 任务id | | taskName | String | 任务名称 | | taskSceneName | String | 任务场景名称 | | templateName | String | 检查单模板名称 | #### 请求示例 ``` { "locationId": "187252", "locationCode": "CN", "locationName": "中国", "planBeginDate": 1684392034841, "planEndDate": 1684564834841, "shifts": "早班", "controlType": "领导带班检查", "riskIdentityList": [ { "checkItem": "检查项目1", "consequenceValue": 40, "controllDiscipline": "管控岗位1", "controllPeriod": null, "createBy": "10gg000000vgy8jvpTmF", "createDate": "2022-11-24 17:36:39", "createdByName": "XXXXXX", "exposureRate": 10, "facsNum": 2, "id": "cslU000000yhILG5V4gi", "identifyingObjects ": null, "index": 3, "jobObjectCode": "", "jobObjectId": null, "jobObjectName": "", "locationCode": null, "locationId": null, "locationName": null, "orgUnit": "值班室", "possibilityRate": 1, "riskDesc": "测试检查单引入风险问题", "riskFactor": "危险因素", "riskId": "", "riskLevel": "重大风险", "riskOrganUnitCode": "", "riskOrganUnitID": 35329, "riskRatingModelType": null, "riskStatus": 0, "riskType": "测试1", "riskValue": 400, "solutionList": [ { "controlSource": "测试租户", "id": "cgSW000000yhILG6dTCy", "sectionClauses": "每天", "solutionDesc": "1.事故发生后，事故现场人员立即汇报作业区说明地点、人员伤亡情况。2、安排专人接救护车。3、实行应急预案措施进行救治。4、保护好事故现场，必要时在事故现场周围建立警戒区域，现场紧急疏散，人员清点，传达紧急信息，事故调查等。5、报告电话：********；急救：120。" }, { "controlSource": "测试租户", "id": "cgSW000000yhILGDjRSa", "sectionClauses": "每天", "solutionDesc": "每年由矿特种设备管理人员负责联系鞍山市特种设备检验机构对电梯检验保证安全装置齐全有效；" } ] }, { "checkItem": "采煤工作面", "consequenceValue": 0, "controllDiscipline": "采煤", "controllPeriod": "", "createBy": "10gg000000vgy8jvpTlB", "createDate": "2023-05-16 14:19:13", "createdByName": "nara", "exposureRate": 0, "facsNum": 7, "id": "cslU0000013KCbh7XgCe", "identifyingObjects ": null, "index": 0, "jobObjectCode": null, "jobObjectId": null, "jobObjectName": null, "locationCode": "CN", "locationId": 187252, "locationName": "中国", "orgUnit": "皮带运输队", "possibilityRate": 0, "riskDesc": "XX0516-2", "riskFactor": "可能，但不经常", "riskId": "", "riskLevel": "低风险", "riskOrganUnitCode": null, "riskOrganUnitID": 35320, "riskRatingModelType": "LEC", "riskStatus": 0, "riskType": "瓦斯", "riskValue": 0, "solutionList": [ { "controlSource": "综采队", "id": "cgSW0000013KCbhN9cMC", "sectionClauses": "每天", "solutionDesc": "XX111XX222" }, { "controlSource": "综采队", "id": "cgSW0000013KCbhekkQC", "sectionClauses": "每天", "solutionDesc": "XX112" }, { "controlSource": "综采队", "id": "cgSW0000013KCbhh1XSi", "sectionClauses": "每天", "solutionDesc": "XX113" }, { "controlSource": "综采队", "id": "cgSW0000013KCbhj0jNA", "sectionClauses": "每天", "solutionDesc": "XX114" } ] } ], "adminOrganizationName": "测试租户", "adminOrganizationCode": 25245, "userId": "10gg000000xAaVtxKetU" } ``` #### 响应示例 ``` { "resCode": "0", "resMsg": "成功", "result": { "taskId": 3284601, "taskName": "GKRW1684727505209", "taskSceneName": "GKCJ1684727503676", "templateName": "FXJCD1684727501031" } } ``` #### 状态码 状态码请参见[状态码](https://support.huaweicloud.com/devg-isdp-sr/SRisk_secd_044.html)。 #### 错误码 错误码请参见[错误码](https://support.huaweicloud.com/devg-isdp-sr/SRisk_secd_045.html)。