文档中心

简体中文

English

简体中文

English

自由提交 ​

接口请求调用说明

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

请求参数：

json
{
  "accessToken": "",
  "workId": "HZ28858f8103505e018113bf63a80505",
  "trackId": "HZ28858f8103505e018113bf63a80506",
  "actionData": {
    "operate": "freesubmit",
    "operateClazz": "com.horizon.wf.action.ActionSubmitForFree",
    "operateFlag": 0,
    "freeNode": {
      "nodeName": "测试自由节点",
      "axisX": "",
      "axisTypeX": "absolute-x",
      "axisY": "",
      "axisTypeY": "absolute-y",
      "authors": {
        "Author": {
          "authorId": "Author",
          "isDefUser": "false",
          "isFree": "true",
          "isSelect": "true",
          "isUser": "false",
          "selectType": "checkbox",
          "selectAuthor": "U_admin/D_HZ28821856ef63420156ef63429c0000",
          "selectAuthorName": "管理员(慧正通软)"
        },
        "SecondAuthor": {
          "authorId": "SecondAuthor",
          "isDefUser": "false",
          "isFree": "true",
          "isSelect": "true",
          "isUser": "false",
          "selectType": "checkbox",
          "selectAuthor": "U_HZ28821856ef63420156ef6342a20002/D_HZ28821856ef63420156ef6342a20001",
          "selectAuthorName": "用户01(测试部门0)"
        },
        "Reader": {
          "authorId": "Reader",
          "isDefUser": "false",
          "isFree": "true",
          "isSelect": "true",
          "isUser": "false",
          "selectType": "checkbox",
          "selectAuthor": "U_HZ28821856ef63420156ef6342a20003/D_HZ28821856ef63420156ef6342a20001",
          "selectAuthorName": "用户02(测试部门0)"
        }
      },
      "timeLimit": "0",
      "timeLimitType": "0"
    }
  }
}
参数是否必须描述
accessToken是调用接口凭证，唯一用户标识
workId是流程实例id
trackId是流程路径id
actionData是流程操作json数据

actionData 数据参数：

参数是否必须描述
operate是自由提交操作标识，固定值freesubmit
operateClazz是自由提交操作类路径，固定值com.horizon.wf.action.ActionSubmitForFree
operateFlag是操作标记，固定值0
freeNode是自由节点信息

freeNode 参数说明：

参数是否必须描述
nodeName是节点名称
axisTypeX否固定值absolute-x
axisX否自由节点生成在页面的横坐标
axisTypeY否固定值absolute-y
axisY否自由节点生成在页面的纵坐标
authors是下一节点办理人对象中key为SecondAuthor、Reader和Author，value值为Author/SecondAuthor/Reader对象参数，没有协办/读者时，参数SecondAuthor/Reader对象参数可以不设置
timeLimit否节点办理时限
timeLimitType否办理时限类型，限定值：0(自然日)、1(工作日)

authors 中 Author/SecondAuthor/Reader 对象参数说明：

参数是否必须描述
authorId否办理人类型id，限定值：Author(主办)、SecondAuthor(协办)、Reader(读者)
isDefUser否流程定义列表中选择
isFree否是否自由选择
isSelect否是否允许选择办理人
isUser否是否只允许选择人员
selectType否人员选择类型，限定值：radio(单选)、checkbox(多选)
selectAuthor是节点已选择办理人id
selectAuthorName是节点已选择办理人名称

返回结果示例：

json
{
  "freeNode": {
    "authors": {},
    "axisTypeX": "absolute-x",
    "axisTypeY": "absolute-y",
    "axisX": "",
    "axisY": "",
    "nodeName": "测试自由节点",
    "timeLimit": "0",
    "timeLimitType": "0"
  },
  "nextNodeId": "Line7~Node6",
  "nextNodes": [
    {
      "authors": {
        "SecondAuthor": {
          "authorFlowVar": "",
          "authorId": "SecondAuthor",
          "authorName": "协办",
          "freeArea": "",
          "isDefUser": "false",
          "isFree": "true",
          "isSelect": "false",
          "isUser": "false",
          "selectAuthor": "U_HZ28821856ef63420156ef6342a20002/D_HZ28821856ef63420156ef6342a20001",
          "selectAuthorName": "用户01(测试部门0)",
          "selectType": "checkbox"
        },
        "Reader": {
          "authorFlowVar": "",
          "authorId": "Reader",
          "authorName": "读者",
          "freeArea": "",
          "isDefUser": "false",
          "isFree": "true",
          "isSelect": "false",
          "isUser": "false",
          "selectAuthor": "U_HZ28821856ef63420156ef6342a20003/D_HZ28821856ef63420156ef6342a20001",
          "selectAuthorName": "用户02(测试部门0)",
          "selectType": "checkbox"
        },
        "Author": {
          "authorFlowVar": "",
          "authorId": "Author",
          "authorName": "主办",
          "freeArea": "",
          "isDefUser": "false",
          "isFree": "true",
          "isSelect": "false",
          "isUser": "false",
          "selectAuthor": "U_admin/D_HZ28821856ef63420156ef63429c0000",
          "selectAuthorName": "管理员(慧正通软)",
          "selectType": "radio"
        }
      },
      "isDone": "false",
      "isSelect": "true",
      "memo": "",
      "nodeGroup": "",
      "nodeId": "Node6",
      "nodeKey": "Line7",
      "nodeName": "测试自由节点",
      "nodeStatus": "0",
      "selectId": "Line7~Node6",
      "selectName": "新路由7(测试自由节点)",
      "timeLimit": "0",
      "timeLimitType": "0"
    }
  ],
  "operate": "freesubmit",
  "operateClazz": "com.horizon.wf.action.ActionSubmitForFree",
  "operateFlag": "0",
  "operateMsg": "提交成功",
  "operateStatus": "success",
  "reOpen": "true",
  "status": 0,
  "trackId": "HZ28858f8103505e018113bf63a80506",
  "workId": "HZ28858f8103505e018113bf63a80505"
}

结果参数说明：

参数类型描述
freeNodeObject自由提交时，自由节点的参数信息
nextNodeIdString自由节点id，自动生成
nextNodesList自由提交参数信息
operateString自由提交操作标识
operateClazzString自由提交操作类路径
operateStatusString流程操作结果
operateFlagString操作标记 -1：显示关闭，0、1：正常提交
operateMsgString返回操作信息
reOpenString是否重新打开
statusint自由提交操作返回状态值
trackIdString流程实例路径id
workIdString流程实例id