新增工序任务场景(API名称:createTaskScene)
功能介绍
该接口用于新增工序任务场景,在新增任务时需要优先新增有效的场景
相关接口
|
接口名称 |
调用说明 |
|---|---|
|
调用该接口获取到Token,再调用其他接口时,需要在请求消息头中添加“Authorization”,其值即为Token。 |
|
|
新增时为防止重复可先进行任务场景的查询,也可以在新增后使用确保新增成功 |
|
|
新增后如需要删除可使用删除任务场景接口 |
|
|
提前预配置好“问题类别” |
|
|
扩展属性配置中,需提前配置好,可使用该接口查询 |
|
|
提前传入“组织单元编码”可使用该接口查询 |
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
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。