创建流程实例
<h5>简要描述</h5>
<ul>
<li>创建工单API接口</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>http://${ip}:8096//workflow/api/startProcess</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST</li>
<li>Content-Type : application/json
<h5>参数示例</h5></li>
</ul>
<pre><code> {
"processKey":"kfw210315200910056" ,
"formData":{
"test1":"值",
"q1":{"label":"系统管理员","value":"d22ae15a56394869924059a9d5867a29"}
},
"variables":{"q1":"d22ae15a56394869924059a9d5867a29"},
"assignee":"admin",
"applyUser":"admin" ,
"processOpinion" : "api创建工单"
}
</code></pre>
<h5>参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">processKey</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>流程key</td>
</tr>
<tr>
<td style="text-align: left;">formData</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">JSON</td>
<td>表单内容键值对key为表单字段唯一键,value 为对应的值如果是枚举类型则值是个map包含value和label</td>
</tr>
<tr>
<td style="text-align: left;">variables</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">JSON</td>
<td>流程变量当第一个节点上有勾选流程变量则需要进行设置,一般是将表单上某个字段作为流程变量</td>
</tr>
<tr>
<td style="text-align: left;">assignee</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>处理人:系统的登录名称</td>
</tr>
<tr>
<td style="text-align: left;">applyUser</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>创建人:系统的登录名称</td>
</tr>
<tr>
<td style="text-align: left;">processOpinion</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>流程日志</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code> {
"errorCode": 0,
"message": "成功",
"time": 1642732525474,
"responseBody": {
"uuid": "1082671",
"processInstanceId": "1082671",
"taskId": "1082684",
"processName": "xsk_test",
"processKey": "kfw210315200910056",
"formId": "kform210701110630398",
"handle": null,
"currentNodeInfo": {
"nodeName": "a",
"nodeId": "UserTask_1p7apma",
"nodeType": "普通",
"assignee": "d22ae15a56394869924059a9d5867a29",
"opinionRequired": "false",
"candidateUsers": [],
"button": {},
"candidateGroups": [],
"signTask": null
},
"nextNodeInfo": [
{
"nodeName": "用户任务",
"nodeId": "Activity_06zxrbg",
"nodeType": "普通",
"assignee": null,
"multiInstCollection": null,
"noUser": false,
"candidateUsers": [],
"candidateGroups": [
"administratorRole"
],
"state": null,
"strategy": null
},
{
"nodeName": "b",
"nodeId": "Activity_0ov0jb7",
"nodeType": "抢单",
"assignee": null,
"multiInstCollection": null,
"noUser": true,
"candidateUsers": [],
"candidateGroups": [
"administratorRole"
],
"state": null,
"strategy": "手动抢单"
}
],
"formData": {
"q1": "d22ae15a56394869924059a9d5867a29",
"test1": "值"
},
"basicFlowInstanceLogList": [
{
"uuid": "bcd88a85a4b846049b284765a80d55ae",
"arritytime": "2022-01-21 10:35:24",
"dealTime": "2022-01-21 10:35:25",
"nodeId": "UserTask_1p7apma",
"nodeName": "a",
"value": "api创建工单",
"key": "保存",
"userName": "系统管理员",
"userUuid": "d22ae15a56394869924059a9d5867a29"
}
],
"processVersion": "kfw210315200910056:70:1055058",
"formVersion": "4",
"formConfigVersion": null,
"externalForm": "true",
"formUri": "viewRender?formKey=kform210701110630398&title=test",
"lastUpdate": "2022-01-21 10:35:24.945",
"debug": false
}
}</code></pre>
<h5>返回参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">errorCode</td>
<td style="text-align: left;">int</td>
<td>报错码:0正常</td>
</tr>
<tr>
<td style="text-align: left;">message</td>
<td style="text-align: left;">String</td>
<td>接口返回提示</td>
</tr>
<tr>
<td style="text-align: left;">responseBody</td>
<td style="text-align: left;">JSON</td>
<td>返回内容</td>
</tr>
<tr>
<td style="text-align: left;">responseBody->uuid</td>
<td style="text-align: left;">String</td>
<td>生成数据的uuid</td>
</tr>
<tr>
<td style="text-align: left;">responseBody->processInstanceId</td>
<td style="text-align: left;">String</td>
<td>流程实例id</td>
</tr>
<tr>
<td style="text-align: left;">responseBody->taskId</td>
<td style="text-align: left;">String</td>
<td>任务id</td>
</tr>
<tr>
<td style="text-align: left;">responseBody->processName</td>
<td style="text-align: left;">String</td>
<td>流程名称</td>
</tr>
<tr>
<td style="text-align: left;">responseBody->processKey</td>
<td style="text-align: left;">String</td>
<td>流程pkey</td>
</tr>
<tr>
<td style="text-align: left;">responseBody->formId</td>
<td style="text-align: left;">String</td>
<td>表单id</td>
</tr>
<tr>
<td style="text-align: left;">responseBody->handle</td>
<td style="text-align: left;">String</td>
<td>当前人是否有处理权限 true:false</td>
</tr>
<tr>
<td style="text-align: left;">responseBody->currentNodeInfo</td>
<td style="text-align: left;">JSON</td>
<td>当前所在节点信息</td>
</tr>
<tr>
<td style="text-align: left;">responseBody->nextNodeInfo</td>
<td style="text-align: left;">JSONArray</td>
<td>下一节点信息</td>
</tr>
<tr>
<td style="text-align: left;">responseBody->formData</td>
<td style="text-align: left;">JSON</td>
<td>表单formData</td>
</tr>
<tr>
<td style="text-align: left;">responseBody->basicFlowInstanceLogList</td>
<td style="text-align: left;">JSONArray</td>
<td>流程日志</td>
</tr>
<tr>
<td style="text-align: left;">responseBody->processVersion</td>
<td style="text-align: left;">String</td>
<td>当前实例所属流程版本</td>
</tr>
<tr>
<td style="text-align: left;">responseBody->formVersion</td>
<td style="text-align: left;">String</td>
<td>当前实例所属表单版本</td>
</tr>
<tr>
<td style="text-align: left;">responseBody->formConfigVersion</td>
<td style="text-align: left;">String</td>
<td>当前实例所属流程节点配置版本</td>
</tr>
<tr>
<td style="text-align: left;">responseBody->externalForm</td>
<td style="text-align: left;">String</td>
<td>是否外部表单</td>
</tr>
<tr>
<td style="text-align: left;">responseBody->formUri</td>
<td style="text-align: left;">String</td>
<td>表单链接</td>
</tr>
<tr>
<td style="text-align: left;">responseBody->lastUpdate</td>
<td style="text-align: left;">String</td>
<td>最后修改时间</td>
</tr>
<tr>
<td style="text-align: left;">responseBody->debug</td>
<td style="text-align: left;">String</td>
<td>当前流程是否是调试模式</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ul>
<li>无</li>
</ul>