# 修改许可单（API名称：openSceneTask/updateWorkTicket）
#### 功能介绍
修改许可单
#### 相关接口
| **接口名称**                                                             | **调用说明**                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 |
   
#### URL
| **请求方式** | **HTTPS地址**                                                     | **服务架构** | **消息体类型**        |
|:---|:---|:---|:---|
| POST     | https://***isdp+域名***/openapi/v1/openSceneTask/updateWorkTicket | OpenAPI  | application/json |
   
#### 请求头
| **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的值 |
   
#### 请求参数
| **参数**                  | **类型**                        | **是否必填** | **描述**    |
|:---|:---|:---|:---|
| ticketId                | Long                          | 是        | 工作票ID     |
| submitForReview         | String                        | 否        | N-保存 Y-提交 |
| sceneTaskIdList         | List\<Long\>                  | 否        | 关联的任务     |
| subTaskId               | Long                          | 否        | 关联的子任务ID  |
| baseWorkTicketModel     | WorkTicketVO                  | 是        | 创建许可单头信息  |
| attributeWorkTicketList | List\<WorkTicketAttributeVO\> | 是        | 扩展字段列表    |
   
WorkTicketVO:
| **参数**                | **类型**             | **是否必填** | **描述**                          |
|:---|:---|:---|:---|
| sceneId               | Long               | 是        | 许可场景主键ID                        |
| sceneCode             | String             | 否        | 许可场景编码                          |
| ticketName            | String             | 是        | 工作票名称                           |
| ticketCode            | String             | 是        | 工作票编码                           |
| adminOrganization     | String             | 否        | 组织单元id                          |
| adminOrganizationName | String             | 否        | 组织单元名称                          |
| workUserPICList       | List\<UserInfoVO\> | 是        | 工作负责人                           |
| reviewRuleId          | Long               | 否        | 评审流ID                           |
| reviewRuleName        | String             | 否        | 评审流名称                           |
| processType           | Integer            | 否        | 审批流类型(0-标准审批流；1-临时审批流；2-自定义审批流) |
| reviewList            | List\<ReviewerVO\> | 否        | 评审流信息                           |
| ticketRemark          | String             | 否        | 工作票描述                           |
| beginTimestamp        | Long               | 否        | 计划开始时间                          |
| endTimestamp          | Long               | 否        | 计划结束时间                          |
   
WorkTicketAttributeVO
| **参数**      | **类型**  | **是否必填** | **描述**              |
|:---|:---|:---|:---|
| id          | Long    | 否        | 扩展字段ID(传入为修改，不传为新增) |
| extendType  | Integer | 否        | 扩展字段类型              |
| extendName  | String  | 否        | 扩展字段名称              |
| extendValue | String  | 否        | 扩展字段值               |
| udfName     | String  | 否        | udf名称               |
| isNecessary | Integer | 否        | 是否必须                |
| fieldOrder  | Integer | 否        | 字段排序                |
   
UserInfoVO:
| **参数**   | **类型**  | **是否必填** | **描述** |
|:---|:---|:---|:---|
| userId   | Long    | 是        | 用户ID   |
| username | String  | 是        | 用户名称   |
| userType | Integer | 是        | 用户类型   |
   
ReviewerVO:
| **参数**         | **类型**  | **是否必填** | **描述**                             |
|:---|:---|:---|:---|
| reviewerId     | Long    | 否        | 审批人id                              |
| reviewerName   | String  | 否        | 审批人名称                              |
| reviewerType   | String  | 否        | 审批人类型                              |
| reviewLevel    | Integer | 否        | 审批层级                               |
| isOnlineReview | Integer | 否        | 是否随机评审： (0：否， 1：是)                 |
| revieweMode    | Integer | 否        | 审批模式 默认0(0-单签， 1-会签)               |
| isEleSign      | Integer | 否        | 是否电子签名 默认0(0-不启用签名， 1-手动签名，2-自动签名) |
| remark         | String  | 否        | 审批层级说明                             |
   
#### 响应参数
| **参数**       | **类型** | **描述**                                                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|
| stateCode    | String | 响应状态码： - 0-成功  - 其他-失败   |
| errorMessage | String | 响应描述                                                                                                                                                                                                                                                                                                                                                                                            |
| result       | Object | 响应结果内容data、分页数据                                                                                                                                                                                                                                                                                                                                                                                 |
   
Result:
| **参数**                | **类型**  | **描述**  |
|:---|:---|:---|
| ticketId              | Long    | 工作票主键ID |
| ticketCode            | String  | 工作票编码   |
| adminOrganization     | String  | 组织单位编码  |
| adminOrganizationName | String  | 组织单位名称  |
| ticketRemark          | String  | 工作票描述   |
| beginTimestamp        | Long    | 计划开始时间  |
| endTimestamp          | Long    | 计划结束时间  |
| ticketName            | String  | 工作票名称   |
| lastUpdateTimestamp   | Long    | 最近更新时间戳 |
| orgPath               | String  | 组织单位路径  |
| lastUpdatedBy         | Long    | 最近更新人   |
| entityName            | String  | 实体名称    |
| affectedRows          | Integer | 影响行数    |
| assignedUserId        | String  | 指定人用户ID |
| assignedUserName      | String  | 指定人用户名称 |
   
#### 请求示例
```
{
    "ticketId": 143294,
    "baseWorkTicketModel": {
        "sceneId": 150699,
        "sceneCode": "许可场景1-1",
        "adminOrganization": "830",
        "adminOrganizationName": "杨凌作业系统测试",
        "ticketName": "许可场景1-1",
        "ticketCode": "许可20240127",
        "beginTimestamp": "",
        "endTimestamp": "",
        "ticketRemark": "",
        "workUserPICList": [
            {
                "userId": 930198,
                "userName": "张三",
                "userType": 1
            }
        ],
        "reviewRuleId": "",
        "reviewRuleName": ""
    },
    "attributeWorkTicketList": [],
    "submitForReview": "Y"
}
```
#### 响应示例
```
{
    "stateCode": "0",
    "errorMessage": null,
    "result": {
        "ticketId": 143294,
        "ticketCode": "许可20240127",
        "adminOrganization": "830",
        "adminOrganizationName": "杨凌作业系统测试",
        "ticketRemark": "",
        "beginTimestamp": null,
        "endTimestamp": null,
        "ticketName": "许可场景1-1",
        "lastUpdateTimestamp": 1706767556303,
        "orgPath": "-1.830",
        "lastUpdatedBy": 930464,
        "entityName": "WorkTicket",
        "affectedRows": 1,
        "assignedUserId": "930198",
        "assignedUserName": "张三"
    }
}
```