文档首页/ISDP/双预控/API/风险分级管控/风险管控任务创建/创建风险管控任务（API名称：createRiskControlTask）
更新时间：2023-06-16 GMT+08:00
查看PDF
分享

创建风险管控任务（API名称：createRiskControlTask）

功能介绍

该接口用于创建风险管控任务。

相关API

接口名称

调用说明

查询风险辨识库

创建风险管控任务时，需要风险和措施相关信息，调用该接口获取到风险和措施相关信息。

调用流程

因为创建风险管控任务时，前置依赖数据较多，成功调用此API需要提前获取预置的如下信息：

创建风险管控任务涉及到的风险和措施信息：通过调用“查询风险辨识库”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中获取的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：成功
  • 其他：失败，其他错误码说明请参考错误码

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"
    }
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

相关文档