文档首页> ISDP> API参考> API接口> 任务管理> 任务场景管理> 新增工序任务场景(API名称:createTaskScene)
更新时间:2024-01-18 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
}

状态码

状态码请参见状态码

错误码

错误码请参见错误码

分享:

    相关文档

    相关产品