codewave-openclaw-installer 1.0.0

package/skills/smart-customer-service/docs/codewave/20./345/272/224/347/224/250/345/274/200/345/217/221/20./346/265/201/347/250/213/350/256/276/350/256/241/20./346/265/201/347/250/2132.0/70./346/265/201/347/250/213/351/200/273/350/276/221/344/275/277/347/224/250/350/257/264/346/230/216.md

@@ -0,0 +1,2085 @@
+# 流程逻辑使用说明
+
+平台从3.13版本开始以依赖库的形式提供流程2.0的流程逻辑，以更加便捷、易用的使用方式帮助应用开发者快速搭建一些个性化的流程使用场景。
+
+> 关于3.13版本的流程改动请阅读：[流程依赖库说明](../20.流程2.0/975.流程依赖库说明.md)。
+
+流程逻辑可以在页面或服务端逻辑中调用，功能入口：**调用逻辑组件 > 服务端逻辑 > lcap_process_framework**。
+
+<img src="../assets/liuchengluojishiyongshuoming_202504071425_1.png" class="imgStyle" style="width:450px;" />
+
+## 逻辑清单
+
+<div class="yellowBlock">
+当前清单基于lcap_process_framework v1.5版本依赖库，其他依赖库提供的流程能力请自行查阅对应的的依赖库文档。
+</div>
+
+  <table>
+    <tr>
+        <th>分类</th>
+        <th>逻辑</th>
+        <th>说明</th>
+    </tr>
+    <tr>
+        <td>流程发起</td>
+        <td><a href="#launchprocess">launchProcess</a></td>
+        <td>启动流程，返回流程实例 ID。</td>
+    </tr>
+    <tr>
+        <td rowspan="12">流程处理</td>
+        <td><a href="#approvetask">approveTask</a></td>
+        <td>同意任务。执行任务审批，审批结果为同意。</td>
+    </tr>
+    <tr>
+        <td><a href="#rejecttask">rejectTask</a></td>
+        <td>拒绝任务。执行任务审批，审批结果为拒绝。</td>
+    </tr>
+    <tr>
+        <td><a href="#submittask">submitTask</a></td>
+        <td>提交任务。当流程回到开始节点后，需要使用提交让流程继续向下运行。</td>
+    </tr>
+    <tr>
+        <td><a href="#reverttask">revertTask</a></td>
+        <td>退回任务。将流程回退到上游。 </td>
+    </tr>
+    <tr>
+        <td><a href="#reassigntask">reassignTask</a></td>
+        <td>转派任务。将任务转交给其他用户。 </td>
+    </tr>
+    <tr>
+        <td><a href="#withdrawtask">withdrawTask</a></td>
+        <td>撤回任务。审批流程后，在下一个节点未处理的情况下允许使用撤回。</td>
+    </tr>
+    <tr>
+        <td><a href="#addSigntask">addSignTask</a></td>
+        <td>加签。为任务增加审批人。</td>
+    </tr>
+    <tr>
+        <td><a href="#terminateprocess">terminateProcess</a></td>
+        <td>终止。结束流程实例，通常用于取消流程或结束异常流程。</td>
+    </tr>
+    <tr>
+        <td><a href="#viewcctask">viewCCTask</a></td>
+        <td>将抄送任务标记为已查看。</td>
+    </tr>    
+    <tr>
+        <td><a href="#cctask">ccTask</a></td>
+        <td>将任务抄送给指定用户。</td>
+    </tr>    
+    <tr>
+        <td><a href="#suspendprocess">suspendProcess</a></td>
+        <td>挂起流程实例，挂起后将无法操作该流程。</td>
+    </tr>   
+    <tr>
+        <td><a href="#activateprocess">activateProcess</a></td>
+        <td>激活流程实例，取消挂起。</td>
+    </tr>   
+    <tr>
+        <td rowspan="25">流程查询</td>
+        <td><a href="#getmycctasks">getMyCCTasks</a></td>
+        <td>查询抄送给我的任务</td>
+    </tr>
+    <tr>
+        <td><a href="#getmypendingtasks">getMyPendingTasks</a></td>
+        <td>查询我的待办任务</td>
+    </tr>
+    <tr>
+        <td><a href="#getmycompletedtasks">getMyCompletedTasks</a></td>
+        <td>查询我的已办任务</td>
+    </tr>
+    <tr>
+        <td><a href="#getmyinitiatedtasks">getMyInitiatedTasks</a></td>
+        <td>查询我的发起任务</td>
+    </tr>
+    <tr>
+        <td><a href="#gettaskdestinationurl">getTaskDestinationUrl</a></td>
+        <td>查询任务的跳转页面链接</td>
+    </tr>
+    <tr>
+        <td><a href="#gettaskdestinationurlmap">getTaskDestinationUrlMap</a></td>
+        <td>查询任务的跳转页面链接（返回所有端）</td>
+    </tr>
+    <tr>
+        <td><a href="#getprocdefinfos">getProcDefInfos</a></td>
+        <td>查询流程定义名称列表</td>
+    </tr>
+    <tr>
+        <td><a href="#getprocinstinitiators">getProcInstInitiators</a></td>
+        <td>查询流程实例发起人列表</td>
+    </tr>
+    <tr>
+        <td><a href="#getprocinstinfo">getProcInstInfo</a></td>
+        <td>查询流程信息</td>
+    </tr>
+    <tr>
+        <td><a href="#gettaskoperationpermissions">getTaskOperationPermissions</a></td>
+        <td>获取任务操作权限</td>
+    </tr>
+    <tr>
+        <td><a href="#getdatapropertypermissions">getDataPropertyPermissions</a></td>
+        <td>获取流程数据字段权限（旧版，建议使用新版）</td>
+    </tr>
+    <tr>
+        <td><a href="#getformdatapropertypermissions">getFormDataPropertyPermissions</a></td>
+        <td>获取流程数据字段权限（新版）</td>
+    </tr>
+    <tr>
+        <td><a href="#gettaskdata">getTaskData</a></td>
+        <td>获取任务的表单数据</td>
+    </tr>
+    <tr>
+        <td><a href="#getprocinstrecords">getProcInstRecords</a></td>
+        <td>查询流程记录</td>
+    </tr>
+    <tr>
+        <td><a href="#getusersforreassign">getUsersForReassign</a></td>
+        <td>查询转派目标用户列表</td>
+    </tr>
+    <tr>
+        <td><a href="#gettaskinfo">getTaskInfo</a></td>
+        <td>查询流程任务信息</td>
+    </tr>
+    <tr>
+        <td><a href="#getusersforaddsign">getUsersForAddSign</a></td>
+        <td>查询可加签用户列表</td>
+    </tr>
+    <tr>
+        <td><a href="#getprocinstinfobyinstId">getProcInstInfoByInstId</a></td>
+        <td>按流程实例查询流程信息</td>
+    </tr>
+    <tr>
+        <td><a href="#getprocinstrecordsbyinstId">getProcInstRecordsByInstId</a></td>
+        <td>按流程实例查询流程记录</td>
+    </tr>
+    <tr>
+        <td><a href="#getprocessinstancelist">getProcessInstanceList</a></td>
+        <td>查询流程实例列表</td>
+    </tr>
+    <tr>
+        <td><a href="#gettaskinstancelist">getTaskInstanceList</a></td>
+        <td>查询任务实例列表</td>
+    </tr>
+    <tr>
+        <td><a href="#getbacknodes">getBackNodes</a></td>
+        <td>查询可回退节点列表</td>
+    </tr>
+    <tr>
+        <td><a href="#getprocinstgraph">getProcInstGraph</a></td>
+        <td>获取流程图</td>
+    </tr>
+    <tr>
+        <td><a href="#getprocvariable">getProcVariable</a></td>
+        <td>获取流程变量</td>
+    </tr>
+    <tr>
+        <td><a href="#gettaskformdef">getTaskFormDef</a></td>
+        <td>获取任务的表单定义</td>
+    </tr>
+    <tr>
+        <td rowspan="2">其他</td>
+        <td><a href="#setcurrentprocessuser">setCurrentProcessUser</a></td>
+        <td>设置当前流程用户</td>
+    </tr>
+    <tr>
+        <td><a href="#addtaskcomment">addTaskComment</a></td>
+        <td>添加审批记录</td>
+    </tr>
+</table>
+
+具体的的输入参数、输出参数、使用说明请查看对应逻辑的详细介绍。
+
+## 流程发起
+
+### launchProcess
+
+用于发起流程，发起流程时需要将实体数据传入到流程中，调用后返回创建的流程实例id。
+
+<img src="../assets/liuchengluojishiyongshuoming_202407221002_2.png" class="imgStyle" style="max-width: 800px;" />
+
+**输入参数**：
+
+- 流程（procDefKey）：流程定义key，String类型，必填，在IDE中使用时可直接选择流程，可选择的项为应用中已创建的所有流程定义。
+- data：需要传入到流程中的实体数据，类型为流程绑定的实体类型，必填。
+- relation_data：如果流程绑定的实体存在一对多关系，则在发起流程时也可以将其他间接关联的实体数据传入到流程中，选填。
+
+    例如，采购订单实体与商品实体是一对多关系，一个采购订单关联了多个商品，则在发起流程时也可将`List<商品>`传入到流程中。
+  ```json
+  {
+      data : 实体变量
+      relation_data : List<关联实体>
+  }
+  ```
+
+**输出参数**：
+
+返回流程创建成功后的流程实例id，String类型。
+
+**示例**：
+
+发起流程需要传入流程业务数据，通常在发起流程之前需要先将实体数据保存到数据库中，再将数据库中的实体数据作为发起流程的入参，如下图所示。完整的使用案例可参[流程设计及使用](../20.流程2.0/30.流程设计及使用.md)。
+
+<img src="../assets/liuchengluojishiyongshuoming_202407221002_3.png" class="imgStyle" style="max-width: 800px;" />
+
+## 流程处理
+
+### approveTask
+
+执行任务审批操作，审批结果为同意，流程继续向下运行。
+
+<img src="../assets/liuchengluojishiyongshuoming_202407221002_4.png" class="imgStyle" style="max-width: 800px;" />
+
+**输入参数**：
+
+- 流程（procDefKey）：流程定义的key，在IDE中使用时可直接选择应用中的流程定义，必填。
+- data：更新传入到流程中的业务数据，数据类型为流程关联的实体类型。
+- taskId：流程任务id，String类型，必填，可以从流程审批页获取，也可通过查询流程任务数据获取。
+- comment：审批意见，String类型，审批人执行同意操作时传入的评论留言。
+
+**其他说明**：
+
+执行审批操作后，可在后续流程节点使用流程变量读取该任务节点的审批结果。
+
+例如，唯一分支或并行分支的分支条件可以选择任务节点的`输出结果`。
+
+<img src="../assets/liuchengluojishiyongshuoming_202407221002_5.png" class="imgStyle" style="" />
+
+***
+
+### rejectTask
+
+执行任务审批操作，审批结果为拒绝，流程继续向下运行。
+
+**输入参数**：
+
+- 流程（procDefKey）：流程定义的key，在IDE中使用时可直接选择应用中的流程定义，必填。
+- data：更新传入到流程中的业务数据，数据类型为流程关联的实体类型。
+- taskId：流程任务id，String类型，必填，可以从流程审批页获取，也可通过查询流程任务数据获取。
+- comment：审批意见，String类型，执行拒绝操作时传入的评论留言。
+
+**其他说明**：
+
+执行审批操作后，可在后续流程节点使用流程变量读取该任务节点的审批结果。
+
+例如，唯一分支或并行分支的分支条件可以选择任务节点的`输出结果`。
+
+<img src="../assets/liuchengluojishiyongshuoming_202407221002_6.png" class="imgStyle" style="" />
+
+***
+
+### submitTask
+
+提交任务，用于流程回到“开始“节点后重新提交流程的场景，提交后数据更新保存，流程继续往下流转。
+
+例如，在请假流程中，流程被驳回到开始节点，发起人可以重新编辑请假申请信息，然后执行提交操作使流程向下继续运行。
+
+<img src="../assets/liuchengluojishiyongshuoming_202407221002_7.png" class="imgStyle" style="max-width: 800px;" />
+
+**输入参数**：
+
+- 流程（procDefKey）：流程定义的key，在IDE中使用时可直接选择应用中的流程定义，必填。
+- data：更新传入到流程中的业务数据，数据类型为流程关联的实体类型。
+- taskId：流程任务id，String类型，必填，可以从流程审批页获取，也可通过查询流程任务数据获取。
+- comment：审批意见，String类型，执行提交操作时传入的评论留言。
+
+***
+
+### revertTask
+
+退回任务，将任务退回到上游的某个节点，由该节点的审批人进行审批。
+
+<img src="../assets/liuchengluojishiyongshuoming_202504071425_5.png" class="imgStyle" style="max-width: 600px;" />
+
+
+**输入参数**：
+
+- taskId：任务id，String类型，必填。
+- nodeId：任务节点id，String类型，必填，需要先使用[getBackNodes](#getbacknodes)逻辑获取可回退节点列表。
+- afterComplete：重新审批后策略，决定了任务被回退并审批之后的流向，支持两种参数：
+  - reExecute：从回退的节点开始重新执行流程。
+  - jumpToSource：直接回到当前节点。
+- comment：审批意见，String类型，执行回退操作时传入的评论留言。
+
+**使用方式**：
+
+1. 判断任务节点是否支持回退：调用[getTaskOperationPermissions](#gettaskoperationpermissions)逻辑，获取任务节点支持的操作权限，只有当任务支持回退时，才允许执行回退操作。通常作为回退按钮的显示条件。
+2. 调用[getBackNodes](#getbacknodes)逻辑获取可回退节点列表，获取回退任务所需的nodeId参数。
+3. 根据步骤一的结果判断该节点的“重新审批后”策略，获取回退任务所需的afterComplete参数：
+   - 结果为`reExecute`或`jumpToSource`时，直接作为参数值。
+   - 结果为`runtimeSpecify`时，可以提供选项让用户自行选择重新审批后策略。
+
+***
+
+### reassignTask
+
+转派任务，将任务转交给其他用户。例如，任务的审批人为A和B，用户A将任务转交给用户C后，任务的审批人就变成B和C。
+
+<img src="../assets/liuchengluojishiyongshuoming_202407221002_8.png" class="imgStyle" style="max-width: 800px;" />
+
+**输入参数**：
+
+- taskId：流程任务id，String类型，必填，可以从流程审批页获取，也可通过查询流程任务数据获取。
+- userForReassign：转派的目标用户的用户名，即userName，必填。可使用[getUsersForReassign](#getusersforreassign)逻辑查询可转派的目标用户列表。
+- comment：审批意见，String类型，执行转派操作时传入的评论留言。
+
+***
+
+### withdrawTask
+
+
+撤回流程，发起流程后，在开始节点的下一个审批节点未处理之前允许发起人使用撤回，让流程回到开始节点。
+
+适用于发起流程后需要修改数据并重新提交的情况，例如，提交请假申请后发现请假天数填错，在被审批之前可以使用撤回，修改请假信息后再执行[提交](#submittask)操作。需要特别注意，只有当开始节点的下一个节点是审批任务时才能使用撤回。
+
+<img src="../assets/liuchengluojishiyongshuoming_202407221002_9.png" class="imgStyle" style="max-width: 800px;" />
+
+**输入参数**：
+
+- taskId：流程任务id，String类型，必填，可以从流程审批页获取，也可通过查询流程任务数据获取。
+- comment：审批意见，String类型，执行撤回操作时传入的评论留言。
+
+***
+
+### addSignTask
+
+
+加签，为任务增加审批人。仅对一次任务实例生效，下次流转到该流程节点时不会保留之前加签的审批人。该逻辑无输出参数。
+
+<img src="../assets/liuchengluojishiyongshuoming_202411201418_1.png" class="imgStyle" style="max-width: 800px;" />
+
+流程按钮组件的“加签”能力调用了该逻辑，可以根据该逻辑自行搭建加签界面。
+
+<img src="../assets/liuchengluojishiyongshuoming_202411201418_2.png" class="imgStyle" style="" />
+
+**输入参数**：
+
+- taskId：流程任务id，String类型，必填，可以从流程审批页获取，也可通过查询流程任务数据获取。
+- userForAddSign：要加签的用户名，即userName，必填。可使用[getUsersForAddSign](#getusersforaddsign)逻辑查询可加签的用户列表。
+- policyForAddSign：加签策略，String类型，可选择三种加签方式，默认为当前节点加签。注意，只有当多人审批方式为**或签**时才可以使用前加签和后加签。
+  - CurrentNode：当前节点加签，将要加签的用户追加到该任务的审批人中。例如，原审批人为`张三`，加签`李四`后，新的审批人列表为`张三+李四`。
+  - PreviousNode：前加签，被加签人需要先处理一次任务，同意后再由当前审批人处理。例如，原审批人为`张三`，加签`李四`后，会为李四创建一个任务，李四同意之后才会流转到张三处理。需要特别注意，前加签会导致多次触发流程中的事件。
+  - NextNode：后加签，加签后会通过当前任务，并为被加签人创建任务。需要特别注意，后加签会导致多次触发流程中的事件。
+
+  <img src="../assets/liuchengluojishiyongshuoming_202412171645_2.png" class="imgStyle" style="" />
+
+枚举类型AddSignTypeEnum代表加签策略，可使用内置函数EnumItemToStructure将枚举值转换数据结构，并选择value值，使用方式如下图所示。
+<img src="../assets/liuchengluojishiyongshuoming_202411241418_1.png" class="imgStyle" style="width:500px;" />
+
+- comment：审批意见，String类型，执行加签操作时传入的评论留言。
+
+***
+
+### terminateProcess
+
+
+终止流程实例，当流程需要临时取消或者流程异常的情况，可通过此逻辑终止流程实例。
+
+使用时可通过权限控制的方式来限制部分用户可调用此逻辑，例如仅管理员可终止流程。
+
+<img src="../assets/liuchengluojishiyongshuoming_202407221002_11.png" class="imgStyle" style="max-width: 700px;" />
+
+**输入参数**：
+
+- procInstId：流程实例id，String类型，必填。
+
+***
+
+### viewCCTask
+
+
+查看抄送任务，将抄送任务的状态将从未查看更新为已查看。如果需要查询抄送任务列表，请使用getMyCCTasks逻辑。
+
+需要特别注意，有多名用户收到同一个抄送时，不同用户的抄送任务查看状态是相互独立的。
+
+<img src="../assets/liuchengluojishiyongshuoming_202410081754_1.png" class="imgStyle" style="max-width: 800px;" />
+
+**输入参数**：
+
+- taskId：流程任务id，String类型，必填，可以从流程审批页获取，也可通过其他流程逻辑获取。
+
+***
+
+## 流程查询
+
+### getMyCCTasks
+
+
+查询抄送我的，根据逻辑入参中的各类筛选条件查询抄送给我的任务。注意，该逻辑默认根据当前登录用户进行查询，查询的是抄送给逻辑调用者的任务。
+
+<img src="../assets/liuchengluojishiyongshuoming_202412161531_2.png" class="imgStyle" style="max-width: 800px;" />
+
+**输入参数**：
+
+- 流程ID：根据流程定义的ID进行查询，<span style="color: orange;">**为空时默认查询所有流程**</span>。流程定义的ID可通过[getProcDefInfos](#getprocdefinfos)、[getTaskInfo](#gettaskinfo)等逻辑获取，也可以在IDE中选中流程后从右侧属性面板中查看。
+
+    <img src="../assets/liuchengluojishiyongshuoming_202412161531_1.png" class="imgStyle" style="max-width: 300px;" />
+
+- procInstStartTimeAfter：流程发起时间的开始日期，DateTime类型，选填项。
+- procInstStartTimeBefore：流程发起时间的结束日期，DateTime类型，选填项。
+- procInstInitiator：流程实例的发起人用户名，即userName，选填项。
+- viewed：是否已被查看，布尔类型，选填项。
+- page：页数，Integer类型，选填项，默认为1。
+- size：数据条数，Integer类型，选填项，默认为20。
+- search：流程定义标题，模糊查询，String类型，选填项。流程定义标题可通过[getProcDefInfos逻辑](#getprocdefinfos)（查询流程定义名称列表）获取。
+
+**输出参数**：
+
+    {
+    	list:List<MyCCTask>,
+    	total:Integer整数
+    }
+
+- list：抄送任务列表，MyCCTask类型的属性说明请参考下文。
+- total：待办任务总数。
+
+**MyCCTask属性说明**
+
+| 参数                | 类型              | 说明                            |
+| :---------------- | :-------------- | :---------------------------- |
+| taskId            | String          | 抄送任务ID                        |
+| taskTitle         | String          | 任务标题                          |
+| procInstTitle     | String          | 流程实例的标题，由流程定义标题+发起人+发起日期组成                       |
+| procDefTitle      | String          | 流程定义的标题                       |
+| procInstInitiator.userName | String          | 流程发起人的userName              |
+| procInstInitiator.displayName | String          | 流程发起人的displayName              |
+| procInstStartTime | DateTime        | 流程实例的发起时间                     |
+| procInstCurrNodes | List\<CurrNode> | 流程实例的当前节点列表。[CurrNode数据结构](#currnode属性说明)参考附录。 |
+
+**输出结果示例**：
+
+```json
+{
+    "list": [
+        {
+            "taskId": "d9099e05-2f80-11ef-8676-00ff36813e87",
+            "taskTitle": "抄送任务1",
+            "procInstTitle": "流程1-admin-2024-06-21",
+            "procDefTitle": "流程1",
+            "procInstInitiator": 
+                {
+                    "userName":"张三",
+                    "displayName":"张三"
+                },
+            "procInstStartTime": "2024-09-21T03:46:31.000Z",
+            "procInstCurrNodes": [
+                {
+                    "currNodeTitle": "审批任务1",
+                    "currNodeParticipants": [
+                        {
+                            "userName":"张三",
+                            "displayName":"张三"
+                        }
+                    ]
+                }
+            ]
+        },
+        {
+            "taskId": "6e17a195-2ee7-11ef-a4bf-00ff36813e87",
+            "taskTitle": "抄送任务1",
+            "procInstTitle": "流程1-admin-2024-06-20",
+            "procDefTitle": "流程1",
+            "procInstInitiator":
+                {
+                    "userName":"张三",
+                    "displayName":"张三"
+                },
+            "procInstStartTime": "2024-09-20T09:28:19.000Z",
+            "procInstCurrNodes": [
+                {
+                    "currNodeTitle": "审批任务1",
+                    "currNodeParticipants": [
+                        {
+                            "userName":"张三",
+                            "displayName":"张三"
+                        }
+                    ]
+                }
+            ]
+        }
+    ],
+    "total": 2
+}
+```
+
+***
+
+### getMyPendingTasks
+
+
+查询我的待办任务列表，根据逻辑入参中的各类筛选条件查询待办任务。注意，该逻辑默认根据当前登录用户进行查询，查询的是逻辑调用者的待办任务。
+
+<img src="../assets/liuchengluojishiyongshuoming_202412161531_5.png" class="imgStyle" style="max-width: 800px;" />
+
+**输入参数**：
+
+- 流程ID：根据流程定义的ID进行查询，<span style="color: orange;">**为空时默认查询所有流程**</span>。流程定义的ID可通过[getProcDefInfos](#getprocdefinfos)、[getTaskInfo](#gettaskinfo)等逻辑获取，也可以在IDE中选中流程后从右侧属性面板中查看。
+
+    <img src="../assets/liuchengluojishiyongshuoming_202412161531_1.png" class="imgStyle" style="max-width: 300px;" />
+
+- procInstStartTimeAfter：流程发起时间的开始日期，DateTime类型，选填项。
+- procInstStartTimeBefore：流程发起时间的结束日期，DateTime类型，选填项。
+- procInstInitiator：流程实例的发起人用户名，即userName，选填项。
+- page：页数，Integer类型，选填项，默认为1。
+- size：数据条数，Integer类型，选填项，默认为20。
+- search：流程定义标题，模糊查询，String类型，选填项。流程定义标题可通过[getProcDefInfos逻辑](#getprocdefinfos)（查询流程定义名称列表）获取。
+
+**输出参数**：
+
+    {
+    	list:List<MyPendingTask>,
+    	total:Integer整数
+    }
+
+- list：待办任务列表，MyPendingTask类型的属性说明请参考下文。
+- total：待办任务总数。
+
+**MyPendingTask属性说明**
+
+| 参数                | 类型              | 说明                            |
+| :---------------- | :-------------- | :---------------------------- |
+| taskId            | String          | 待办任务ID                        |
+| taskTitle         | String          | 任务标题                          |
+| procInstTitle     | String          | 流程实例的标题，由流程定义标题+发起人+发起日期组成                       |
+| procDefTitle      | String          | 流程定义的标题                       |
+| procInstInitiator.userName | String          | 流程发起人的userName              |
+| procInstInitiator.displayName | String          | 流程发起人的displayName              |
+| procInstStartTime | DateTime        | 流程实例的发起时间                     |
+| procInstCurrNodes | List\<CurrNode> | 流程实例的当前节点列表。[CurrNode数据结构](#currnode属性说明)参考附录。 |
+
+**输出结果示例**：
+
+```json
+{
+    "list":[
+        {
+            "taskId":"ed79a559-35f4-11f0-9dbc-5e9488c65640",
+            "taskTitle":"审批任务1",
+            "procInstTitle":"请假流程-汤姆-2025-05-21",
+            "procDefTitle":"请假流程",
+            "procInstInitiator":{
+                "userName":"Tom",
+                "displayName":"汤姆"
+            },
+            "procInstStartTime":"2025-05-21T03:37:32.000Z",
+            "procInstCurrNodes":[
+                {
+                    "currNodeTitle":"审批任务1",
+                    "currNodeParticipants":[
+                        {
+                            "userName":"DEVACC-wftestprocess313",
+                            "displayName":"DEVACC-wftestprocess313"
+                        }
+                    ],
+                    "taskId":null
+                }
+            ]
+        }
+    ],
+    "total":1
+}
+```
+
+***
+
+### getMyCompletedTasks
+
+
+查询我的已办，根据逻辑入参中的各类筛选条件查询已办任务。注意，该逻辑默认根据当前登录用户进行查询，查询的是逻辑调用者的已办任务。
+
+<img src="../assets/liuchengluojishiyongshuoming_202412161531_4.png" class="imgStyle" style="max-width: 800px;" />
+
+**输入参数**：
+
+- 流程ID：根据流程定义的ID进行查询，<span style="color: orange;">**为空时默认查询所有流程**</span>。流程定义的ID可通过[getProcDefInfos](#getprocdefinfos)、[getTaskInfo](#gettaskinfo)等逻辑获取，也可以在IDE中选中流程后从右侧属性面板中查看。
+
+    <img src="../assets/liuchengluojishiyongshuoming_202412161531_1.png" class="imgStyle" style="max-width: 300px;" />
+
+- procInstStartTimeAfter：流程发起时间的开始日期，DateTime类型，选填项。
+- procInstStartTimeBefore：流程发起时间的结束日期，DateTime类型，选填项。
+- procInstInitiator：流程实例的发起人用户名，即userName，选填项。
+- page：页数，Integer类型，选填项，默认为1。
+- size：数据条数，Integer类型，选填项，默认为20。
+- search：流程定义标题，模糊查询，String类型，选填项。流程定义标题可通过[getProcDefInfos逻辑](#getprocdefinfos)（查询流程定义名称列表）获取。
+
+**输出参数**：
+
+    {
+    	list:List<MyCompletedTask>,
+    	total:Integer整数
+    }
+
+- list：已办任务列表，List\<MyCompletedTask>类型，MyCompletedTask类型的属性说明请参考下文。
+- total：已办任务总数，Integer类型。
+
+**MyCompletedTask属性说明**
+
+| 参数                | 类型              | 说明                            |
+| :---------------- | :-------------- | :---------------------------- |
+| taskId            | String          | 已办任务的ID                       |
+| taskTitle         | String          | 任务标题                          |
+| procInstTitle     | String          | 流程实例的标题，由流程定义标题+发起人+发起日期组成                       |
+| procDefTitle      | String          | 流程类型                          |
+| procInstInitiator.userName | String          | 流程发起人的userName              |
+| procInstInitiator.displayName | String          | 流程发起人的displayName              |
+| procInstStartTime | DateTime        | 流程实例的发起时间                     |
+| procInstCurrNodes | List\<CurrNode> | 流程实例的当前节点列表，[CurrNode数据结构](#currnode属性说明)参考附录。 |
+
+输出结果示例：
+
+```json
+{
+    "list":[
+        {
+            "taskId":"3a932573-360a-11f0-9dbc-5e9488c65640",
+            "taskTitle":"审批任务1",
+            "nodeTitle":"审批任务1",
+            "procInstTitle":"请假流程-DEVACC-wftestprocess313-2025-05-21",
+            "procDefTitle":"请假流程",
+            "procInstInitiator":{
+                "userName":"DEVACC-wftestprocess313",
+                "displayName":"DEVACC-wftestprocess313"
+            },
+            "procInstStartTime":"2025-05-21T06:10:01.000Z",
+            "procInstCurrNodes":[
+                {
+                    "currNodeTitle":"结束",
+                    "currNodeParticipants":null,
+                    "taskId":null
+                }
+            ]
+        }
+    ],
+    "total":1
+}
+```
+
+***
+
+### getMyInitiatedTasks
+
+
+查询我的发起，根据逻辑入参中的各类筛选条件查询我的发起任务。注意，该逻辑默认根据当前登录用户进行查询，查询的是逻辑调用者的发起任务。
+
+<img src="../assets/liuchengluojishiyongshuoming_202412161531_3.png" class="imgStyle" style="max-width: 800px;" />
+
+**输入参数**：
+
+- 流程ID：根据流程定义的ID进行查询，<span style="color: orange;">**为空时默认查询所有流程**</span>。流程定义的ID可通过[getProcDefInfos](#getprocdefinfos)、[getTaskInfo](#gettaskinfo)等逻辑获取，也可以在IDE中选中流程后从右侧属性面板中查看。
+
+    <img src="../assets/liuchengluojishiyongshuoming_202412161531_1.png" class="imgStyle" style="max-width: 300px;" />
+
+- procInstStartTimeAfter：流程发起时间的开始日期，DateTime类型，选填项。
+- procInstStartTimeBefore：流程发起时间的结束日期，DateTime类型，选填项。
+- procInstInitiator：流程实例的发起人用户名，即userName，选填项。
+- page：页数，Integer类型，选填项，默认为1。
+- size：数据条数，Integer类型，选填项，默认为20。
+- search：流程定义标题，模糊查询，String类型，选填项。流程定义标题可通过[getProcDefInfos逻辑](#getprocdefinfos)（查询流程定义名称列表）获取。
+
+逻辑输出参数：
+
+    {
+    	list:List<MyInitiateTask>,
+    	total:Integer整数
+    }
+
+- list：发起任务列表，List\<MyInitiateTask>类型，MyInitiateTask类型的属性说明请参考下文。
+- total：发起任务总数，Integer类型。
+
+**MyInitiateTask属性说明**
+
+| 参数                | 类型              | 说明                            |
+| :---------------- | :-------------- | :---------------------------- |
+| taskId            | String          | 发起任务的ID                       |
+| taskTitle         | String          | 任务标题                          |
+| procInstTitle     | String          | 流程实例的标题，由流程定义标题+发起人+发起日期组成                       |
+| procDefTitle      | String          | 流程类型                          |
+| procInstInitiator.userName | String          | 流程发起人的userName              |
+| procInstInitiator.displayName | String          | 流程发起人的displayName              |
+| procInstStartTime | DateTime        | 流程实例的发起时间                     |
+| procInstCurrNodes | List\<CurrNode> | 流程实例的当前节点列表，[CurrNode数据结构](#currnode属性说明)参考附录。 |
+
+输出结果示例：
+
+```json
+{
+    "list":[
+        {
+            "taskId":"3c29e6b2-3614-11f0-9dbc-5e9488c65640",
+            "taskTitle":"开始",
+            "procInstTitle":"请假流程-DEVACC-wftestprocess313-2025-05-21",
+            "procDefTitle":"请假流程",
+            "procInstInitiator":{
+                "userName":"DEVACC-wftestprocess313",
+                "displayName":"DEVACC-wftestprocess313"
+            },
+            "procInstStartTime":"2025-05-21T07:21:38.000Z",
+            "procInstCurrNodes":[
+                {
+                    "currNodeTitle":"审批任务1",
+                    "currNodeParticipants":[
+                        {
+                            "userName":"DEVACC-wftestprocess313",
+                            "displayName":"DEVACC-wftestprocess313"
+                        }
+                    ],
+                    "taskId":"3c3f91a1-3614-11f0-9dbc-5e9488c65640"
+                }
+            ]
+        }
+    ],
+    "total":1
+}
+```
+
+***
+
+### getTaskDestinationUrl
+
+
+查询任务的跳转页面链接，根据任务实例id查询该审批节点设置的审批页面链接，用于跳转到审批页面进行流程审批。
+
+<img src="../assets/liuchengluojishiyongshuoming_202505231019_1.png" class="imgStyle" style="max-width: 600px;" />
+
+**输入参数**：
+
+- taskId：任务实例id，String类型，必填。
+- frontendKey：端标识，String类型，选填，可通过指定该参数来获取特定端对应的审批页,不填时默认会获取当前请求页面对应的端。
+
+> **什么是端**
+>
+>“端”是指页面的PC端或H5端，应用中至少会有一个PC端页面，可能会有多组H5端页面，关于端的详细解释请参考[端介绍](../../10.页面设计/13.端介绍.md)。在搭建流程应用时，不同端对应的审批页面路径可能会有所不同。 
+>
+> 端标识在应用中的查看方式如下，在左侧栏选择“页面”，在PC端或H5端下选择端后再属性面板中查看端标识，将该字符串作为frontendKey参数即可。PC端的默认端标识为“pc”，H5端的默认端标识为“m”、“m1”、“m2”以此类推。
+>
+> <img src="../assets/liuchengluojishiyongshuoming_202505231019_2.png" class="imgStyle" style="" />
+
+**输出参数**：
+
+任务审批页面地址，String类型，地址为相对路径，可根据当前应用地址拼接出完整地址。地址中包含taskId值，如果发起流程时传入到流程中的实体数据包含id字段，则审批页面地址中也将包含dataId值。
+
+**输出结果示例**：
+
+    /dashboard/approveLeaveRequest?taskId=83c63922-44ff-11ef-a522-c2f072699ad7&dataId=2915838137566208
+
+***
+
+### getTaskDestinationUrlMap
+
+查询任务的跳转页面链接，与getTaskDestinationUrl逻辑的差异在于，其查询结果为Map结构，key为端标识，value为审批页面地址。
+
+<img src="../assets/liuchengluojishiyongshuoming_202507111614_1.png" class="imgStyle" style="max-width: 600px;" />
+
+**输入参数**：
+
+- taskId：任务实例id，String类型，必填。
+
+**输出参数**：
+
+输出类型为Map\<String, String>，Map的key为端标识，value为对应的审批页面地址。使用时可通过get不同的key获取对应的审批页面地址。
+
+端标识的介绍请参考getTaskDestinationUrl逻辑。
+
+**输出结果示例**：
+
+```
+{
+    "pc": "/dashboard/approveLeaveProcess?taskId=b9e8c943-5e2f-11f0-aa59-722dbf7d364e&dataId=3169110066223616",
+    "m1": "/m2/approveLeaveProcess?taskId=b9e8c943-5e2f-11f0-aa59-722dbf7d364e&dataId=3169110066223616",
+    "m": "/m/approveLeaveProcess?taskId=b9e8c943-5e2f-11f0-aa59-722dbf7d364e&dataId=3169110066223616"
+}
+```
+
+### getProcDefInfos
+
+
+查询流程定义名称列表，用于查询应用中有哪些流程定义，输出结果可作为其他流程逻辑的查询参数。
+
+<img src="../assets/liuchengluojishiyongshuoming_202407221002_16.png" class="imgStyle" style="max-width: 800px;" />
+
+**输入参数**：
+
+- search：流程定义标题，模糊查询，String类型，选填项。
+
+**输出参数**：
+
+流程定义的列表，List\<ProcDef>类型，ProcDef类型的属性说明请参考下文。
+
+**ProcDef属性说明**
+
+| 参数                 | 类型     | 说明     |
+| :----------------- | :----- | :----- |
+| procDefKey         | String | 流程定义key |
+| procDefTitle       | String | 流程定义标题 |
+| procDefDescription | String | 流程定义描述 |
+| suspended | boolean | 流程定义是否挂起 |
+| belongApp | boolean | 流程定义是否属于本应用。主要在两种情况下使用：<br>情况一.多个应用使用了相同的数据库表，导致多个应用中的流程定义都是存在一张表下，查询流程定义时可根据该字段判断查询出的流程定义是否属于当前应用。<br>情况二：代码层面已经删除了流程定义但是数据库中仍然存了流程定义的数据，查询时会查到此类无效的流程定义，可通过该字段判断流程定义是否属于当前应用。 |
+
+
+**输出结果示例**：
+
+```json
+[
+    {
+        "procDefKey": "Process_376a223d",
+        "procDefTitle": "订单采购流程",
+        "procDefDescription": null,
+        "suspended":false,
+        "belongApp": true
+    },
+    {
+        "procDefKey": "Process_a43e5ee0",
+        "procDefTitle": "请假审批流程",
+        "procDefDescription": null,
+        "suspended":false,
+        "belongApp": true
+    }
+]
+```
+
+***
+
+### getProcInstInitiators
+
+
+查询流程实例发起人列表，可通过此逻辑获取应用中的用户列表。查询结果可结合[查询待办任务](#getmypendingtasks)、[已办任务](#getmycompletedtasks)、[发起任务](#getmyinitiatedtasks)等逻辑一起使用，用于按流程发起人的方式过滤任务数据。
+
+<img src="../assets/liuchengluojishiyongshuoming_202407221002_17.png" class="imgStyle" style="max-width: 800px;" />
+
+**输出参数**：
+
+用户信息列表，List\<ProcessUser>类型，结构可参考输出结果示例。
+
+**输出结果示例**：
+
+```json
+{
+    "list":[
+        {
+            "userName":"李四",
+            "displayName":null
+        },
+        {
+            "userName":"张三",
+            "displayName":"小三"
+        },
+        {
+            "userName":"DEVACC-wftestprocess313",
+            "displayName":"DEVACC-wftestprocess313"
+        }
+    ],
+    "total":3
+}
+```
+
+***
+
+### getTaskOperationPermissions
+
+
+获取任务操作权限，查询出任务的可操作权限后，可根据返回结果来动态渲染流程操作按钮，仅显示有操作权限的按钮。
+
+流程操作类型可参考[附录-流程操作](#流程操作)。
+
+<img src="../assets/liuchengluojishiyongshuoming_202407221002_18.png" class="imgStyle" style="max-width: 800px;" />
+
+**输入参数**：
+
+- taskId：流程任务id，String类型，必填，可以从流程审批页获取，也可通过查询流程任务数据获取。
+
+**输出参数**：
+
+审批操作的集合，List\<TaskOperationPermission>类型。
+
+**TaskOperationPermission属性说明**
+
+<table>
+    <thead>
+        <tr>
+            <th>参数</th>
+            <th>类型</th>
+            <th>说明</th>
+        </tr>
+    </thead>
+    <tbody>
+        <tr>
+            <td>name</td>
+            <td>String</td>
+            <td>操作名称，例如approve（同意）</td>
+        </tr>
+        <tr>
+            <td>operationEnabled</td>
+            <td>Boolean</td>
+            <td>操作权限开关，即标识是否开启该操作</td>
+        </tr>
+        <tr>
+            <td>displayText</td>
+            <td>String</td>
+            <td>操作显示文本，该操作对应的显示名，例如“同意”</td>
+        </tr>
+        <tr>
+            <td>commentRequired</td>
+            <td>Boolean</td>
+            <td>意见开关，操作时是否必填审批意见。</td>
+        </tr>
+        <tr>
+            <td>moveTo</td>
+            <td>String</td>
+            <td>操作后跳转的节点，拒绝和回退两个操作会携带该参数。
+                <ul>
+                    <li>start（开始节点）</li>
+                    <li>nextNode（下一个节点）</li>
+                    <li>end（结束）</li>
+                    <li>previousNode（上一个节点）</li>
+                    <li>specifyRange（指定范围内节点）</li>
+                    <li>any（任意节点）</li>
+                </ul>
+            </td>
+        </tr>
+        <tr>
+            <td>specifiedRange</td>
+            <td>String</td>
+            <td>操作范围，List&lt;String&gt;类型，例如：<code>["ApprovalTask1","Start"]</code></td>
+        </tr>
+        <tr>
+            <td>afterComplete</td>
+            <td>String</td>
+            <td>任务被回退并重新审批后的流向，有三种结果：
+                <ul>
+                    <li>reExecute（重新执行流程）</li>
+                    <li>jumpToSource（直接回到当前节点）</li>
+                    <li>runtimeSpecify（运行时决定）</li>
+                </ul>
+            </td>
+        </tr>
+    </tbody>
+</table>
+
+**输出结果示例**：
+
+```json
+[
+        {
+            "name": "approve",
+            "operationEnabled": true,
+            "displayText": "同意",
+            "commentRequired": true,
+            "moveTo": null,
+            "specifiedRange": null,
+            "afterComplete": null
+        },
+        {
+            "name": "reject",
+            "operationEnabled": true,
+            "displayText": "拒绝",
+            "commentRequired": true,
+            "moveTo": "nextNode",
+            "specifiedRange": null,
+            "afterComplete": null
+        },
+        {
+            "name": "reassign",
+            "operationEnabled": true,
+            "displayText": "转派",
+            "commentRequired": false,
+            "moveTo": null,
+            "specifiedRange": null,
+            "afterComplete": null
+        },
+        {
+            "name": "revert",
+            "operationEnabled": true,
+            "displayText": "回退",
+            "commentRequired": true,
+            "moveTo": "specifyRange",
+            "specifiedRange": [
+                "ApprovalTask3",
+                "Start"
+            ],
+            "afterComplete": "runtimeSpecify"
+        },
+        {
+            "name": "addSign",
+            "operationEnabled": true,
+            "displayText": "加签",
+            "commentRequired": false,
+            "moveTo": null,
+            "specifiedRange": null,
+            "afterComplete": null
+        }
+    ]
+```
+
+**使用方式**：
+
+1. 在审批页面放置多个按钮，每个按钮对应一个操作（同意、转派、加签等）。
+2. 为审批页面添加进入时事件，进入时调用该逻辑，保存结果。
+3. 配置按钮的显隐，根据输出结果的operationEnabled字段来决定是否显示该操作按钮。
+
+***
+
+### getDataPropertyPermissions
+
+获取流程数据字段权限，用于查询当前流程任务对应审批表单的数据权限，哪些字段可见，哪些字段可编辑等，可根据此逻辑返回的数据来动态渲染表单，使用案例请参[流程2.0表单数据权限控制说明-表单数据的权限控制](../20.流程2.0/97.流程2.0表单数据权限控制.md)。
+
+**该逻辑为旧版，推荐使用新版逻辑[getFormDataPropertyPermissions](#getformdatapropertypermissions)来替代该逻辑**，新版逻辑的输出结果中除了流程实体的字段权限以外，还包含一对多关联实体的字段权限。
+
+<img src="../assets/liuchengluojishiyongshuoming_202407221002_19.png" class="imgStyle" style="max-width: 800px;" />
+
+数据权限的配置在流程审批节点的属性中设置。
+
+<img src="../assets/liuchengluojishiyongshuoming_202407221002_20.png" class="imgStyle" style="max-width: 350px;border: 1px solid #ccc;" />
+
+**输入参数**：
+
+- taskId：流程任务id，String类型，必填，可以从流程审批页获取，也可通过查询流程任务数据获取。
+
+**输出参数**：
+
+数据权限的集合，List\<DataPropertyPermission>类型。
+
+**DataPropertyPermission属性说明**
+
+| 参数           | 类型     | 说明                                             |
+| :----------- | :----- | :--------------------------------------------- |
+| propertyName | String | 表单字段名，流程关联的实体中的属性名称                            |
+| permission   | String | 字段权限的内容如下<br>- readOnly：只读预览<br>- hidden：隐藏<br>- editable：可编辑 |
+
+**输出参数示例**
+
+```json
+[
+    {
+        "propertyName": "id",
+        "permission": "hidden"
+    },
+    {
+        "propertyName": "createdTime",
+        "permission": "hidden"
+    },
+    {
+        "propertyName": "updatedTime",
+        "permission": "hidden"
+    },
+    {
+        "propertyName": "createdBy",
+        "permission": "hidden"
+    },
+    {
+        "propertyName": "updatedBy",
+        "permission": "hidden"
+    },
+    {
+        "propertyName": "name",
+        "permission": "readOnly"
+    },
+    {
+        "propertyName": "reason",
+        "permission": "readOnly"
+    },
+    {
+        "propertyName": "type",
+        "permission": "readOnly"
+    },
+    {
+        "propertyName": "startTime",
+        "permission": "readOnly"
+    },
+    {
+        "propertyName": "endTime",
+        "permission": "readOnly"
+    },
+    {
+        "propertyName": "days",
+        "permission": "readOnly"
+    }
+]
+```
+
+***
+
+### getTaskData
+
+
+获取任务的表单数据，审批流程时需要获取该数据作为表单的内容。
+
+<img src="../assets/liuchengluojishiyongshuoming_202407221002_21.png" class="imgStyle" style="max-width: 800px;" />
+
+**输入参数**：
+
+- 流程（procDefKey）：流程定义key，String类型，必填，在IDE中使用时可直接选择流程，可选择的项为应用中已创建的所有流程定义。
+- taskId：流程任务id，String类型，必填，可以从流程审批页获取，也可通过查询流程任务数据获取。
+
+**输出参数**：
+
+输出参数的数据结构如下。
+
+    {
+    	data: 实体,
+    	relation_data: List<其他实体>
+    }
+
+- data：流程数据，类型为流程绑定的实体类型。
+- relation_data：流程绑定的实体关联的其他实体数据列表。
+
+**输出参数示例**
+
+```json
+{
+    "data": {
+        "createdTime": "2024-07-19T06:05:05.320Z",
+        "name": "七月食物采购",
+        "userName": "DEVACC-testprocess39",
+        "sumPrice": 180,
+        "detail": null
+    },
+    "relation_data": [
+        {
+            "id": 2916363545478144,
+            "createdTime": "2024-07-19T06:05:05.360Z",
+            "updatedTime": "2024-07-19T06:05:05.360Z",
+            "createdBy": "DEVACC-testprocess39",
+            "updatedBy": "DEVACC-testprocess39",
+            "orderId": 2916363545150464,
+            "name": "面包",
+            "quantity": 20,
+            "totalPrice": 100
+        },
+        {
+            "id": 2916363545510912,
+            "createdTime": "2024-07-19T06:05:05.364Z",
+            "updatedTime": "2024-07-19T06:05:05.364Z",
+            "createdBy": "DEVACC-testprocess39",
+            "updatedBy": "DEVACC-testprocess39",
+            "orderId": 2916363545150464,
+            "name": "矿泉水",
+            "quantity": 40,
+            "totalPrice": 80
+        }
+    ]
+}
+```
+
+***
+
+### getFormDataPropertyPermissions
+
+
+获取流程子表单数据字段权限，用于查询当前流程任务对应审批表单的数据权限，哪些字段可见，哪些字段可编辑等，可根据此逻辑返回的数据来动态渲染表单，使用案例请参考[流程2.0表单数据权限控制说明-表单数据的权限控制](../20.流程2.0/97.流程2.0表单数据权限控制.md)。
+
+与getDataPropertyPermissions逻辑的差异在于，该逻辑返回的内容除了流程实体的字段权限以外，还包含一对多关联实体的字段权限。
+
+<img src="../assets/liuchengluojishiyongshuoming_2024008261115_1.png" class="imgStyle" style="max-width: 800px;" />
+
+**输入参数**：
+
+- taskId：流程任务id，String类型，必填，可以从流程审批页获取，也可通过查询流程任务数据获取。
+
+**输出参数**：
+
+类型为`List<FormDataPropertyPermission>`。
+
+**FormDataPropertyPermission属性说明**
+
+| 参数名                 | 参数类型                              | 参数描述                                           |
+| :------------------ | :-------------------------------- | :--------------------------------------------- |
+| propertyName        | String                            | 表单字段名                                          |
+| permission          | String                            | 字段权限，内容如下 <br>readOnly：只读预览；<br>hidden：隐藏；<br>editable：可编辑 |
+| subFieldPermissions | List\<FormDataPropertyPermission> | 子字段数据权限                                        |
+
+**输出参数示例**
+
+subFieldPermissions字段下的propertyName表示实体的属性名，外层的propertyName表示是主实体还是关联实体，主实体为data，关联实体为relation_data。
+```json
+[
+  {
+    "propertyName": "data",
+    "permission": "readOnly",
+    "subFieldPermissions": [
+      {
+        "propertyName": "id",
+        "permission": "hidden",
+        "subFieldPermissions": []
+      },
+      {
+        "propertyName": "createdTime",
+        "permission": "hidden",
+        "subFieldPermissions": []
+      },
+      {
+        "propertyName": "title",
+        "permission": "editable",
+        "subFieldPermissions": []
+      },
+      {
+        "propertyName": "userName",
+        "permission": "editable",
+        "subFieldPermissions": []
+      }
+    ]
+  },
+  {
+    "propertyName": "relation_data",
+    "permission": "readOnly",
+    "subFieldPermissions": [
+      {
+        "propertyName": "id",
+        "permission": "hidden",
+        "subFieldPermissions": []
+      },
+      {
+        "propertyName": "purchaseId",
+        "permission": "editable",
+        "subFieldPermissions": []
+      },
+      {
+        "propertyName": "name",
+        "permission": "editable",
+        "subFieldPermissions": []
+      }
+    ]
+  }
+]
+```
+
+***
+
+### getUsersForReassign
+
+
+查询转派目标用户列表，在进行转派前可通过此逻辑查询可转派的用户列表。可转派的用户列表为当前任务参与人以外的用户。
+
+<img src="../assets/liuchengluojishiyongshuoming_202505201901_1.png" class="imgStyle" style="max-width: 700px;" />
+
+**输入参数**：
+
+- taskId：流程任务id，String类型，必填，可以从流程审批页获取，也可通过查询流程任务数据获取。
+- page：Integer类型，分页参数的页码，默认为1。
+- size：Integer类型，分页参数的每页条数，默认为20。
+- userName：根据用户的userName或displayName信息模糊查询，默认为null，即无userName筛选条件。
+
+**输出参数**：
+
+返回结果包含list和total两个字段，list中的ProcessUser结构包含了用户的userName和displayName信息，可参考输出结果示例。
+
+**输出参数示例**：
+
+```json
+{
+    "list": [
+        {
+            "userName": "Tom",
+            "displayName": "汤姆"
+        },
+        {
+            "userName": "Jack",
+            "displayName": null
+        }
+    ],
+    "total": 2
+}
+```
+
+***
+
+### getProcInstInfo
+
+
+按任务实例查询流程信息，输入任务ID查询该任务对应的流程实例信息，包含流程实例id、发起人、发起时间、当前所处节点等信息。
+
+<img src="../assets/liuchengluojishiyongshuoming_202505201901_4.png" class="imgStyle" style="max-width: 800px;" />
+
+**输入参数**：
+
+- taskId：流程任务id，String类型，必填，可以从流程审批页获取，也可通过查询流程任务数据获取。
+
+**输出参数**：
+
+流程实例信息，ProcInstInfo类型。
+
+**ProcInstInfo属性说明**
+
+| 参数                | 类型              | 说明                                   |
+| :---------------- | :-------------- |:-------------------------------------|
+| procInstId        | String          | 流程实例ID                               |
+| procInstInitiator.userName | String          | 流程发起人的用户名                               |
+| procInstInitiator.displayName | String          | 流程发起人的用户昵称                               |
+| procInstStartTime | DateTime        | 流程实例发起时间                             |
+| procInstEndTime   | DateTime        | 流程实例结束时间                             |
+| procInstStatus    | String            | 流程实例当前状态，Approved为审批通过，Approving为审批中，Suspended为挂起 |
+| procInstCurrNodes | List\<CurrNode> | 流程实例的当前节点列表，[CurrNode数据结构](#currnode属性说明)请参考附录。  |
+| processDefinitionName   | String        | 流程定义名                             |
+| processDefinitionTitle   | String        | 流程实定义的标题                             |
+
+**输出结果示例**
+
+```JSON
+{
+    "procInstId": "c8bf0f67-359c-11f0-9dbc-5e9488c65640",
+    "procInstInitiator": {
+        "userName": "DEVACC-wftestprocess313",
+        "displayName": "DEVACC-wftestprocess313"
+    },
+    "procInstStartTime": "2025-05-20T17:06:35.000Z",
+    "procInstEndTime": null,
+    "procInstStatus": "Approving",
+    "procInstCurrNodes": [
+        {
+            "currNodeTitle": "审批任务1",
+            "currNodeParticipants": [
+                {
+                    "userName": "DEVACC-wftestprocess313",
+                    "displayName": "DEVACC-wftestprocess313"
+                }
+            ],
+            "taskId": "c8f11c0e-359c-11f0-9dbc-5e9488c65640"
+        }
+    ],
+    "processDefinitionName": "请假流程",
+    "processDefinitionTitle": "请假流程"
+}
+```
+
+***
+
+### getTaskInfo
+
+
+查询流程任务信息，查询结果中包含任务标题、是否已完成、任务创建时间、任务关闭时间等信息。
+
+<img src="../assets/liuchengluojishiyongshuoming_202407221002_24.png" class="imgStyle" style="max-width: 800px;" />
+
+**输入参数**：
+
+- taskId：流程任务id，String类型，必填，可以从流程审批页获取，也可通过查询流程任务数据获取。
+
+**输出参数**：
+
+任务实例的详细信息，TaskInst类型。
+
+**TaskInst属性说明**
+
+| 参数                | 类型               | 说明                                                         |
+| ------------------- | ------------------ | ------------------------------------------------------------ |
+| taskId              | String             | 任务实例id                                                   |
+| title               | String             | 节点标题                                                     |
+| description         | String             | 节点描述                                                     |
+| taskTitle           | String             | 任务标题                                                     |
+| taskDescription     | String             | 任务描述                                                     |
+| finished            | Boolean            | 任务是否已完成                                               |
+| completeBy.userName          | String   | 任务完成人的唯一标识名    |
+| completeBy.displayName          | String   | 任务完成人的昵称   |
+| createTime          | DateTime           | 任务创建时间                                                 |
+| completeTime        | DateTime           | 任务关闭时间                                                 |
+| taskDefName         | String             | 任务定义名                                                   |
+| category            | String             | 任务类型，请参考[任务节点类型](#任务节点类型)                   |
+| processInstanceId   | String             | 流程实例id                                                   |
+| processDefUniqueKey | String             | 流程定义的key                                             |
+| processDefinitionId | String             | 流程定义id                                                   |
+| candidateUsers          | List\<ProcessUser>             | 任务的参与人列表，表示该任务需要由哪些人参与审批，不是最终完成审批的用户。    |
+| approvalResult      | Boolean            | 审批结果                                                     |
+| approvalComment     | String             | 审批意见                                                     |
+| processDefName      | String             | 流程定义名称                                                 |
+| proclnstStatus      | String | 流程实例状态，Approving代表审批中，Approved代表审批结束，Suspended代表挂起。 |
+| approvalPolicy      | String             | 多人审批策略：<br>- simple（或签） <br> - parallel（会签）<br> - sequence（多人审批）  |
+
+
+**输出结果示例**
+
+```json
+{
+    "taskId": "83c63922-44ff-11ef-a522-c2f072699ad7",
+    "title": "主管审批",
+    "description": null,
+    "taskTitle": "您有一条请假申请待审批",
+    "taskDescription": null,
+    "finished": false,
+    "completeBy": {
+        "userName":null,
+        "displayName":null
+    },
+    "createTime": "2024-07-18T12:16:09.000Z",
+    "completeTime": null,
+    "taskDefName": "ApprovalTask1",
+    "category": "ApprovalTask",
+    "processInstanceId": "83a6cb1d-44ff-11ef-a522-c2f072699ad7",
+    "processDefUniqueKey": "Process_a43e5ee0",
+    "processDefinitionId": "Process_a43e5ee0:1:bf223e1b-44e0-11ef-9b94-c2f072699ad7",
+    "candidateUsers": [
+        {
+            "userName":"DEVACC-wftestprocess313",
+            "displayName":"DEVACC-wftestprocess313"
+        }
+    ],
+    "approvalResult": null,
+    "approvalComment": null,
+    "processDefName":"请假流程",
+    "procInstStatus":"Approving",
+    "approvalPolicy":"simple"
+}
+```
+
+***
+
+### getUsersForAddSign
+
+
+查询流程任务可加签的用户列表，查询结果中不包含已参与了任务的用户。
+
+<img src="../assets/liuchengluojishiyongshuoming_202505201901_2.png" class="imgStyle" style="max-width: 700px;" />
+
+**输入参数**：
+
+- taskId：流程任务id，String类型，必填，可以从流程审批页获取，也可通过查询流程任务数据获取。
+- page：Integer类型，分页参数的页码，默认为1。
+- size：Integer类型，分页参数的每页条数，默认为20。
+- userName：根据用户的userName或displayName信息模糊查询，默认为null，即无userName筛选条件。
+
+**输出参数**：
+
+返回结果包含list和total两个字段，list中的ProcessUser结构包含了用户的userName和displayName信息，可参考输出结果示例。
+
+**输出结果示例**：
+
+```json
+{
+    "list": [
+        {
+            "userName": "Tom",
+            "displayName": "汤姆"
+        },
+        {
+            "userName": "Jack",
+            "displayName": null
+        }
+    ],
+    "total": 2
+}
+```
+
+***
+
+### getProcInstInfoByInstId
+
+
+按流程实例查询流程信息，查询结果中包含流程实例id、发起人、发起时间、当前所处节点等信息。
+
+<img src="../assets/liuchengluojishiyongshuoming_202505201901_3.png" class="imgStyle" style="max-width: 700px;" />
+
+**输入参数**：
+
+- procInstId，流程实例id，String类型，必填。
+
+**输出参数**：
+
+参考[getProcInstInfo](#getprocinstinfo)逻辑。
+
+***
+
+### getProcInstRecords
+
+按taskId查询流程审批记录列表。
+
+可使用该逻辑手动搭建[流程记录组件](../../10.页面设计/20.PC端Vue2组件说明（默认）/96.流程/35.流程记录（流程2.0）.md)。也可使用[getProcInstRecordsByInstId逻辑](#getprocinstrecordsbyinstid)根据流程实例id查询流程记录。
+
+<img src="../assets/liuchengluojishiyongshuoming_202407221002_27.png" class="imgStyle" style="max-width: 800px;" />
+
+**输入参数**：
+
+- taskId：流程任务id，String类型，必填，可以从流程审批页获取，也可通过查询流程任务数据获取。
+- page：页码，默认为1。
+- size：每页条数，默认为20。
+
+**输出参数**：
+
+    {
+    	list: List<ProcInstRecord>,
+    	total: Integer 整数
+    }
+
+- list：流程记录列表，List\<ProcInstRecord>类型。
+- total：流程记录总数，Integer类型。
+
+**ProcInstRecord属性说明**
+
+| 参数                       | 类型       | 说明     |
+| :----------------------- | :------- | :----- |
+| nodeTitle                | String   | 流程节点标题 |
+| recordUser.userName                 | String   | 处理人的UserName，非人工处理时值为`SYSTEM_USER`    |
+| recordUser.displayName                 | String   | 处理人的用户昵称，非人工处理时值为`系统`    |
+| recordCreatedTime        | DateTime | 处理时间   |
+| nodeOperationDisplayText | String   | 审批操作名称，例如`同意` |
+| nodeOperationComment     | String   | 审批意见   |
+| nodeOperation            | String   | 流程操作，各操作项参考[附录-流程操作](#附录)   |
+
+**输出结果示例**
+
+```json
+{
+    "list": [
+        {
+            "nodeTitle": "结束",
+            "recordUser": {
+                "userName": "SYSTEM_USER",
+                "displayName": "系统"
+            },
+            "recordCreatedTime": "2025-05-21T02:27:37.000Z",
+            "nodeOperationComment": null,
+            "nodeOperation": "end",
+            "nodeOperationDisplayText": "结束"
+        },
+        {
+            "nodeTitle": "审批任务2",
+            "recordUser": {
+                "userName": "DEVACC-wftestprocess313",
+                "displayName": "DEVACC-wftestprocess313"
+            },
+            "recordCreatedTime": "2025-05-21T02:27:37.000Z",
+            "nodeOperationComment": "好的",
+            "nodeOperation": "approve",
+            "nodeOperationDisplayText": "同意"
+        },
+        {
+            "nodeTitle": "审批任务1",
+            "recordUser": {
+                "userName": "DEVACC-wftestprocess313",
+                "displayName": "DEVACC-wftestprocess313"
+            },
+            "recordCreatedTime": "2025-05-21T02:27:19.000Z",
+            "nodeOperationComment": "ok",
+            "nodeOperation": "approve",
+            "nodeOperationDisplayText": "同意"
+        },
+        {
+            "nodeTitle": "开始",
+            "recordUser": {
+                "userName": "DEVACC-wftestprocess313",
+                "displayName": "DEVACC-wftestprocess313"
+            },
+            "recordCreatedTime": "2025-05-21T02:25:26.000Z",
+            "nodeOperationComment": null,
+            "nodeOperation": "launch",
+            "nodeOperationDisplayText": "启动"
+        }
+    ],
+    "total": 4
+}
+```
+
+***
+
+### getProcInstRecordsByInstId
+
+获取流程的审批记录列表。
+
+按流程实例id查询审批记录，返回值中包含了流程在何时进行了何种操作。也可使用[getProcInstRecords逻辑](getProcInstRecords)根据任务实例id查询流程记录。该逻辑可用于手动搭建[流程记录组件](../../10.页面设计/20.PC端Vue2组件说明（默认）/96.流程/35.流程记录（流程2.0）.md)。
+
+<img src="../assets/liuchengluojishiyongshuoming_202505201901_5.png" class="imgStyle" style="max-width: 700px;" />
+
+**输入参数**：
+
+- procInstId：流程实例id，String类型，必填。
+- page：页码，默认为1。
+- size：每页条数，默认为20。
+
+**输出参数**：
+
+参考[getProcInstRecords](#getprocinstrecords)逻辑。
+
+***
+
+### getProcessInstanceList
+
+
+查询流程实例列表，根据逻辑入参中的各类筛选条件查询流程实例。
+
+<img src="../assets/liuchengluojishiyongshuoming_202410081754_3.png" class="imgStyle" style="max-width: 700px;" />
+
+**输入参数**：
+
+- processInstanceId：流程实例id，选填项。
+- startBy：流程实例的发起人用户名，即userName，选填项。
+- startTimeBefore：流程发起时间的结束日期，DateTime类型，选填项。
+- startTimeAfter：流程发起时间的开始日期，DateTime类型，选填项。
+- finished：是否已结束，布尔类型，选填项。
+- processDefName：流程定义标题，模糊查询，String类型，选填项。流程定义标题可在流程的属性面板中查看，也可通过[getProcDefInfos](#getprocdefinfos)逻辑（查询流程定义名称列表）获取。
+- page：页数，Integer类型，选填项，默认为1。
+- size：数据条数，Integer类型，选填项，默认为20。
+
+**输出参数**：
+
+输出参数的数据结构如下。
+```
+{
+    list:List<ProcInstInfo>,
+    total:Integer整数
+}
+```
+- list：待办任务列表，**ProcInstInfo**类型的属性说明请参考下文。
+- total：待办任务总数。
+
+**ProcInstInfo属性说明**
+
+| 参数                    | 类型              | 说明                                   |
+| :-------------------- | :-------------- | :----------------------------------- |
+| processDefinitionName | String          | 流程定义名称                               |
+| procInstId            | String          | 流程实例ID                               |
+| procInstInitiator.userName     | String          | 发起人的用户名的                               |
+| procInstInitiator.displayName     | String          | 发起人的用户昵称                               |
+| procInstStartTime     | DateTime        | 流程实例发起时间                             |
+| procInstStatus        | String            | 流程实例当前状态，Approved为审批通过，Approving为审批中，Suspended为挂起 |
+| procInstCurrNodes     | List\<CurrNode> | 流程实例的当前节点列表，[CurrNode数据结构](#currnode属性说明)参考附录。   |
+| procInstEndTime       | DateTime        | 流程实例结束时间                             |
+
+**输出结果示例**：
+```json
+{
+    "list":[
+        {
+            "procInstId":"ed6e3382-35f4-11f0-9dbc-5e9488c65640",
+            "procInstInitiator":{
+                "userName":"Tom",
+                "displayName":"汤姆"
+            },
+            "procInstStartTime":"2025-05-21T03:37:32.000Z",
+            "procInstEndTime":null,
+            "procInstStatus":"Approving",
+            "procInstCurrNodes":[
+                {
+                    "currNodeTitle":"审批任务1",
+                    "currNodeParticipants":[
+                        {
+                            "userName":"DEVACC-wftestprocess313",
+                            "displayName":"DEVACC-wftestprocess313"
+                        }
+                    ],
+                    "taskId":"ed79a559-35f4-11f0-9dbc-5e9488c65640"
+                }
+            ],
+            "processDefinitionName":"请假流程",
+            "processDefinitionTitle":"请假流程"
+        },
+        {
+            "procInstId":"dadb7530-35ea-11f0-9dbc-5e9488c65640",
+            "procInstInitiator":{
+                "userName":"DEVACC-wftestprocess313",
+                "displayName":"DEVACC-wftestprocess313"
+            },
+            "procInstStartTime":"2025-05-21T02:25:26.000Z",
+            "procInstEndTime":"2025-05-21T02:27:37.000Z",
+            "procInstStatus":"Approved",
+            "procInstCurrNodes":[
+                {
+                    "currNodeTitle":"结束",
+                    "currNodeParticipants":null,
+                    "taskId":null
+                }
+            ],
+            "processDefinitionName":"请假流程",
+            "processDefinitionTitle":"请假流程"
+        }
+    ],
+    "total":2
+}
+```
+
+***
+
+### getTaskInstanceList
+
+获取流程任务实例列表，根据逻辑入参中的各类筛选条件查询任务实例。
+
+<img src="../assets/liuchengluojishiyongshuoming_202505201901_6.png" class="imgStyle" style="max-width: 700px;" />
+
+**输入参数**：
+
+- 流程（procDefKey）：根据流程定义key进行查询，<span style="color: orange;">**为空时默认查询所有流程**</span>。流程定义的ID可通过[getProcDefInfos](#getprocdefinfos)、[getTaskInfo](#gettaskinfo)等逻辑获取，也可以在IDE中选中流程后从右侧属性面板中查看。
+
+    <img src="../assets/liuchengluojishiyongshuoming_202412161531_1.png" class="imgStyle" style="max-width: 300px;" />
+
+- procInstId：根据流程实例ID进行筛选，String类型。
+- procInstInitiator：流程实例的发起人用户名，即userName，String类型。
+- candidateUser：任务处理人的用户名，即userName，String类型。
+- finished：任务是否已结束，布尔类型。
+- page：页码，默认为1。
+- size：每页条数，默认为20。
+
+**输出参数**：
+
+    {
+    	list:List<TaskInst>,
+    	total:Integer整数
+    }
+
+*   list：待办任务列表，MyPendingTask类型的属性说明请参考下文。
+*   total：待办任务总数。
+
+**TaskInst属性说明**
+
+| 参数                | 类型               | 说明                                                         |
+| ------------------- | ------------------ | ------------------------------------------------------------ |
+| taskId              | String             | 任务实例id                                                   |
+| title               | String             | 节点标题                                                     |
+| description         | String             | 节点描述                                                     |
+| taskTitle           | String             | 任务标题                                                     |
+| taskDescription     | String             | 任务描述                                                     |
+| finished            | Boolean            | 任务是否已完成                                               |
+| completeBy.userName          | String   | 任务完成人的唯一标识名    |
+| completeBy.displayName          | String   | 任务完成人的昵称   |
+| createTime          | DateTime           | 任务创建时间                                                 |
+| completeTime        | DateTime           | 任务关闭时间                                                 |
+| taskDefName         | String             | 任务定义名                                                   |
+| category            | String             | 任务类型，请参考[任务节点类型](#任务节点类型)                   |
+| processInstanceId   | String             | 流程实例id                                                   |
+| processDefUniqueKey | String             | 流程定义的key                                            |
+| processDefinitionId | String             | 流程定义id                                                   |
+| candidateUsers      | List\<ProcessUser>       | 任务的参与人列表，表示该任务需要由哪些人参与审批，不是最终完成审批的用户。 |
+| approvalResult      | Boolean            | 审批结果                                                     |
+| approvalComment     | String             | 审批意见                                                     |
+| processDefName      | String             | 流程定义名称                                                 |
+| procInstStatus      | ProcInstStatusEnum | 流程实例状态，枚举类型，Approving代表审批中，Approved代表审批结束。 |
+| approvalPolicy      | String             | 多人审批策略：<br>- simple（或签） <br> - parallel（会签）<br> - sequence（多人审批）  |
+
+
+
+
+**输出结果示例**：
+```json
+{
+    "list": [
+        {
+            "taskId": "956502fc-5a3b-11ef-9c65-00ff36813e87",
+            "title": null,
+            "description": null,
+            "taskTitle": "开始",
+            "taskDescription": null,
+            "finished": true,
+            "completeBy":
+            {
+                "userName":"张三",
+                "displayName":"张三"
+            },
+            "createTime": "2024-08-14T12:49:03.000Z",
+            "completeTime": "2024-08-14T12:49:03.000Z",
+            "taskDefName": "Start",
+            "category": null,
+            "processInstanceId": "95648d9d-5a3b-11ef-9c65-00ff36813e87",
+            "processDefUniqueKey": "Process_3b3f9bac",
+            "processDefinitionId": "Process_3b3f9bac:1:61ae0594-556f-11ef-90ac-00ff36813e87",
+            "candidateUsers": [
+                {
+                    "userName":"DEVACC-test003",
+                    "displayName":"DEVACC-test003"
+                }
+            ],
+            "approvalResult": null,
+            "approvalComment": null,
+            "processDefName": "流程1",
+            "procInstStatus": "Approving"
+        },
+        {
+            "taskId": "956662ba-5a3b-11ef-9c65-00ff36813e87",
+            "title": null,
+            "description": null,
+            "taskTitle": "审批任务1",
+            "taskDescription": null,
+            "finished": false,
+            "completeBy": null,
+            "createTime": "2024-08-14T12:49:03.000Z",
+            "completeTime": null,
+            "taskDefName": "ApprovalTask1",
+            "category": null,
+            "processInstanceId": "95648d9d-5a3b-11ef-9c65-00ff36813e87",
+            "processDefUniqueKey": "Process_3b3f9bac",
+            "processDefinitionId": "Process_3b3f9bac:1:61ae0594-556f-11ef-90ac-00ff36813e87",
+            "candidateUsers": [
+                {
+                    "userName":"DEVACC-test003",
+                    "displayName":"DEVACC-test003"
+                }
+            ],
+            "approvalResult": null,
+            "approvalComment": null,
+            "processDefName": "流程1",
+            "procInstStatus": "Approving"
+        }
+    ],
+    "total": 2
+}
+```
+
+***
+
+### getBackNodes
+
+查询可回退节点列表。流程在进行回退操作时需要选择回退到某个特定节点，可从该逻辑的输出结果中选择一个作为回退节点。
+
+<img src="../assets/liuchengluojishiyongshuoming_202504071425_2.png" class="imgStyle" style="max-width: 600px;" />
+
+**输入参数**
+
+- taskId：流程任务id，String类型，必填。
+
+**输出参数**
+
+输出可回退节点的列表，`List<RevertFlowNode>`类型。
+
+**RevertFlowNode属性说明**
+
+| **参数**              | **类型**             | **说明**                                     |
+| :------------------ | :----------------- | :----------------------------------------- |
+| nodeId      | String             | 节点id                                     |
+| nodeName | String             | 节点标题                                   |
+
+输出结果示例：
+
+```json
+[
+    {
+        "nodeId": "ApprovalTask3",
+        "nodeName": "主管审批"
+    },
+    {
+        "nodeId": "Start",
+        "nodeName": "开始"
+    }
+]
+```
+***
+
+### getProcInstGraph
+
+获取流程图，将该逻辑的输出结果进行处理后可作为流程图组件的数据源。
+
+<img src="../assets/liuchengluojishiyongshuoming_202504071425_4.png" class="imgStyle" style="max-width: 800px;" />
+
+使用方式：流程图组件需要`List<ProcInstGraph>`类型数据，将该逻辑的输出结果作为List中的第一条即可，可以直接在组件数据源中使用**新建**组件创建<b>List&lt;ProcInstGraph&gt;</b>，如下所示。
+
+<img src="../assets/liuchengluojishiyongshuoming_202504071425_3.png" class="imgStyle" style="" />
+
+**输入参数**
+
+- taskId：流程任务id，String类型，必填。
+
+**输出参数**
+
+输出流程图数据，`ProcInstGraph`类型。
+
+***
+
+### getProcVariable
+
+获取流程变量。包括流程实例ID和发起人的信息。
+
+<img src="../assets/liuchengluojishiyongshuoming_202504071654_1.png" class="imgStyle" style="max-width: 600px;" />
+
+**输入参数**
+
+- taskId：流程任务id，String类型，必填。
+
+**输出参数**
+
+输出`ProcVariable`类型。
+
+**ProcVariable属性说明**
+
+| 参数                   | 类型            | 说明                 |
+| :------------------- | :------------ | :----------------- |
+| procInstStartBy     | ProcessUser        | 流程发起人信息               |
+|   - userName属性   | String        | 用户名               |
+|   - displayName属性 | String        | 用户昵称               |
+| procInstId           | String        | 流程实例ID               |
+
+**输出结果示例**：
+
+```json
+{
+    "procInstStartBy": {
+        "userName": "zhangsan01",
+        "displayName": "张三"
+    },
+    "procInstId": "1c5033e5-138d-11f0-8025-563f44648fec"
+}
+```
+
+***
+
+### setCurrentProcessUser
+
+设置当前流程用户。
+
+默认情况下流程会使用请求上下文中的用户作为流程用户，如果请求上下文中未包含用户信息（例如开放接口供外部调用），则可以调用该逻辑手动声明流程用户。在业务逻辑结束后需要再次调用该逻辑并设置用户为null，否则可能会影响到后续请求中的流程用户。
+
+> 流程上下文用户的原理介绍:
+>
+> 应用登录成功之后服务端会向页面写cookie，cookie中包含了编码后的userName等用户信息，页面后续调用服务端接口时会自动携带该信息用于认证。例如，用户“张三”登陆成功之后，服务端向页面写入的cookie中包含了编码后的`{name:张三,userId:10001}`数据，后续在页面上向服务端发送请求时会携带该数据，服务端便知道了请求是来自哪个用户。
+>
+> 同样地，在操作流程时之所以不需要用户参数（例如发起流程、同意审批、查询我的待办），也是因为应用收到的接口请求里已经包含了请求方的用户信息，知道是哪个用户在操作流程。但如果接口请求不是来自于页面，则缺少了用户信息，此时流程上下文用户也就是空的，所以需要通过该逻辑来显式指定流程用户，以表示“接下来是以哪个用户的身份操作流程”。
+>
+> 需要注意的是，调用该逻辑后，其流程上下文用户数据的生命周期为**线程级别**，而非请求级别，由于线程可能被后续的请求复用，所以需要在业务逻辑结束后调用该逻辑并设置用户为null，否则会因为线程复用导致流程上下文用户数据被保留到后续的请求中。
+
+
+<br>
+
+<img src="../assets/liuchengluojishiyongshuoming_202504081440_1.png" class="imgStyle" style="max-width: 600px;" />
+
+**输入参数**：
+
+- processUser：用户信息，`ProcessUser`类型，必填。
+
+**使用说明**：
+
+适用于需要将服务端逻辑开放接口供外部调用的场景，例如，开放一个接口用于查询我的发起，这种情况下需要手动声明当前的流程上下文用户，示例如下。
+
+<img src="../assets/liuchengluojishiyongshuoming_202504081440_2.png" class="imgStyle" style="" />
+
+<img src="../assets/liuchengluojishiyongshuoming_202504081440_3.png" class="imgStyle" style="max-width: 700px;" />
+
+注意，在业务逻辑结束后要再次调用该逻辑并设置用户为null，否则这个流程上下文用户数据可能会影响后续的请求导致用户数据错乱。
+
+<img src="../assets/liuchengluojishiyongshuoming_202507311947_1.png" class="imgStyle" style="" />
+
+***
+
+### getTaskFormDef
+
+获取任务的表单定义。
+
+流程表单组件会自动调用该接口以获取页面上需要展示的表单定义，该逻辑无需用户显式调用。
+
+***
+
+### addTaskComment
+
+手动添加审批记录。
+
+<img src="../assets/liuchengluojishiyongshuoming_202505231019_3.png" class="imgStyle" style="max-width: 600px;" />
+
+添加的审批记录可通过[getProcInstRecords](#getprocinstrecords)和[getProcInstRecordsByInstId](#getprocinstrecordsbyinstid)逻辑查询，或使用[流程记录](../20.流程2.0/50.流程组件.md)组件快捷生成页面。
+
+<img src="../assets/liuchengluojishiyongshuoming_202505231019_4.png" class="imgStyle" style="max-width: 800px;" />
+
+**输入参数**：
+
+- curNode：当前节点，String类型，必填。由于taskId参数已经能够获取到对应的节点，此参数可填为null。
+- userName：用户名，String类型，必填。
+- recordCreateTime：处理时间，审批记录中对应的时间，String类型，必填。
+- action：执行的操作，String类型，必填，可用的值请参考[流程操作](#流程操作)。
+- comment：审批意见，String类型，审批人执行操作时传入的评论留言。
+- taskId：任务实例ID，String类型，必填。
+
+***
+
+### ccTask
+
+将任务抄送给指定用户，可以抄送已完成的任务，可以一次抄送给多个用户。
+
+挂起状态的流程也可以使用该逻辑实现抄送。
+
+<img src="../assets/liuchengluojishiyongshuoming_202507071730_1.png" class="imgStyle" style="width:500px;" />
+
+**输入参数**：
+
+- taskId：任务实例ID，String类型，必填。
+- ccedUsers：用户名列表，List\<String>类型，必填：
+
+***
+
+### suspendProcess
+
+挂起流程实例，挂起后将无法操作该流程，但可以正常查询该流程。该逻辑无返回结果。
+
+无法操作流程实例意味着：通过流程逻辑执行流程操作会失败，包括：同意、拒绝、提交、回退、撤回、转派、加签。ccTask抄送逻辑可正常使用。
+
+<img src="../assets/liuchengluojishiyongshuoming_202507071730_2.png" class="imgStyle" style="width:500px;" />
+
+**输入参数**：
+
+- processId：流程实例ID，String类型，必填。
+
+***
+
+### activateProcess
+
+激活流程实例，取消挂起。
+
+<img src="../assets/liuchengluojishiyongshuoming_202507071730_3.png" class="imgStyle" style="width:500px;" />
+
+- processId：流程实例ID，String类型，必填。
+
+***
+
+## 附录
+
+### CurrNode属性说明
+
+| 参数                   | 类型            | 说明                 |
+| :------------------- | :------------ | :----------------- |
+| currNodeTitle        | String        | 当前节点标题，如“审批任务1”             |
+| currNodeParticipants | List\<ProcessUser> | 当前节点参与人列表，列表项中包含了每个用的的userName和displayName |
+| taskId | String | 任务实例ID |
+
+### ProcessUser属性说明
+
+在低版本的流程中使用userName字段作为参与流程的人员信息标识，考虑到用户名可能存在相同的情况，在新版本中增加了displayName字段作为人员的展示名称（可相同），而userName则需要确保唯一。
+
+| 参数                   | 类型            | 说明                 |
+| :------------------- | :------------ | :----------------- |
+| userName        | String        | 用户名，通常是唯一的             |
+| displayName | String | 用户昵称 |
+
+### 流程操作
+
+流程中执行的操作对应的字段值如下。
+getTaskOperationPermissions逻辑（获取任务操作权限）的查询结果中仅包含：同意、拒绝、提交、转派、撤回、加签、回退。
+
+| 操作名称     | 默认显示名称 | 可通过获取任务操作权限的逻辑查询 | 操作说明                                    |
+| :------- | :-----| :-----  | :-------------------------------------- |
+| approve  | 同意    | 是 | 审批同意，流程继续往下走。                           |
+| reject   | 拒绝    | 是 | 审批拒绝，流程继续往下走。                           |
+| submit   | 提交    | 是 | 提交流程，仅在流程回到开始节点后才可用。                    |
+| reassign | 转派    | 是 | 将任务转派给其他用户，默认仅支持转派给一个用户                 |
+| withdraw | 撤回    | 是 | 任务从开始节点流转到下一个节点后，任务未被处理前可使用撤回，使其回到开始节点。 |
+| addSign  | 加签    | 是 | 为任务实例增加审批人                              |
+| revert   | 回退    | 是 | 将任务从当前节点退回到指定节点。              |
+| launch   | 启动    | 否 | 发起流程时将自动记录一个launch操作              |
+| terminate   | 终止    | 否 | 终止流程，当流程需要临时取消或者流程异常的情况下可手动终止。              |
+| end   | 结束    | 否 | 流程结束时将自动记录一个end操作              |
+| cc   | 抄送    | 否 | 将任务抄送给其他用户，不影响流程的运行              |
+| suspendProcess   | 挂起流程    | 否 | 挂起后将无法操作流程，但可以正常查询              |
+| activateProcess   | 恢复流程    | 否 | 恢复已挂起的流程              |
+
+### 任务审批策略
+
+| 审批策略 | 值 |
+| :-- | :- |
+| 或签 | simple |
+| 会签 | parallel |
+| 依次审批 | sequence |
+
+### 任务节点类型
+
+| 任务类型 | 值 |
+| :-- | :- |
+| 审批任务 | ApprovalTask |
+| 自动任务 | ServiceTask |
+| 发起任务 | InitiateTask |
+| 抄送任务 | CCTask |
+| 提交任务 | SubmitTask |
+
+### 流程实例状态
+
+流程有三种状态：审批中、审批结束、挂起。
+
+部分逻辑的返回结果中包含了流程实例的状态：
+
+| 状态 | 值 | 含义 |
+| :-- | :- | :- |
+| 审批中 | Approving | 流程处于正常流转状态,尚未结束 |
+| 审批结束 | Approved | 流程已结束，无法继续操作 |
+| 挂起 | Suspended | 流程已使用suspendProcess逻辑挂起，无法执行操作，可通过activateProcess逻辑取消挂起 |
+
+<div style="text-align: right;font-size: 14px;">
+    <span style="color: rgb(78, 110, 142);">创建人：</span>
+    <span style="color: rgb(118, 118, 118);">老王</span>
+    <span style="color: rgb(78, 110, 142);margin: 0 0 0 40px;">更新时间：</span>
+    <span style="color: rgb(118, 118, 118);">2025年07月31日</span>
+</div>