Skip to content

获取提交节点

提交流程之前,应先获取能提交的节点。

获取提交节点-返回单节点时

接口请求调用说明

  • HTTP 请求方式:POST
  • 请求地址:http://127.0.0.1:8080/demo/horizon/workflow/rest/flow/support/action.wf

请求参数:

json
{
  "accessToken": "",
  "workId": "HZ28858f8137db82018137ebd76b0032",
  "trackId": "HZ28858f8137db82018137ebd76b0033",
  "actionData": {
    "operate": "submit",
    "operateClazz": "com.horizon.wf.action.ActionSubmit"
  }
}
参数是否必须描述
accessToken调用接口凭证,唯一用户标识
workId流程实例id
trackId流程路径id

actionData 数据参数:

参数是否必须描述
operate提交操作标识,固定值submit
operateClazz提交操作类路径

返回结果示例:

json
{
  "nextNodeId": "Line2~Node2",
  "nextNodes": [
    {
      "authors": {
        "SecondAuthor": {
          "authorFlowVar": "",
          "authorId": "SecondAuthor",
          "authorName": "协办",
          "freeArea": "",
          "isDefUser": "false",
          "isFree": "true",
          "isSelect": "true",
          "isUser": "false",
          "selectType": "checkbox"
        },
        "Reader": {
          "authorFlowVar": "",
          "authorId": "Reader",
          "authorName": "读者",
          "freeArea": "",
          "isDefUser": "false",
          "isFree": "true",
          "isSelect": "true",
          "isUser": "false",
          "selectType": "checkbox"
        },
        "Author": {
          "authorFlowVar": "",
          "authorId": "Author",
          "authorName": "主办",
          "freeArea": "",
          "isDefUser": "false",
          "isFree": "true",
          "isSelect": "true",
          "isUser": "false",
          "selectType": "radio"
        }
      },
      "isDone": "false",
      "isSelect": "true",
      "memo": "",
      "nodeGroup": "",
      "nodeId": "Node2",
      "nodeKey": "Line2",
      "nodeName": "任务2",
      "nodeStatus": "4",
      "selectId": "Line2~Node2",
      "selectName": "路由2(任务2)",
      "timeLimit": "0",
      "timeLimitType": "1"
    }
  ],
  "operate": "submit",
  "operateClazz": "com.horizon.wf.action.ActionSubmit",
  "operateFlag": "0",
  "operateMsg": "请选择办理人",
  "status": 4,
  "workId": "HZ28858f8137db82018137ebd76b0032"
}

结果参数说明:

参数类型描述
nextNodeIdString下一节点id
nextNodesList需要选择的节点列表
operateString提交操作标识
operateTextString操作显示名称
operateFlagString操作标记 -1:显示关闭,0、1:正常提交
operateMsgString返回操作信息
statusint流程操作状态码(0:成功、1:无法获取下一节点、2:提示选择节点、3:办理人为空、4:需要选择人员、5:流程结束、6:子流程未结束、7:流程暂停、8:流程异常终止、9:其他错误提示、16:协办人提交、17:不满足合并节点的离开规则、22:进入规则调用错误、23:离开规则调用错误、24:该节点类型不支持相应的操作、25:启用规则调用错误、26:节点激活失败)
workIdString流程实例id

nextNodes 参数说明:

参数类型描述
authorsMap下节点办理人map中key为SecondAuthor、Reader和Author,value为Author/SecondAuthor/Reader对象参数
isDoneString是否已经走过
isSelectString是否已选择
memoString备注信息
nodeGroupString节点分组,单节点时无值,当前节点有分支节点时,值为上一节点id
nodeIdString节点id
nodeKeyString节点主键
nodeNameString节点名称
nodeStatusString节点状态,限定值:0(成功)、1(选择办理人)、2(选择节点)、3(未找到办理人)、4(未找到下一节点)
selectIdString需要选择的节点id
selectNameString需要选择的节点名称
timeLimitString节点办理时限
timeLimitTypeString办理时限类型,限定值:0(自然日)、1(工作日)

authors 中 Author/SecondAuthor/Reader 参数说明:

参数类型描述
authorFlowVarString流程变量
authorIdString办理人id固定值Author/SecondAuthor/Reader
authorNameString办理人名称:主办,协办,读者
freeAreaString自由选择时的范围
isDefUserString流程定义列表中选择
isFreeString是否自由选择
isSelectString是否允许选择办理人
isUserString是否只允许选择人员
selectAuthorString节点已选择办理人id
selectAuthorNameString节点已选择办理人名称
selectTypeString人员选择类型,限定值:radio(单选)、checkbox(多选)

获取提交节点-返回多节点

接口请求调用说明

  • HTTP 请求方式:POST
  • 请求地址:http://127.0.0.1:8080/demo/horizon/workflow/rest/flow/support/action.wf

请求参数:

json
{
  "accessToken": "",
  "workId": "HZ28858f8137db82018137ebd76b0032",
  "trackId": "HZ28858f8137db82018137ebd76b0033",
  "actionData": {
    "operate": "submit",
    "operateClazz": "com.horizon.wf.action.ActionSubmit"
  }
}

actionData 数据参数:

参数是否必须描述
operate提交操作标识,固定值submit
operateClazz提交操作类路径com.horizon.wf.action.ActionSubmit

返回结果示例:

json
{
  "nextNodeId": "",
  "nextNodes": [
    {
      "authors": {},
      "isDone": "false",
      "isSelect": "false",
      "nodeGroup": "Node1",
      "nodeId": "Node2",
      "nodeKey": "Line2",
      "nodeName": "任务2",
      "nodeStatus": "2",
      "selectId": "Line2~Node2",
      "selectName": "路由2(任务2)"
    },
    {
      "authors": {},
      "isDone": "false",
      "isSelect": "false",
      "nodeGroup": "Node1",
      "nodeId": "Subflow8",
      "nodeKey": "Line11",
      "nodeName": "子流程8",
      "nodeStatus": "2",
      "selectId": "Line11~Subflow8",
      "selectName": "路由11(子流程8)"
    }
  ],
  "operate": "submit",
  "operateClazz": "com.horizon.wf.action.ActionSubmit",
  "operateFlag": "1",
  "operateMsg": "请从列表中选择节点",
  "status": 2,
  "workId": "HZ28858f8137db820181383ef2a300a1"
}

获取提交节点-选取指定节点时

接口请求调用说明

  • HTTP 请求方式:POST
  • 请求地址:http://127.0.0.1:8080/demo/horizon/workflow/rest/flow/support/action.wf

请求参数:

json
{
  "accessToken": "",
  "workId": "HZ28858f8137db820181383ef2a300a1",
  "trackId": "HZ28858f8137db820181383ef2a300a2",
  "actionData": {
    "operate": "submit",
    "operateClazz": "com.horizon.wf.action.ActionSubmit",
    "nextNodes": [
      {
        "isSelect": "true",
        "nodeId": "Node2",
        "nodeKey": "Line2",
        "selectId": "Line2~Node2"
      }
    ]
  }
}

actionData 数据参数:

参数是否必须描述
operate提交操作标识,固定值submit
operateClazz提交操作类路径
nextNodes需要选择的节点列表

nextNodes 参数说明:

参数是否必须描述
isSelect是否已经选择过
nodeId节点id
nodeKey节点路由
selectId需要选择的节点id和路由