文档首页/ ISDP/ API参考/ API接口/ 许可(工作票)管理/ 新增许可（API名称：createWorkTicket）
更新时间：2024-01-31 GMT+08:00
查看PDF
分享

新增许可（API名称：createWorkTicket）

功能介绍

该接口用于创建许可单。

相关API

接口名称

调用说明

获取Token

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

URL

请求方式

HTTPS地址

服务架构

消息体类型

POST

https://isdp+域名/openapi/v1/openSceneTask/createWorkTicket

OpenAPI

application/json

请求头

KEY

VALUE

是否必填

描述

Content-Type

application/json

是

无

Authorization

bearer ${access_token}

是

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

请求参数

参数

类型

是否必填

描述

submitForReview

String

是

是否提交（Y-是；N-否）

说明：

此处是否提交不会更新许可的阶段状态，仅更新许可的草稿和发布两种状态。

baseWorkTicketModel

Object

是

许可基础数据

attributeWorkTicketList

List

否

拓展字段列表

baseWorkTicketModel入参：

参数

类型

是否必填

描述

sceneId

Long

是

场景id

sceneCode

String

否

场景编码

adminOrganization

Long

否

组织单元id

adminOrganizationName

String

否

组织单元名称

ticketName

String

是

许可单名称

ticketCode

String

否

许可单编码，可按规则生成

beginTimestamp

Long

否

计划开始时间（时间戳）

endTimestamp

Long

否

计划结束时间（时间戳）

ticketRemark

String

否

许可单备注信息

workUserPICList

List

是

工作负责人列表

reviewRuleId

Long

否

审批流id

reviewRuleName

String

否

审批流名称

reviewList

List

否

审批流列表

workUserPICList入参：

参数

类型

是否必填

描述

userId

Long

否

用户id

userName

String

否

用户名称

userType

Int

否

用户类型:1-个人；2-群组

reviewList入参：

参数

类型

是否必填

描述

reviewerId

Long

否

审批人id

reviewerName

String

否

审批人姓名

reviewLevel

Int

否

审批人层级

isOnlineReview

Int

否

是否抽样审批：0-否；1-是

attributeWorkTicketList入参：

参数

类型

是否必填

描述

extendName

String

否

拓展属性名称

udfName

String

否

Udf名称

fieldOrder

Int

否

字段排序

extendType

Int

否

扩展字段类型(1:文本；2：枚举；3：多枚举；4：日期；5：时间)

extendValue

String

否

拓展属性值

响应参数

参数

类型

描述

stateCode

int

返回状态，0-正常；其他-异常

errorMessage

String

错误消息描述

result

Object

列表详细数据

result出参：

参数

类型

描述

adminOrganizationName

String

组织单元名名称

ticketRemark

String

许可备注

deleteFlag

Int

删除标识：0-否；1-是

ticketPhaseCount

Int

许可阶段数量

sceneCode

String

场景编码

sceneId

Long

场景id

ticketCurrentPhaseOrder

Int

当前阶段序号

licenseSysStatus

Long

系统阶段id

ticketCode

String

许可编码

ticketCurrentPhaseId

Long

当前阶段id

licenseBusiStatus

Long

许可业务状态id

adminOrganization

Long

组织单元id

ticketId

Long

许可id

ticketName

String

许可名称

beginTimestamp

Long

计划开始时间戳

endTimestamp

Long

计划结束时间戳

assignedUserId

Long

执行人id

assignedUserName

String

执行人姓名

ticketPhaseList

List

许可阶段列表

currentPhase

Object

当前阶段

attributeModelList

List

拓展属性列表

reviewRuleResult

Object

审批列表对象

ticketPhaseList、currentPhase出参：

参数

类型

描述

checkBusiType

Int

检查单业务类型

checkOrderId

Long

检查单id

checkOrderType

Int

工作票阶段生成的检查单类型(0：EHS;1:质量检查;2:巡检)

isRejected

Int

是否已驳回（0-否；1-是）

reviewSwitch

Int

是否启用审批开关(1-是 0-否)

sceneInitialStatus

Long

初始状态

sceneSumbmitStatus

Long

提交状态

submitUserName

String

提交人姓名

templateCode

String

模板编码

templateId

Long

模板id

ticketId

Long

许可id

ticketPhaseCode

String

阶段编码

ticketPhaseId

Long

阶段id

ticketPhaseName

String

阶段名称

ticketPhaseOrder

Int

阶段修好

ticketPhaseStatus

Int

许可单阶段状态（1-初始状态,待执行 2-阶段执行中(审批翻转)3-待评审 4-阶段完成）

attributeModelList出参：

参数

类型

描述

ticketId

Long

许可单主键id

sceneTaskId

Long

任务ID，没有则为0

fieldOrder

Int

字段排序

extendName

String

拓展属性名称

extendType

Int

拓展属性类型

extendValue

String

拓展属性的值

fieldOrder

Int

拓展属性序号

udfName

String

Udf的名称

isNecessary

Int

是否必填：0-否；1-是

dataSource

Int

采集数来源(1:SYS 2:APP)

reviewRuleResult出参：

参数

类型

描述

reviewList

List

审批列表

reviewRuleId

Long

审批流id

reviewList出参：

参数

类型

描述

reviewerId

Long

审批人员id

reviewerName

String

审批人姓名

reviewLevel

Int

审批层级

reviewerType

Int

审批人类型

revieweMode

Int

审批模式(0-单签，1-会签)

请求示例

{
    "ticketId": "",
    "baseWorkTicketModel": {
        "sceneId": 99124,
        "sceneCode": "周XX-0302",
        "adminOrganization": "830",
        "adminOrganizationName": "XX作业系统测试",
        "ticketName": "周XX-0302",
        "ticketCode": "",
        "beginTimestamp": "",
        "endTimestamp": 1647273599000,
        "ticketRemark": "任务描述",
        "workUserPICList": [
            {
                "userId": 25773,
                "userName": "霍XX原lichao",
                "userType": 1
            }
        ],
        "reviewList": [
            {
                "reviewerId": 378817,
                "reviewerName": "周XX",
                "reviewLevel": 1,
                "isOnlineReview": 0,
                "reviewerType": "Admin",
                "id": 74758,
                "revieweMode": 0,
                "isEleSign": 0,
                "remark": ""
            },
            {
                "reviewerId": 25804,
                "reviewerName": "刘XX",
                "reviewLevel": 2,
                "isOnlineReview": 0,
                "reviewerType": "Admin",
                "id": 74759,
                "revieweMode": 0,
                "isEleSign": 0,
                "remark": ""
            }
        ],
        "reviewRuleId": 35676,
        "reviewRuleName": "周XX-测试审批流",
        "processType": 0
    },
    "attributeWorkTicketList": [
        {
            "id": "",
            "extendName": "文本",
            "udfName": "UDF1",
            "isNecessary": 1,
            "fieldOrder": 1,
            "extendType": 1,
            "extendValue": "文本"
        },
        {
            "id": "",
            "extendName": "枚举必填",
            "udfName": "UDF2",
            "isNecessary": 1,
            "fieldOrder": 2,
            "extendType": 2,
            "extendValue": "222"
        },
        {
            "id": "",
            "extendName": "多枚举",
            "udfName": "UDF3",
            "isNecessary": 1,
            "fieldOrder": 3,
            "extendType": 3,
            "extendValue": "aaa;bbb"
        }
    ],
    "submitForReview": "Y"
}

响应示例

{
    "stateCode": "0",
    "errorMessage": null,
    "result": {
        "sceneId": 99124,
        "sceneCode": "PS20220302113005046",
        "ticketName": "周XX-0302",
        "ticketCode": "SaasTenant886_20220314_031964",
        "adminOrganization": "830",
        "adminOrganizationName": "XX作业系统测试",
        "ticketRemark": "任务描述",
        "beginTimestamp": null,
        "endTimestamp": 1647273599000,
        "ticketPhaseCount": 3,
        "ticketCurrentPhaseOrder": 1,
        "deleteFlag": 0,
        "tenantId": 886,
        "createdBy": 390841,
        "createName": "zdrun-test",
        "creationDate": "2022-03-14T02:30:39.892+00:00",
        "creationTimestamp": 1647225039861,
        "lastUpdatedBy": 390841,
        "lastUpdateName": "zdrun-test",
        "lastUpdateDate": "2022-03-14T02:30:39.892+00:00",
        "lastUpdateTimestamp": 1647225039861,
        "entityName": "workTicket",
        "ticketId": 88671,
        "appName": "isdp-task-server",
        "affectedRows": 1,
        "assignedUserId": "25773",
        "assignedUserName": "霍XX原lichao",
        "attributeModelList": [
            {
                "ticketId": 88671,
                "sceneTaskId": 0,
                "extendName": "文本",
                "extendType": 1,
                "extendValue": "文本",
                "udfName": "UDF1",
                "fieldOrder": 1,
                "isNecessary": 1,
                "dataSource": 1,
                "deleteFlag": 0,
                "tenantId": 886,
                "lastUpdateDate": "2022-03-14T02:30:39.953+00:00",
                "lastUpdateTimestamp": 1647225039925,
                "lastUpdatedBy": 390841,
                "lastUpdateName": "zdrun-test",
                "creationDate": "2022-03-14T02:30:39.953+00:00",
                "creationTimestamp": 1647225039925,
                "createdBy": 390841,
                "createName": "zdrun-test",
                "entityName": "TaskAttribute",
                "id": 324680,
                "appName": "isdp-task-server",
                "affectedRows": -2
            },
            {
                "ticketId": 88671,
                "sceneTaskId": 0,
                "extendName": "枚举必填",
                "extendType": 2,
                "extendValue": "222",
                "udfName": "UDF2",
                "fieldOrder": 2,
                "isNecessary": 1,
                "dataSource": 1,
                "deleteFlag": 0,
                "tenantId": 886,
                "lastUpdateDate": "2022-03-14T02:30:39.954+00:00",
                "lastUpdateTimestamp": 1647225039925,
                "lastUpdatedBy": 390841,
                "lastUpdateName": "zdrun-test",
                "creationDate": "2022-03-14T02:30:39.954+00:00",
                "creationTimestamp": 1647225039925,
                "createdBy": 390841,
                "createName": "zdrun-test",
                "entityName": "TaskAttribute",
                "id": 324681,
                "appName": "isdp-task-server",
                "affectedRows": -2
            },
            {
                "ticketId": 88671,
                "sceneTaskId": 0,
                "extendName": "多枚举",
                "extendType": 3,
                "extendValue": "aaa;bbb",
                "udfName": "UDF3",
                "fieldOrder": 3,
                "isNecessary": 1,
                "dataSource": 1,
                "deleteFlag": 0,
                "tenantId": 886,
                "lastUpdateDate": "2022-03-14T02:30:39.954+00:00",
                "lastUpdateTimestamp": 1647225039925,
                "lastUpdatedBy": 390841,
                "lastUpdateName": "zdrun-test",
                "creationDate": "2022-03-14T02:30:39.954+00:00",
                "creationTimestamp": 1647225039925,
                "createdBy": 390841,
                "createName": "zdrun-test",
                "entityName": "TaskAttribute",
                "id": 324682,
                "appName": "isdp-task-server",
                "affectedRows": -2
            }
        ],
        "ticketPhaseList": [
            {
                "ticketId": 88671,
                "ticketPhaseName": "阶段1",
                "ticketPhaseOrder": 1,
                "ticketPhaseStatus": 1,
                "isRejected": 0,
                "templateCode": "QC2022XXXXXXXXXXXXX",
                "templateId": 221760,
                "reviewSwitch": 1,
                "reviewRuleId": 35676,
                "sceneInitialStatus": 1084,
                "sceneReviewStatus": 1170,
                "sceneSumbmitStatus": 1085,
                "ticketPhaseCode": "50412",
                "deleteFlag": 0,
                "tenantId": 886,
                "createdBy": 390841,
                "createName": "zdrun-test",
                "creationDate": "2022-03-14T02:30:39.980+00:00",
                "creationTimestamp": 1647225039959,
                "lastUpdatedBy": 390841,
                "lastUpdateName": "zdrun-test",
                "lastUpdateDate": "2022-03-14T02:30:39.980+00:00",
                "lastUpdateTimestamp": 1647225039959,
                "initialSystemStatusCode": "1",
                "initialStatus": 1084,
                "entityName": "workTicketPhase",
                "ticketPhaseId": 239405,
                "appName": "isdp-task-server",
                "affectedRows": 1,
                "checkOrderId": 5762624,
                "checkOrderType": 1,
                "checkBusiType": "许可01"
            },
            {
                "ticketId": 88671,
                "ticketPhaseName": "阶段2",
                "ticketPhaseOrder": 2,
                "ticketPhaseStatus": 1,
                "isRejected": 0,
                "templateCode": "QC2022XXXXXXXXXXXXX",
                "templateId": 221760,
                "reviewSwitch": 0,
                "reviewRuleId": null,
                "sceneInitialStatus": 1170,
                "sceneReviewStatus": null,
                "sceneSumbmitStatus": 1086,
                "ticketPhaseCode": "50413",
                "deleteFlag": 0,
                "tenantId": 886,
                "createdBy": 390841,
                "createName": "zdrun-test",
                "creationDate": "2022-03-14T02:30:39.980+00:00",
                "creationTimestamp": 1647225039959,
                "lastUpdatedBy": 390841,
                "lastUpdateName": "zdrun-test",
                "lastUpdateDate": "2022-03-14T02:30:39.980+00:00",
                "lastUpdateTimestamp": 1647225039959,
                "initialSystemStatusCode": "1",
                "initialStatus": 1170,
                "entityName": "workTicketPhase",
                "ticketPhaseId": 239406,
                "appName": "isdp-task-server",
                "affectedRows": -2,
                "checkOrderId": 5762625,
                "checkOrderType": 1,
                "checkBusiType": "许可01"
            },
            {
                "ticketId": 88671,
                "ticketPhaseName": "阶段3",
                "ticketPhaseOrder": 3,
                "ticketPhaseStatus": 1,
                "isRejected": 0,
                "templateCode": "QC2022XXXXXXXXXXXXX",
                "templateId": 221760,
                "reviewSwitch": 0,
                "reviewRuleId": null,
                "sceneInitialStatus": 1086,
                "sceneReviewStatus": null,
                "sceneSumbmitStatus": 1088,
                "ticketPhaseCode": "50414",
                "deleteFlag": 0,
                "tenantId": 886,
                "createdBy": 390841,
                "createName": "zdrun-test",
                "creationDate": "2022-03-14T02:30:39.980+00:00",
                "creationTimestamp": 1647225039959,
                "lastUpdatedBy": 390841,
                "lastUpdateName": "zdrun-test",
                "lastUpdateDate": "2022-03-14T02:30:39.980+00:00",
                "lastUpdateTimestamp": 1647225039959,
                "initialSystemStatusCode": "2",
                "initialStatus": 1086,
                "entityName": "workTicketPhase",
                "ticketPhaseId": 239407,
                "appName": "isdp-task-server",
                "affectedRows": -2,
                "checkOrderId": 5762626,
                "checkOrderType": 1,
                "checkBusiType": "许可01"
            }
        ],
        "currentPhase": {
            "ticketId": 88671,
            "ticketPhaseName": "阶段1",
            "ticketPhaseOrder": 1,
            "ticketPhaseStatus": 1,
            "isRejected": 0,
            "templateCode": "QC2022XXXXXXXXXXXXX",
            "templateId": 221760,
            "reviewSwitch": 1,
            "reviewRuleId": 35676,
            "sceneInitialStatus": 1084,
            "sceneReviewStatus": 1170,
            "sceneSumbmitStatus": 1085,
            "ticketPhaseCode": "50412",
            "deleteFlag": 0,
            "tenantId": 886,
            "createdBy": 390841,
            "createName": "zdrun-test",
            "creationDate": "2022-03-14T02:30:39.980+00:00",
            "creationTimestamp": 1647225039959,
            "lastUpdatedBy": 390841,
            "lastUpdateName": "zdrun-test",
            "lastUpdateDate": "2022-03-14T02:30:39.980+00:00",
            "lastUpdateTimestamp": 1647225039959,
            "initialSystemStatusCode": "1",
            "initialStatus": 1084,
            "entityName": "workTicketPhase",
            "ticketPhaseId": 239405,
            "appName": "isdp-task-server",
            "affectedRows": 1,
            "checkOrderId": 5762624,
            "checkOrderType": 1,
            "checkBusiType": "许可01"
        },
        "ticketCurrentPhaseId": 239405,
        "licenseSysStatus": "1",
        "licenseBusiStatus": 1084,
        "reviewRuleResult": {
            "reviewList": [
                {
                    "reviewerId": 378817,
                    "reviewerName": "周？？",
                    "reviewLevel": 1,
                    "reviewerType": "Admin",
                    "revieweMode": 0,
                    "isEleSign": 0,
                    "remark": "",
                    "isOnlineReview": 0,
                    "deleteFlag": null
                },
                {
                    "reviewerId": 25804,
                    "reviewerName": "刘XX",
                    "reviewLevel": 2,
                    "reviewerType": "Admin",
                    "revieweMode": 0,
                    "isEleSign": 0,
                    "remark": "",
                    "isOnlineReview": 0,
                    "deleteFlag": null
                }
            ],
            "reviewRuleId": 35676
        }
    }
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

相关文档