文档首页/ ISDP/ API参考/ API接口/ 任务管理/ 任务场景管理/ 新增工序任务场景(API名称:createTaskScene)
更新时间:2024-07-22 GMT+08:00
分享

新增工序任务场景(API名称:createTaskScene)

功能介绍

该接口用于新增工序任务场景,在新增任务时需要优先新增有效的场景

相关接口

接口名称

调用说明

获取Token

调用该接口获取到Token,再调用其他接口时,需要在请求消息头中添加“Authorization”,其值即为Token。

查询任务场景

新增时为防止重复可先进行任务场景的查询,也可以在新增后使用确保新增成功

删除任务场景

新增后如需要删除可使用删除任务场景接口

新增问题类别(API名称:createIssueConfig)

提前预配置好“问题类别”

任务扩展属性列表查询

扩展属性配置中,需提前配置好,可使用该接口查询

查询(上/下级)组织信息(API名称:findPagedOrgListWithDirection)

提前传入“组织单元编码”可使用该接口查询

URL

请求方式

HTTPS地址

服务架构

消息体类型

POST

https://isdp+域名/openapi/v1/openTaskScene/createTaskScene

OpenAPI

application/json

调用流程:

因为任务场景的前置依赖数据较多,成功调用此API需要提前预配置如下信息:

1、 任务管理列表,扩展属性配置中,提前配置好“租户的全局扩展属性”。“任务场景”中写入的“扩展属性”,必须是已配置好的全局扩展属性。

2、 ISDP租户管理员设置,扩展属性配置中,预配置:通用检查作业下,配置“业务类型=作业”;

3、 问题类别配置中,提前预配置好“问题类别”,如创建“问题大类=掘锚工艺”下的问题子类;便于采集模板中,每个条目对应预置的问题类别(调“问题类别创建”API,建好问题类别)

4、 入参中的“组织单元”需要传“组织单元编码”。

请求头

KEY

VALUE

是否必填

描述

Content-Type

application/json

Authorization

bearer ${access_token}

bearer +“ ”+5.2.1中获取的access_token的值

请求参数

参数

类型

是否必填

描述

sceneName

String

场景名称

adminOrganization

String

组织单元编码

sceneMode

Int

只支持任务启用工序模式,传3

taskSceneExtendFieldList入参

参数

类型

是否必填

描述

fieldName

String

场景扩展字段名称

fieldDefaultValue

String

扩展字段的默认值,入参有值,则赋值为扩展字段默认值,没有,则取全局扩展属性配置的默认值

stage

Integer

扩展属性阶段:1创建阶段 2执行阶段,不填写默认为创建阶段

taskSceneModeList入参

参数

类型

是否必填

描述

sceneModeName

String

工序名称

description

String

工序描述,如果该工序配置了模板,工序描述也是kcp的名称

templateName

String

工序关联的模板名称。若工序需要关联模板,则名称要在templateInfoList集合中存在。无需关联则置空(命名规则:“任务场景名称-工序名称”作为检查模板名称)

templateInfoList入参

参数

类型

是否必填

描述

templateName

String

模板名称

kcpList入参

参数

类型

是否必填

描述

name

String

条目名称

operationGuide

String

条目操作指导(500字以内)

qualityStandard

String

条目质量标准(500字以内)

issueType

String

条目采集问题类别,系统中存在。大类和小类用#分割,不同大类用英文分号分割。详见样例请求

severity

Int

问题严重程度。仅支持数字。0-一般;1-重要;2-严重

outputList入参

参数

类型

是否必填

描述

outputType

Int

输出项类型,枚举值:文本,图片

outputName

String

输出项名称

响应参数

参数

类型

描述

stateCode

Int

接口响应码。0代表成功,非0代表失败

errorMessage

String

接口请求错误原因

result

String

需要返回给调用者的数据

请求示例

{
    "sceneName": "掘锚机日常电气检修标准作业流程",
    "adminOrganization": "1001",
    "sceneMode": 3,
    "taskSceneExtendFieldList": [
        {
            "fieldName": "流程编号",
            "fieldDefaultValue": "SHPM-12-A02020201-0001",
            "stage": 1
        },
        {
            "fieldName": "配件",
            "fieldDefaultValue": "",
            "stage": 1
        },
        {
            "fieldName": "材料",
            "fieldDefaultValue": "棉纱(0.2Kg)、防锈油(1桶)、清洗剂(1瓶)。",
            "stage": 1
        },
        {
            "fieldName": "相关事故案例",
            "fieldDefaultValue": "",
            "stage": 1
        },
        {
            "fieldName": "工具",
            "fieldDefaultValue": "万用表(1块)、兆欧表(1块)、一字改锥6X200mm(1把)、十字改锥6X200mm(1把),克丝钳(1把)、便携式甲烷检测报警仪(1部)、8寸活动扳手(1把)、公制内六角扳手(1套)、验电器(1部)、放电绳(1根)、接地线(1根)等。",
            "stage": 1
        },
        {
            "fieldName": "重要危险源",
            "fieldDefaultValue": "1)顶、帮支护不完好,片帮,造成人员伤害。2)未检查瓦斯浓度或瓦斯浓度超限禁止送电。3)未检查瓦斯浓度或瓦斯浓度超限禁止送电。",
            "stage": 1
        },
        {
            "fieldName": "使用频率",
            "fieldDefaultValue": "高",
            "stage": 1
        }
    ],
    "taskSceneModeList": [
        {
            "sceneModeName": "停机、停电",
            "description": "1)掘锚机停止运行;2)掘锚机控制开关手把打到零位。",
            "templateName": "测试openApi导入模板"
        }
    ],
    "templateInfoList": [
        {
            "templateName": "测试openApi导入模板",
            "kcpList": [
                {
                    "children": [
                        {
                            "name": "启动掘锚机",
                            "operationGuide": "【危险源及风险】1)启动前未预警,造成人员伤害;2)启动掘锚机前,未确认周围无人员作业,造成人员伤害。\n【风险值】12\n【风险等级】中等\n【管控措施】设备启动前需发出预警信号,确保设备周边无人时方可启动。",
                            "qualityStandard": "运行正常。",
                            "issueType": "掘锚工艺#工器具不完好或有缺陷,造成事故",
                            "severity": 1,
                            "outputList": [
                                {
                                    "outputType": "文本",
                                    "outputName": "备注"
                                },
                                {
                                    "outputType": "图片",
                                    "outputName": "图片"
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}

响应示例

{
"stateCode": "0",
"errorMessage": null,
"result": null
}

状态码

状态码请参见状态码

错误码

错误码请参见错误码

相关文档