# 新增工序任务场景（API名称：createTaskScene）
#### 功能介绍
该接口用于新增工序任务场景，在新增任务时需要优先新增有效的场景
#### 相关接口
| **接口名称**                                                                                                       | **调用说明**                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html)                                           | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 |
| [查询任务场景](https://support.huaweicloud.com/api-isdp/api_01_0024.html)                                            | 新增时为防止重复可先进行任务场景的查询，也可以在新增后使用确保新增成功                          |
| [删除任务场景](https://support.huaweicloud.com/api-isdp/api_01_0023.html)                                            | 新增后如需要删除可使用删除任务场景接口                                          |
| [新增问题类别（API名称：createIssueConfig）](https://support.huaweicloud.com/api-isdp/api_01_0181.html)                   | 提前预配置好"问题类别"                                                 |
| [任务扩展属性列表查询](https://support.huaweicloud.com/api-isdp/api_01_0027.html)                                        | 扩展属性配置中，需提前配置好，可使用该接口查询                                      |
| [查询(上/下级)组织信息（API名称：findPagedOrgListWithDirection）](https://support.huaweicloud.com/api-isdp/api_01_0257.html) | 提前传入"组织单元编码"可使用该接口查询                                         |
   
#### 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](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的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
}
```
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。
#### 错误码
错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。