文档首页/ 工业数字模型驱动引擎/ API参考/ API/ 流程引擎/ 流程运行/ 保存申请单草稿 - saveAsDraftNew
更新时间:2026-07-28 GMT+08:00
分享

保存申请单草稿 - saveAsDraftNew

功能介绍

本接口用于保存流程申请单的草稿数据,适用于暂存未提交审批的业务申请单信息,支持后续继续编辑或正式提交流程。与启动流程实例 - startProcessInstance接口配合,可实现“草稿保存→编辑完善→正式提交”的完整申请单生命周期管理。

接口约束

  • 本接口支持基础版和体验版数据建模引擎-流程引擎场景。

  • “blockType”为“participant”的区块用于预配置流程启动时的参与者信息,需在流程元模板中预先定义参与者角色(如“MarketingManager”)。

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

POST /console/servicetask/api/localMethod/save_process_draft/saveAsDraftNew

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

IAM用户的token。

通过调用IAM服务获取用户Token接口获取(即响应消息头中X-Subject-Token的值)。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

X-Application-Id

String

参数解释:

应用ID。

您可以在应用设计态的“应用中心 > 应用发布”页面获取,详情请参见应用发布

约束限制:

不涉及。

取值范围:

由英文字母和数字组成,且长度为32个字符。

默认取值:

不涉及。

X-Tenant-Id

String

参数解释:

数据建模引擎运行态租户ID。

您可以从访问流程引擎编排服务的浏览器地址栏中获取。

流程编排服务地址:http://{承载流程编排服务的服务器域名或IP地址}:{流程编排服务的端口号}/{流程编排服务文根}/index.html#/processApplicationForm?tenantId={数据建模引擎运行态租户ID}&applicationId={应用ID}

例如tenantId=-1,表示数据建模引擎运行态默认租户“basicTenant”的租户ID为-1。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

X-User-Id

String

参数解释:

请求当前接口时上下文中的用户ID,即OrgID的用户ID。

通过调用OrgID服务的获取用户信息接口获取。

约束限制:

仅基础版数据建模引擎-流程引擎需要配置此参数。

取值范围:

不涉及。

默认取值:

不涉及。

表2 请求Body参数

参数

是否必选

参数类型

描述

[数组元素]

Array of DefinitionArrayParam objects

参数解释:

启动流程入参集合,包含业务组件、参与者、附件等各类区块数据。数组中至少需包含一个“blockType”为“save_process_draft”的区块。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值

不涉及。

表3 DefinitionArrayParam

参数

是否必选

参数类型

描述

blockType

String

参数解释:

区块类型,用于标识当前数据区块的业务组件类型。

约束限制:

不涉及。

取值范围:

  • attachment:附件组件,用于上传任务相关的附件。

  • participant:设置参与者,用于预配置流程启动时的审批人信息。

  • start_process:启动流程,用于直接启动流程实例。

  • save_process_draft:保存草稿,用于保存申请单草稿数据。

默认取值:

不涉及。

nodeId

String

参数解释:

区块ID,用于标识流程节点在流程模型中的唯一标识。对于“save_process_draft”类型,可传空字符串。

约束限制:

不涉及。

取值范围:

最大长度100字符。

默认取值:

不涉及。

blockId

String

参数解释:

节点ID,用于标识业务组件实例的唯一标识。对于“save_process_draft”类型,可传空字符串。

约束限制:

不涉及。

取值范围:

最大长度100字符。

默认取值:

不涉及。

data

Array of strings

参数解释:

携带数据,包含当前区块需要保存的具体业务数据内容。数据结构取决于“blockType”类型。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

code

Integer

参数解释:

接口返回码,标识接口调用的执行结果。

取值范围:

  • 200:成功。

  • 非200:失败,具体错误码请参见错误码

data

data object

参数解释:

接口响应数据,包含保存草稿后的申请单完整信息。

取值范围:

不涉及。

orderID

String

参数解释:

请求跟踪流水号,用于唯一标识本次接口请求,便于问题排查和链路追踪。

遇到问题时,请提供此ID联系技术支持。

取值范围:

不涉及。

表5 data

参数

参数类型

描述

currentUserCN

String

参数解释:

当前用户名称。

取值范围:

不涉及。

lastUpdateDate

Integer

参数解释:

最后更新日期,Unix时间戳格式。

取值范围:

不涉及。

modifier

String

参数解释:

修改人UUID(Universally Unique Identifier)。

取值范围:

不涉及。

processTemplateName

String

参数解释:

流程模板编号名称,用于标识当前申请单所使用的流程模板。

取值范围:

不涉及。

templateId

String

参数解释:

流程模板编号,用于唯一标识流程模板。与“processTemplateName”通常一致。

取值范围:

不涉及。

currentUserUuid

String

参数解释:

当前用户UUID(Universally Unique Identifier)。

取值范围:

不涉及。

currentUserId

Integer

参数解释:

当前用户ID。

取值范围:

不涉及。

bizSeqExtAttrs

Array of strings

参数解释:

业务对象拓展属性集合,用于存储业务自定义扩展字段。

取值范围:

不涉及。

lastUpdateUserCN

String

参数解释:

最后更新人名称。

取值范围:

不涉及。

scope

String

参数解释:

区域信息,用于标识业务数据所属的区域范围。

取值范围:

不涉及。

rowIdx

Integer

参数解释:

行号索引,用于标识数据在列表中的位置序号。

取值范围:

不涉及。

processTitle

String

参数解释:

流程实例名称,用于展示当前申请单的标题信息。系统默认生成格式为{模板名}_{时间戳}。

取值范围:

不涉及。

bizSeqExtType

String

参数解释:

业务对象拓展类型名称,用于标识业务序列的扩展类型。

取值范围:

不涉及。

creationUserCN

String

参数解释:

创建人名称。

取值范围:

不涉及。

lastUpdatedBy

Integer

参数解释:

最后更新人ID。

取值范围:

不涉及。

creator

String

参数解释:

创建人UUID(Universally Unique Identifier)。

取值范围:

不涉及。

appName

String

参数解释:

应用名称,标识当前申请单所属的应用系统。

取值范围:

不涉及。

entityType

String

参数解释:

关联类型,用于标识申请单与流程的关联关系。

取值范围:

business:表示关联到流程。

processTemplateVersion

String

参数解释:

流程模板版本,用于标识当前申请单使用的流程模板版本号。

取值范围:

不涉及。

holdableList

Array of strings

参数解释:

模型集合,包含当前申请单关联的业务模型类全限定名列表。

取值范围:

不涉及。

finished

Boolean

参数解释:

生命周期状态是否结束,标识当前申请单流程是否已完成。

取值范围:

  • true:是。

  • false:否。

creationDate

Integer

参数解释:

创建日期,Unix时间戳格式。

取值范围:

不涉及。

creationUserUuid

String

参数解释:

创建人UUID(Universally Unique Identifier)。

取值范围:

不涉及。

holderId

Integer

参数解释:

表单Holder ID,用于唯一标识表单数据持有者。

取值范围:

不涉及。

createdBy

Integer

参数解释:

创建人ID。

取值范围:

不涉及。

businessKey

String

参数解释:

业务流水号,用于关联外部业务系统的业务标识。如请求中未传入,系统可能自动生成。

取值范围:

不涉及。

holderType

String

参数解释:

表单Holder类型,用于标识表单数据所属的业务对象类型。

取值范围:

  • business:申请单级别。

  • task:任务级别。

状态码:400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

result

String

结果。

trace_id

String

追踪ID。

请求示例

POST https://dme.cn-north-4.huaweicloud.cn/workflowRuntime/console/servicetask/api/localMethod/save_process_draft/saveAsDraftNew

[ {
  "blockType" : "save_process_draft",
  "nodeId" : "",
  "blockId" : "",
  "data" : [ {
    "processTemplateName" : "ProcessSyyy240307_1",
    "processTemplateVersion" : "4",
    "businessKey" : ""
  } ]
}, {
  "nodeId" : "StartEvent_1",
  "blockType" : "participant",
  "blockId" : "256cf56f",
  "data" : [ {
    "MarketingManager" : "1008600000046223908"
  } ]
}, {
  "nodeId" : "StartEvent_1",
  "blockType" : "attachment",
  "blockId" : "67c0f8e6",
  "data" : [ {
    "id" : "607281682566889472",
    "nodeId" : "StartEvent_1",
    "size" : 32071,
    "fileName" : "findmytask.xlsx",
    "nodeName" : "启动流程",
    "uploadTime" : "2024-03-07 18:40:35",
    "creator" : "hid_fje4j2nvnue3xwp"
  } ]
} ]

响应示例

状态码:200

OK

{
  "code" : 0,
  "data" : {
    "currentUserCN" : "hid_fje4j2nvnue3xwp",
    "lastUpdateDate" : 1710422023229,
    "modifier" : "1008600000065234815",
    "processTemplateName" : "WXR2024031201",
    "templateId" : "WXR2024031201",
    "currentUserUuid" : "1008600000065234815",
    "currentUserId" : 0,
    "bizSeqExtAttrs" : [ ],
    "lastUpdateUserCN" : " ",
    "scope" : null,
    "rowIdx" : -1,
    "processTitle" : "WXR2024031201_2024-03-14T21:13:41.984+0800",
    "bizSeqExtType" : "WfBusinessSeq",
    "id" : "609856930319441920",
    "state" : "DRAFT",
    "creationUserCN" : " ",
    "lastUpdatedBy" : 1008600000065234800,
    "creator" : "1008600000065234815",
    "appName" : "WfWorkflowDemoService",
    "entityType" : "business",
    "processTemplateVersion" : "5",
    "holdableList" : [ "com.huawei.it.plm.workflow.framework.model.WfFormData", "com.huawei.it.plm.workflow.framework.model.WfAttachment", "com.huawei.it.plm.workflow.framework.model.WfBusinessObject" ],
    "finished" : false,
    "creationDate" : 1710422023229,
    "creationUserUuid" : "1008600000065234815",
    "holderId" : 609856930319441900,
    "createdBy" : 1008600000065234800,
    "businessKey" : "P10000548",
    "holderType" : "business"
  },
  "orderID" : "fc9243bb67eb4a8cbe34e6eb87e8e1f7"
}

状态码:400

Bad Request

{
  "error_code" : "500",
  "error_msg" : "origin is not allowed!",
  "result" : "FAIL",
  "trace_id" : "2509bee60b3e40asdf9f741d9e23466a9"
}

状态码

状态码

描述

200

OK

400

Bad Request

错误码

请参见错误码

相关文档