OpenAuth.Net/newdocs/docs/notes/core/flowinstancedev.md

---
title: 流程相关的代码
createTime: 2025/04/23 21:03:10
permalink: /core/flowinstancedev/
---

## 流程审批逻辑

当最终用户在【待处理流程】中审批一个流程实例时，流程实例会经过下面步骤进行处理：

@startuml
skinparam handwritten true
skinparam backgroundColor #EEEBDC

start
if (当前活动节点类型为会签) then (yes)
  :标识当前节点状态;
  :从所有的分支中找到一个用户可以审批的节点canCheckId;
  if (没找到?) then (yes)
    stop
  endif
  :标识canCheckId节点状态;
  #HotPink:进行会签,结果为res;
  if(res == TagState.No) then (yes)
    :修改流程最终状态为不同意;
  else if(res != string.Empty) then (yes)
    stop
  else (no)
    :修改流程最终状态，修改活动节点，修改可执行人;
    :添加扭转记录;
  endif

else (no)
  :标识当前节点状态;
  if (同意) then (yes)
    :修改流程最终状态，修改活动节点，修改可执行人;
    :添加扭转记录;
  else
    :修改流程最终状态为不同意;
  endif
  :操作记录;
endif
stop

@enduml

## 流程模板

流程模板指流程的定义。数据存放在FlowScheme表中，该表核心字段如下：

#### FrmId：流程模版关联的表单id

#### FrmType：表单类型

#### SchemeContent：流程实例的具体内容

该字段存储的是一个JSON对象，具体内容如下所示：

```javascript
{
    "nodes": [
        {
            "type": "node",  //节点类型，开始，普通，网关，会签等
            "name": "任务节点", //节点名称
            "icon": "iconfont icon-jiaoseguanli", //节点图标
            "belongto": "commonNodes", //节点样式类型：普通四边形节点，菱形网关
            "id": "node-011c37dd1db34596b9cbd6812971b8a6", //节点id
            "setInfo": {
                "NodeRejectType": 0, //节点驳回类型：
                "NodeConfluenceType": "", //节点会签/网关类型
                "NodeDesignate": "SPECIAL_ROLE",//执行权限类型：指定角色、指定用户等
                "ThirdPartyUrl": "",//执行完成后回调地址
                "NodeDesignateData": {  //根据NodeDesignate不同，表示不同的权限数据：角色、用户等
                    "datas": [
                        "77e6d0c3-f9e1-4933-92c3-c1c6eef75593"
                    ],
                    "Texts": "神"
                },
                "CanWriteFormItemIds":  //可写表单项id
                [
                    "radio113860", 
                    "radio74071"
                ]
            }
        }
    ],
    "lines": [
        {
            "type": "sl",  //原有gooflow里面的值："sl":直线, "lr":中段可左右移动型折线, "tb":中段可上下移动型折线
            "id": "link-6351c01fd31d4e6d85d476be6e0b0ae2",
            "from": "start-3fcaf7e8577644ff8b52fabaf975437e",
            "to": "node-011c37dd1db34596b9cbd6812971b8a6",
            "label": "值>3",  //连线上面显示的文字
            "cls": {
                "linkType": "Flowchart",
                "linkColor": "#2a2929",
                "linkThickness": 1
            },
            "Compares": [{  //连线条件
                "FieldName": "Age", //表单项id
                "Operation": ">", //条件类型
                "Value": "3" //条件值
            }]
        }, 
        {
            "type": "sl",
            "id": "link-785f8823a60e4472884f482b16c16f26",
            "from": "node-011c37dd1db34596b9cbd6812971b8a6",
            "to": "end-a749ef5b89bb49d588009b71f53316f5",
            "label": "",
            "cls": {
                "linkType": "Flowchart",
                "linkColor": "#2a2929",
                "linkThickness": 1
            }
        }
    ]
}

```
其中：nodes为流程实例的所有节点。lines为流程实例的所有连线。节点属性如下：


###### 基础属性

| 属性名 | 类型 | 说明 | 可选值 |
|--------|------|------|---------|
| type | 字符串 | 节点类型 | start：开始节点<br>node：普通节点<br>fork：分支节点<br>join：合并节点<br>end：结束节点 |
| name | 字符串 | 节点名称 | - |
| icon | 字符串 | 节点图标 | - |
| belongto | 字符串 | 节点样式类型 | - |
| id | 字符串 | 节点id | - |

###### 配置信息(setInfo)

####### 节点驳回配置

| 属性名 | 类型 | 说明 | 可选值 |
|--------|------|------|---------|
| NodeRejectType | 数字 | 节点驳回类型 | 0：前一步<br>1：第一步<br>2：指定节点 |
| NodeRejectStep | 字符串 | 驳回节点id | 当NodeRejectType=2时使用 |

###### 节点会签/网关配置

| 属性名 | 类型 | 说明 | 可选值 |
|--------|------|------|---------|
| NodeConfluenceType | 字符串 | 节点会签/网关类型 | sequential：顺序<br>all：全部通过<br>one：至少一个通过 |

###### 执行权限配置

| 属性名 | 类型 | 说明 | 可选值 |
|--------|------|------|---------|
| NodeDesignate | 字符串 | 执行权限类型 | SPECIAL_ROLE：指定角色<br>SPECIAL_USER：指定用户<br>SPECIAL_SQL：指定SQL<br>RUNTIME_SPECIAL_ROLE：运行时指定角色<br>RUNTIME_SPECIAL_USER：运行时指定用户 |
| NodeDesignateData | 对象 | 执行权限数据 | - |
| NodeDesignateData.datas | 数组 | 执行权限数据 | - |
| NodeDesignateData.Texts | 字符串 | 执行权限数据 | - |

###### 其他配置

| 属性名 | 类型 | 说明 |
|--------|------|------|
| ThirdPartyUrl | 字符串 | 执行完成后回调地址 |
| CanWriteFormItemIds | 数组 | 可写表单项id |


## 流程实例

流程实例指正在运行的一个流程。数据存放在FlowInstance表中，该表核心字段如下：

#### IsFinish：流程的当前状态

- -1 草稿/召回：流程发起人主动召回流程；

- 0 正在运行；

- 1 完成：流程结束，同时所有的审批都通过；

- 3 不同意：即流程结束，同时审批人员没有通过；

- 4 驳回：流程结束，可能发起的流程内容有问题，要求被驳回重新提交；


#### ActivityId: 当前活动节点，即待审批的节点

与流程实例密切相关的还有两个表：流程实例的操作记录FlowInstanceOperationHistory及流转记录FlowInstanceTransitionHistory。它们有不同的作用：

### 操作记录FlowInstanceOperationHistory
该表记录了流程实例的所有操作记录，包括流程的创建、撤回、驳回、同意、不同意等操作。

### 流转记录FlowInstanceTransitionHistory
记录某个流程实例所有已审批的从一个活动节点到下一个活动节点的操作人、操作时间。