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/80./346/265/201/347/250/213/347/211/210/346/234/254/347/256/241/347/220/206/350/257/264/346/230/216.md

@@ -0,0 +1,78 @@
+# 流程版本管理说明
+
+## 功能概述
+
+在流程1.0中，对已上线流程定义的修改可能会导致流程实例产生异常，例如在修改流程时删除了某个任务节点，而刚好有运行中的流程处于该节点。
+
+为解决修改流程导致线上运行流程产生异常的情况，流程2.0支持流程定义的多版本管理能力，流程正式发布后运行的流程标记了版本，发起流程实例时跟具体版本关联。当开发者需要修改流程时，通过增加流程版本的方式迭代发布，从而实现修改流程不会影响历史流程实例数据的目的。
+
+流程版本主要有三种状态：
+
+- **设计中**：流程设计阶段，可同时存在多个设计中的版本，但只有被标记为“预览使用”的版本才会发布到开发环境，新建流程时默认V1版本的状态为设计中。
+
+- **已启用**：流程设计完成，可正式发布到生产环境上线使用，启用前已存在的流程实例按照旧版本正常运行，启用后新发起的流程实例按照新版本运行。
+
+- **历史**：已经启用过的历史版本，历史版本无法编辑，但可基于历史版本创建新版本。
+
+<img src="../assets/liuchengbanbenguanlishuoming_20240705_1.png" style="width:500px;" />
+
+## 使用方式
+
+建议按以下使用方式来推进流程版本的正常迭代：
+
+  1. 新建流程后默认有V1版本，设计流程，发布预览到开发环境查看效果，可重复修改并发布到预览环境。
+
+  2. V1版本在预览环境中验证无误后，启用该版本，发布到生产环境中使用。
+
+  3. 需要修改流程时，基于已启用的版本创建新版本，可创建多个新版本，多个版本均可修改，选择其中一个版本标记为“预览使用”，发布到开发环境中验证该版本流程的效果。
+
+  4. 新版本在开发环境下验证无误后，可启用该版本并发布生产环境，启用后，旧的启用版本将成为历史版本，可预览使用历史版本，或基于历史版本创建新版本。
+
+<br>
+
+流程版本可添加版本描述，点击版本上的编辑图标后输入版本描述即可。创建新版本时也可选填版本描述。
+
+<img src="../assets/liuchengbanbenguanlishuoming_20240705_2.png" style="max-width:800px;" />
+
+## 注意事项
+
+使用流程版本时有以下注意事项：
+
+- 发布预览到开发环境时，需要确认标记为“预览使用”的版本是期望的版本，预览使用的版本仅在开发环境下生效。
+- 发布到生产环境时，需要确认标记为“已启用”的版本是期望的版本，已启用版本仅在生产环境下生效；
+- 已启用和历史版本的流程仅支持查看，不支持修改，需要修改时请基于该版本创建新版本并在新版本中修改。
+
+## 操作示例
+
+1. 新建流程后，默认有处于设计中的V1版本且已经标记为“预览使用”，在流程设计完成后可发布预览到开发环境测试效果，可重复修改并发布到开发环境。
+
+    <img src="../assets/liuchengbanbenguanlishuoming_20240705_3.png" style="width:70%;border: 1px solid #ccc;" />
+
+2. V1版本在预览环境中验证无误后，可启用V1版本，发布到生产环境中使用。
+
+    <img src="../assets/liuchengbanbenguanlishuoming_20240705_4.png" style="width:70%;border: 1px solid #ccc;" />
+
+    如果发布生产环境时没有启用中的流程，则会弹窗提示。
+
+    <img src="../assets/liuchengbanbenguanlishuoming_20240705_5.png" style="width:70%;border: 1px solid #ccc;" />
+
+3. 流程版本被启用后，处于已启用中的流程版本不可编辑，如果要修改流程，可以基于已启用的版本创建新版本，在新版本上进行修改。
+
+    <img src="../assets/liuchengbanbenguanlishuoming_20240705_6.png" style="width:70%;border: 1px solid #ccc;" />
+
+4. 可创建多个新版本，多个设计中的版本均可修改，要将设计中的版本发布到开发环境进行预览时，需要将其标记为“预览使用”才能在发布预览时生效。
+
+    <img src="../assets/liuchengbanbenguanlishuoming_20240705_7.png" style="width:70%;border: 1px solid #ccc;" />
+
+5. 开发环境下新版本验证无误后，可启用该版本并发布生产环境，启用后，旧的启用版本将成为历史版本。
+
+    发布生产环境后，过去已经发起的流程依然按照旧版的流程定义执行，新发起的流程则按照新启用版本执行，即线上会同时存在多个版本的流程定义。
+
+    <img src="../assets/liuchengbanbenguanlishuoming_20240705_8.png" style="width:70%;border: 1px solid #ccc;" />
+
+<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);">2024年07月05日</span>
+</div>

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/90./346/265/201/347/250/213/344/275/277/347/224/250/345/270/270/350/247/201/351/227/256/351/242/230.md

@@ -0,0 +1,242 @@
+# 流程使用常见问题
+
+| 流程常见问题清单           |
+| -------------------------- |
+| [或签、会签、依次审批的区别](#或签、会签、依次审批的区别) |
+| [如何动态设置流程节点审批人](#如何动态设置流程节点审批人) |
+| [如何获取任务的审批结果](#如何获取任务的审批结果)   |
+| [流程2.0能否降级到流程1.0](#流程2-0能否降级到流程1-0)   |
+| [审批过程中如何通知相关人员](#审批过程中如何通知相关人员)   |
+| [我的流程、任务箱组件如何将审批链接从新窗口打开](#我的流程、任务箱组件如何将审批链接从新窗口打开)   |
+| [流程中userName字段的注意事项](#流程中username字段的注意事项) |
+| [查询任务节点的多人审批方式（或签/会签/多人审批）](#查询任务节点的多人审批方式)|
+| [流程中的事务控制](#流程中的事务控制) |
+
+## 或签、会签、依次审批的区别
+
+审批任务提供三种多人审批方式，可根据具体的业务需求进行选择。
+
+<img src="../assets/liuchengshiyongfaq_0410_1.png" alt="0" style="width:350px;border: 1px solid #ccc;" />
+
+**或签**
+
+或签是指在同一审批节点上的多个审批人中，只要有任意一人完成审批，审批流程就可以立即继续到下一个环节，不需要所有审批人均同意。
+
+例如，或签节点设置了三个审批人，当第一个审批人执行了审批操作后，该任务便结束，其他审批人无法再审批该任务。
+
+<img src="../assets/liuchengshiyongfaq_0410_2.jpg" alt="0" style="width:400px;" />
+
+**会签**
+
+会签是指在同一审批节点上有多个审批人，所有审批人都会同时收到审批提醒，并且只有当同意的人数达到满足的数量后，该任务才算作审批通过。
+
+例如，当审批通过人数设置为50%，有三人参与审批，流程流转到该节点时三个审批人都可以审批任务，当有两个审批通过时，该任务便直接结束，审批结果为通过，无需等待所有人完成审批。
+
+<img src="../assets/liuchengshiyongfaq_0410_3.jpg" alt="0" style="width:400px;" />
+
+**依次审批**
+
+依次审批是指多个审批人在同一节点上按照预先设定的顺序逐个进行审批，有一个审批不通过则视为该任务审批不通过。
+
+例如，审批人分别为甲-乙-丙，流程流转到该节点时首先由甲进行审批，当甲审批同意后，再由乙进行审批，乙审批如果同意则由丙审批，乙审批如果拒绝则该任务的审批结果为拒绝，丙无需执行审批，流程继续向下运行。
+
+<img src="../assets/liuchengshiyongfaq_0410_4.jpg" alt="0" style="width:400px;" />
+
+## 如何动态设置流程节点审批人
+
+业务场景中可能要求动态指定流程节点的审批人，可以在设置流程节点审批人时使用流程变量或流程逻辑。
+
+* 使用流程变量作为审批人：需要为流程关联的实体添加一个属性，代表某流程节点的审批人。注意，流程变量值的内容应为审批人的userName，多个审批人时使用英文逗号拼接userName。
+* 使用流程逻辑作为审批人：可根据具体业务需求查询审批人，逻辑的输出参数List\<string>代表审批人userName列表。
+
+示例：
+
+下图的流程中，“多部门主管审批”节点的审批人使用流程变量，在发起流程时输入该节点的审批人，可参考下文操作步骤实现。
+
+<img src="../assets/liuchengshiyongfaq_0410_5.png" alt="0" style="width:900px;" />
+
+流程对应的实体，创建一个String类型的属性用于录入“多部门主管审批”节点的审批人。
+
+<img src="../assets/liuchengshiyongfaq_0410_6.png" alt="0" style="border: 1px solid #ccc;" />
+
+配置“多部门主管审批”节点的审批人，选择流程变量，使用上文创建的属性。
+
+![0](../assets/liuchengshiyongfaq_0410_7.png)
+
+在发起流程的表单中使用组件录入审批人，下图使用选择器组件录入审批人。
+
+注意事项：
+
+* 审批人的值为userName，设置组件的值字段时应注意选择LCAPUser.userName。
+* 需要多选审批人时，必须为选择器组件开启“可多选”属性，并将“转换器”属性切换为“以','连接”。
+
+<img src="../assets/liuchengshiyongfaq_0410_8.png" alt="0" style="border: 1px solid #ccc;" />
+
+实现效果：
+
+<img src="../assets/liuchengshiyongfaq_0410_9.png" alt="0" style="border: 1px solid #ccc;" />
+
+<img src="../assets/liuchengshiyongfaq_0410_10.png" alt="0" style="border: 1px solid #ccc;" />
+
+该案例是在发起流程时动态配置审批人，同样地，需要在流程审批过程中指定后续节点的审批人时，可在流程表单中使用相同的方式录入审批人。
+
+
+## 如何获取任务的审批结果
+
+可通过多种方式获取审批任务的审批结果：
+
+- **方式一：使用流程变量获取任务的审批结果**：
+
+    在流程事件或自动任务中可以使用流程变量，选择审批节点的nodeOutcome属性可以获取到该节点的审批结果（同意或拒绝），对应两种字符串值：
+    - Approved：审批结果为同意。
+    - Rejected：审批结果为拒绝。
+    
+    使用方式如下图所示。
+
+    <img src="../assets/liuchengshiyongfaq_202409101617_1.png" alt="0" style="border: 1px solid #ccc;" />
+
+- **方式二：使用流程逻辑查询任务的审批结果**：
+    
+    [流程逻辑](../20.流程2.0/70.流程逻辑使用说明.md)中有一些逻辑可以查询任务的详细信息，返回结果中的finished字段代表任务的审批结果，例如：
+    - getTaskInstanceList：根据筛选条件查询任务实例列表。
+    - getTaskInfo：根据任务ID查询任务信息。
+
+- **方式三：在分支上将任务审批结果作为判断条件**
+
+  在设计流程时如果使用了唯一分支或并行分支，则选中分支连线后可以设置分支条件，在分支条件中可以将“流程变量”下的审批节点作为判断规则。
+
+  <img src="../assets/liuchengshiyongchangjianwenti_202411111909_1.png" alt="0" style="border: 1px solid #ccc;width:500px;" />
+
+
+## 流程2.0能否降级到流程1.0
+
+不推荐使用流程1.0。由于流程1.0和2.0不能共存，1.0设计的流程建议使用2.0重构。
+如果必须要使用流程1.0，可参考以下操作：
+
+- 3.7~3.11版本的应用：可以通过系统偏好设置中的开关关闭流程2.0。
+
+  <img src="../assets/liuchengshiyongchangjianwenti_202412171442_1.png" alt="0" style="border: 1px solid #ccc;width:300px;" />
+
+  关闭前必须删除应用中定义的2.0流程。
+
+  <img src="../assets/liuchengshiyongchangjianwenti_202412171442_2.png" alt="0" style="border: 1px solid #ccc;width:300px;" />
+
+- 3.12及以上版本的应用：不再提供流程2.0的开关，新建的流程默认为2.0，只有当前应用中存在1.0流程时才提供开关。
+
+
+## 审批过程中如何通知相关人员
+
+在流程审批过程中可能需要向相关人员发送通知，使其能够了解流程审批进度，可采用多种方式实现。
+
+- **方式一：调用接口或连接器**
+
+    在设计流程时，可以在自动任务或者流程事件的逻辑中[调用接口](../../../40.扩展与集成/20.集成开发方式/30.应用API集成/10.应用API管理功能.md)或[连接器](../../../40.扩展与集成/20.集成开发方式/20.连接器集成/30.自定义连接器/15.如何自定义连接器.md)，实现向外部发送消息。例如向钉钉、微信、飞书等平台发送消息，或者发送电子邮件。
+
+
+    - **使用自动任务**：当流程流转到该节点时，会自动执行自动任务中的逻辑，在自动任务的逻辑中使用连接器或调用接口组件即可。也可以创建一个服务端逻辑用于发送消息，在自动任务中调用该逻辑。
+
+        <img src="../assets/liuchengshiyongchangjianwenti_202501151842_1.png" class="imgStyle" style="" />
+
+        <img src="../assets/liuchengshiyongchangjianwenti_202501151842_2.png" class="imgStyle" style="" />
+
+    - **使用任务事件**：选中流程中的任务节点后，在右侧属性面板中选择“事件”，点击加号即可创建任务级别事件，在事件逻辑中调用接口或连接器实现消息通知。
+
+        <img src="../assets/liuchengjiedianpeizhishuoming_0417_2.png" style="border: 1px solid #ccc;" />
+
+    - **使用流程事件**：选中流程后，在右侧属性面板中选择“事件”，点击加号即可创建流程级别事件，在事件逻辑中调用接口或连接器实现消息通知。
+
+        <img src="../assets/liuchengjiedianpeizhishuoming_0417_1.png" style="border: 1px solid #ccc;" />
+
+- **方式二：使用抄送任务。**
+
+    在设计流程时可以使用抄送任务组件，抄送任务用于提醒相关人员查看流程进度或流程处理结果，不需要被审批。流程流转到抄送任务后会创建一个抄送任务给抄送人，并自动流转到下一个节点。
+
+    <img src="../assets/liuchengjiedianpeizhishuoming_202410081647_1.png"  style="" />
+
+    **如何查看抄送任务？**
+
+    使用“我的流程”组件可以快捷查询抄送给当前登录用户的任务。
+
+    <img src="../assets/liuchengshiyongchangjianwenti_202501151842_3.png" class="imgStyle" style="" />
+
+    开发者也可以搭建自定义的通知界面，调用流程逻辑getMyCCTasks查询抄送任务。
+
+    例如，任务箱组件默认情况下是展示待办任务，可以通过手动搭建任务箱的方式修改任务箱中的展示内容，使其在展示待办任务的同时也能够展示抄送任务。手动搭建任务箱的案例可参考文档：[使用基础组件搭建流程场景 - 如何自定义PC端任务箱](../20.流程2.0/55.使用基础组件搭建流程场景.md)，可以在此基础上同时查询抄送任务，任务箱便可以同时展示待办和抄送。
+
+    <img src="../assets/liuchengshiyongchangjianwenti_202501151842_4.png" class="imgStyle" style="" />
+
+## 我的流程、任务箱组件如何将审批链接从新窗口打开
+
+系统提供的我的流程组件和任务箱组件可以快捷跳转到审批页面，但是默认是从当前页面进行跳转，在实际项目需求中可能希望是从新窗口打开审批页面，从而保留跳转之前的页面。
+
+当需要对流程组件进行个性化修改时，可以用基础组件手动搭建该流程组件，从而实现自定义的流程界面元素。具体实现方式可参考文档：[使用基础组件搭建流程场景](../20.流程2.0/55.使用基础组件搭建流程场景.md)。
+
+![0](../assets/liuchengshiyongchangjianwenti_202501131800_1.png)
+
+使用基础组件搭建了我的流程或者任务箱之后，在进行页面跳转时可以将“链接打开方式”修改为“从新窗口打开”。
+
+![0](../assets/liuchengshiyongchangjianwenti_202501131800_2.png)
+
+## 流程中userName字段的注意事项
+
+流程中代表用户身份标识的字段是LCAPUser实体的userName字段，需要注意以下几点：
+
+- 修改LCAPUser实体的userName字段后，流程中的userName不会自动同步修改，这会导致任务找不到审批人，谨慎修改用户表的userName字段。
+
+- 考虑到应用中可能有姓名重复的情况，建议将LCAPUser实体的displayName作为用户的展示名称，而userName则需要确保唯一性，如果系统中有重复的userName，则会导致同一个任务被多个同名用户收到。
+
+## 查询任务节点的多人审批方式
+
+审批节点的多人审批方式可通过getTaskInfo逻辑获取，返回结果中的approvalPolicy字段代表了该节点的多人审批方式，有三种取值：
+
+- simple（或签）
+- parallel（会签）
+- sequence（多人审批） 
+
+![0](../assets/liuchengshiyongchangjianwenti_202505280207_1.png)
+
+## 流程中的异常处理
+
+在使用流程时可能会出现异常或者某些异常被系统自动忽略了，开发者需要了解以下两点：
+
+- **自动任务、流程事件中触发的异常**：系统会默认忽略该异常，流程继续向下流转，可通过修改依赖库配置的方式让流程在出现该异常时能够回滚。详细介绍请参考下文[流程中的事务控制](../20.流程2.0/90.流程使用常见问题.md)
+
+- **流程逻辑异常**：点击流程逻辑上的“高级设置”，可自定义该逻辑发生异常时的行为。
+
+    - 异常处理信息：可编辑自定义的文本，在该逻辑出现异常时会默认记录该文本作为日志。
+
+        <img src="../assets/liuchengyilaikushuoming_202506271817_1.png" style="width:500px;" />
+
+    - 手动处理Error：如果希望在出现异常时执行另一套操作，可以开启“手动处理异常”，开启后可使用匹配组件判断逻辑调用结果的类型，在不同分支下添加对应的处理逻辑。
+
+        <img src="../assets/liuchengyilaikushuoming_202506271817_2.png" style="width:500px;" />
+
+    关于异常处理功能的详细介绍可参考文档：[异常处理](../../15.逻辑功能实现/45.逻辑编辑/85.异常处理.md)
+
+
+## 流程中的事务控制
+
+默认情况下，当流程的**自动任务**或**流程事件**的逻辑中出现异常时，系统会在内部处理掉该异常，从而避免影响流程的流转，但由此可能导致流程数据与其他数据不一致的情况。
+
+以下图为例，在第一个审批节点同意后，流转向下流转到自动任务，但自动任务的逻辑中出现了异常，在默认情况下流程会继续向下执行，进入到第二个审批节点。
+
+<img src="../assets/liuchengyilaikushuoming_202506231544_1.png" style="width:500px;" />
+
+但在实际项目中这种忽略异常的情况可能会带来错误，例如自动任务中可能是进行了数据操作，将实体数据和流程数据进行同步，如果实体操作失败但流程却向下执行了，那么就会导致两份数据不一致。
+
+如果需要避免出现这种数据不一致的情况，该应该启用流程的事务机制，让流程在自动任务节点出现异常时能够回滚到第一个审批节点，使得第一个审批节点的操作撤销，如下图所示。
+
+<img src="../assets/liuchengyilaikushuoming_202506231544_2.png" style="width:500px;" />
+
+从4.0版本开始，流程依赖库中提供了一个参数配置项，用于控制流程是否忽略自动任务和流程事件中的异常。为了与旧版本兼容，默认情况下，流程依赖库的参数配置项为true，表示会忽略异常，修改为false后将不忽略自动任务和流程事件中的异常，触发异常时会回滚流程。
+
+<img src="../assets/liuchengyilaikushuoming_202506191825_1.png" style="width:700px;" />
+
+<img src="../assets/liuchengyilaikushuoming_202506191825_2.png" style="width:500px;" />
+
+<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年06月27日</span>
+</div>

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/95./346/265/201/347/250/2131.0/345/272/224/347/224/250/350/277/201/347/247/2732.0.md

@@ -0,0 +1,111 @@
+# 流程1.0应用迁移2.0
+
+流程1.0无法自动转换为流程2.0，当需要将应用中现有流程改造为流程2.0实现时，需要手动将1.0版本流程业务迁移到2.0版本以实现相应能力。
+
+以流程1.0的请假申请流程为例，在1.0流程实现的流程图如下图所示，该流程案例文档可参考：[搭建请假审批流程](../10.流程1.0/20.搭建请假审批流程.md)。在使用流程2.0重构该流程1.0应用时，可参考下文注意事项。
+
+<img src="../assets/liucheng10yingyongqianyi20_0422_1.png" style="border: 1px solid #ccc;" />
+
+## 操作步骤及注意事项
+
+### 1. 启用流程2.0
+
+确认应用IDE版本为3.7及以上版本，在“系统偏好设置”中开启流程2.0。建议在开启流程2.0前进行应用备份。
+
+开启流程2.0后，将出现若干报错，是由于原1.0流程逻辑无法使用导致的，对于出错的逻辑及其页面，可在流程设计好后再进行修改或删除重做。
+
+<img src="../assets/liucheng10yingyongqianyi20_0422_2.png" style="max-width: 70%;border: 1px solid #ccc;" />
+
+### 2. 新建流程
+
+添加流程并关联实体。流程1.0中与流程相关的实体在2.0中可以直接复用，通常无需进行特别的修改。
+
+<img src="../assets/liucheng10yingyongqianyi20_0422_3.png" style="max-width: 70%;border: 1px solid #ccc;" />
+
+### 3. 流程设计
+
+<br>
+<img src="../assets/liucheng10yingyongqianyi20_0422_4.png" style="max-width: 70%;border: 1px solid #ccc;" />
+
+拖拽流程节点进行流程设计，流程1.0与流程2.0的在流程设计上需要注意以下差异。
+
+- **发起任务节点**：流程1.0版本中的【发起任务】在流程2.0中由【开始】节点替代，开始节点不可移除。
+- **审批节点**：流程1.0版本中的用户任务、审批任务、多人审批三种审批节点，在流程2.0中统一被【审批任务】替代。属性中提供的“多人审批方式”可以完全覆盖1.0版本中的各审批节点功能。
+
+  <img src="../assets/liucheng10yingyongqianyi20_0422_5.png" style="border: 1px solid #ccc;" />
+
+- **排他网关**：在流程1.0中，排他网关用于实现需要做出多选一的场景，在网关中配置条件来决定流程的流向。
+
+  <img src="../assets/liucheng10yingyongqianyi20_0422_6.png" style="max-width: 70%;border: 1px solid #ccc;" />
+
+
+  在流程2.0中可使用【唯一分支】实现1.0的排他网关功能，不同之处在于，唯一分支是在分支连接线上配置分支条件。
+
+  <img src="../assets/liucheng10yingyongqianyi20_0422_8.png" style="max-width: 70%;border: 1px solid #ccc;" />
+
+  <img src="../assets/liucheng10yingyongqianyi20_0422_9.png" style="max-width: 70%;border: 1px solid #ccc;" />
+
+- **并行网关与包容网关**：流程2.0中使用【并行分支】替代1.0中的并行网关与包容网关。并行分支本身不可编辑，与唯一分支一样，需要在连接线上配置分支条件，不配置条件时则与1.0的并行网关一样会执行所有分支。
+
+### 4. 发起流程
+
+流程2.0支持一键生成申请页面，快捷添加发起流程页。
+
+<img src="../assets/liucheng10yingyongqianyi20_0422_10.png" style="max-width: 70%;border: 1px solid #ccc;" />
+
+<img src="../assets/liucheng10yingyongqianyi20_0422_11.png" style="max-width: 70%;border: 1px solid #ccc;" />
+
+流程1.0和2.0在发起流程时都可以将数据带入到流程中，不同之处：
+
+- **流程1.0**：可为流程添加输入参数，在调用launch逻辑发起流程时可将数据作为参数带入到流程中，带入到流程中的数据为只读不可修改。
+- **流程2.0**：流程与实体相关联，发起流程时可选择将实体数据带入到流程中，流程审批过程中可以修改该数据。
+
+### 5. 流程页面组件
+
+<br>
+<img src="../assets/liucheng10yingyongqianyi20_0422_12.png" style="max-width: 70%;" />
+
+流程2.0提供比1.0更丰富的页面组件，使用流程2.0页面组件需要注意以下事项：
+
+- 流程1.0与流程2.0中的任务箱组件和我的流程组件有所区分，使用到这两个组件时，注意需要在开启流程2.0后替换掉原组件。
+- 在应用运行态下，除任务箱和我的流程组件以外，其他流程组件仅当页面存在有效的taskId（任务实例ID）参数时可用，没有taskId时组件无法获取流程/任务的信息。
+
+### 6. 业务数据的更新
+
+业务数据即存储在数据库中的数据，在流程流转过程中通常需要更新业务数据，例如请假申请流程中，审批通过后需要将实体的请假状态字段更新为【已通过】，流程1.0与2.0的实现方式有以下差异：
+
+- **流程1.0**：通常是在页面、自动任务、流程事件中直接进行数据库的更新，例如在页面审批了任务后，直接将实体请假状态更新为【已通过】。
+
+- **流程2.0**：通常在发起流程时将数据带入到流程中，审批流程的过程中更新流程数据，可按需使用自动任务或任务事件将流程数据更新到数据库中。
+
+### 7. 流程逻辑
+
+流程1.0中提供流程逻辑用于查询或操作流程，在流程2.0提供了全新的流程逻辑用于发起、处理、查询等操作。原流程1.0中的流程逻辑将不可用，需要用新的流程逻辑重新实现原有业务功能。
+
+当流程组件的能力无法满足业务需求时，也可使用流程逻辑来实现。
+
+例如以下场景：
+
+- 流程按钮组件无法满足需求，需要自定义处理流程的方式，可使用流程逻辑进行转派、同意、拒绝、终止等操作。
+- 我的流程组件无法满足需求，需要手动实现流程的查询，可使用流程逻辑查询流程信息、发起人列表、我的发起、我的已办、我的待办等信息。
+- 流程表单组件无法满足需求，需要手动实现与流程相关的表单，可使用流程逻辑查询流程数据字段权限、任务操作权限等。
+
+流程2.0逻辑的详细使用方式请参考：[流程逻辑使用说明](../20.流程2.0/70.流程逻辑使用说明.md)
+
+<img src="../assets/liucheng10yingyongqianyi20_0522_1.png" style="width: 450px;" />
+
+<img src="../assets/liucheng10yingyongqianyi20_0522_2.png" style="width: 450px;" />
+
+### 8. 发布应用
+
+对已有的流程定义进行修改并发布应用，在流程1.0和2.0中有以下差异：
+
+- **流程1.0**：对已上线的流程定义进行修改并发布可能会导致运行中的流程实例数据异常，在修改已有的流程定义时需谨慎操作。
+- **流程2.0**：新增[流程版本管理](../20.流程2.0/80.流程版本管理说明.md)能力，运行的流程标记了版本，通过增加版本的方式迭代发布，从而实现流程的变更不影响历史流程实例数据。
+
+<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);">2024年07月09日</span>
+</div>

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/97./346/265/201/347/250/2132.0/350/241/250/345/215/225/346/225/260/346/215/256/346/235/203/351/231/220/346/216/247/345/210/266.md

@@ -0,0 +1,179 @@
+# 流程2.0表单数据权限控制说明
+
+设计流程时，通常需要对流程数据和审批操作进行权限控制，例如以下场景：
+
+- 根据配置好的权限决定可以执行的审批操作，例如，将某审批节点可以执行的审批操作设置为仅允许同意或拒绝，不允许其他审批操作。
+- 根据配置好的权限决定数据可见范围，例如，在普通职员审批节点，流程表单中的数据只允许预览，而在主管审批节点，流程表单中的数据允许被修改。
+
+当需要实现以上场景时，可根据具体业务需求选择以下方式之一：
+
+- 方式一：使用流程基础能力，配置审批节点的审批权限和数据权限，并在审批页中使用流程组件，实现起来比较快捷简单，但存在一定的局限性。
+- 方式二：手动实现审批页表单数据和审批操作的权限控制，在审批页中调用逻辑查询权限来配置表单和操作按钮，适合需要更精细控制权限的场景。
+
+## 方案一：使用流程基础能力
+
+流程2.0提供审批所需的页面组件：流程按钮组件、流程表单组件。
+
+- 流程按钮组件：根据页面入参taskId（任务实例id）自动获取当前任务能做的审批操作。
+
+  1. 在设计流程时，在审批任务的属性中配置流程权限，如图所示，主管审批节点仅开启了同意和拒绝的权限，关闭了转派和加签。
+
+      <img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_1.png" class="imgStyle" style="" />
+
+  2. 在审批页中使用流程按钮组件，进行审批时实际展示的按钮由上文审批节点的配置所决定。
+
+      <img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_2.png" class="imgStyle" style="" />
+
+- 流程表单组件：根据页面入参taskId（任务实例id）自动获取当前审批节点的数据权限，并根据权限动态渲染表单内容。
+
+  1. 在设计流程时，选中审批节点后在属性中配置数据权限，如图所示，修改开始节点的数据权限，隐藏了部分系统属性，创建时间和申请人属性为仅支持预览，请假申请相关的属性为可编辑，当流程被驳回到开始节点时，流程发起人可以重新编辑请假信息再提交。
+
+      <img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_3.png" class="imgStyle" style="" />
+
+  2. 在审批页中使用流程表单组件，表单数据的可见范围会自动计算。如图所示，上文配置为“隐藏”的属性在表单中已经不可见，配置为“预览”的属性为只读状态，配置为“编辑”的属性可以修改。
+
+      <img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_4.png" class="imgStyle" style="" />
+
+使用该方案存在一些不足之处，暂不支持以下场景：
+
+- 审批页中有多个流程表单的情况。
+- 需要精细化控制数据权限和审批权限的情况，例如：
+
+    - 流程按钮组件无法满足需求，希望自行设计操作流程的按钮，根据流程节点配置的审批权限来控制按钮的显隐。
+    - 流程表单组件无法满足需求，希望自行设计展示流程数据的界面，手动实现流程数据的可见性（预览/编辑/隐藏）。
+
+## 方案二：手动实现权限控制
+
+以采购流程为案例，采购申请单中需要填写采购明细，使用了两个实体：purchase（采购单）、purchaseDetail（采购明细），采购单与采购明细为一对多关系。
+
+### 表单数据的加载
+
+在审批页面中需要加载流程数据，即采购单与采购明细的数据，可在进入页面时使用流程逻辑查询出流程数据，作为页面展示的数据。
+
+> 流程逻辑中的getTaskData逻辑根据传入的任务实例id查询带入到流程中的实体数据，当实体数据存在一对多关系时，查询结果中也将包含关联的子实体数据。详细使用说明请参考：[流程逻辑 - 获取流程表单数据](../20.流程2.0/70.流程逻辑使用说明.md)
+
+<img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_5.png" class="imgStyle" style="width: 600px;" />
+
+表单项绑定查询到的流程数据，由于采购实体与采购明细实体为一对多关系，在展示采购明细时可使用表格类组件。
+
+<img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_6.png" class="imgStyle" style="width: 600px;" />
+
+### 审批按钮的实现
+
+手动实现审批按钮，需要调用流程逻辑查询当前任务的审批操作权限。本案例在进入页面时调用getTaskOperationPermissions逻辑查询审批操作权限。
+
+> 流程逻辑的getTaskOperationPermissions逻辑根据传入的任务实例id查询出该审批节点的操作权限，详细使用说明请参考：[流程逻辑 - 获取任务操作权限](../20.流程2.0/70.流程逻辑使用说明.md)
+
+<img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_7.png" class="imgStyle" style="width: 800px;" />
+
+本案例使用组件列表展示按钮，组件列表的数据源使用上图逻辑获取到的数据。
+
+<img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_8.png" class="imgStyle" style="" />
+
+配置按钮的显示条件，显示条件为`TaskOperationPermission`的`operationEnabled`字段，代表当权限被开启时才展示权限对应的按钮。
+
+配置按钮显示的文本，文本内容为`TaskOperationPermission`的`displayText`字段，代表在任务节点属性中配置的操作名称。
+
+<img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_9.png" class="imgStyle" style="" />
+
+注：显示条件对应属性的配置方式如下图所示。
+
+<img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_10.png" class="imgStyle" style="width: 350px;" />
+
+显示文本对应属性的配置方式如下图所示。
+
+<img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_11.png" class="imgStyle" style="width: 350px;" />
+
+为按钮配置点击事件，当点击了不同操作按钮后，调用不同的流程逻辑执行审批操作，如下图所示。
+
+> TaskOperationPermission的name字段表示为哪种审批操作，例如approve代表同意、reject代表拒绝，详细说明请参考：[流程逻辑使用说明 - 附录 - 流程操作](../20.流程2.0/70.流程逻辑使用说明.md)
+
+<img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_12.png" class="imgStyle" style="" />
+
+### 表单数据的权限控制
+
+手动制作表单展示流程数据，需要根据权限来决定组件的显示状态（是否隐藏、只读、可编辑）。
+
+该权限的配置可以使用两种方式实现：
+
+- 方式一：使用流程2.0审批节点中定义的数据权限，在页面中通过流程逻辑查询，根据查询结果配置相关组件的显示、编辑、预览。
+- 方式二：自行设计权限表，维护字段属性及相关权限数据，查询权限表来配置表单中组件的显示状态。
+
+#### 方式一：使用流程定义中的数据权限配置能力
+
+如上文的采购流程案例，需要在审批节点中配置好数据权限。
+
+<img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_13.png" class="imgStyle" style="" />
+
+在审批页面的页面加载时事件中调用getDataPropertyPermissions逻辑，查询流程数据权限，将结果组装为Map数据结构。
+
+> 该Map的key为实体的属性名，value为该属性的数据权限。value有三种取值：readonly代表只读预览，hidden代表隐藏，editable代表可编辑。详细使用说明请参考：[流程逻辑使用说明 - 获取流程数据权限](../20.流程2.0/70.流程逻辑使用说明.md)
+
+<img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_14.png" class="imgStyle" style="" />
+
+在审批页面配置表单中组件的显示条件。
+
+<img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_15.png" class="imgStyle" style="max-width: 900px;" />
+
+<img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_16.png" class="imgStyle" style="max-width: 900px;" />
+
+配置表单中组件是否为仅预览。
+
+<img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_17.png" class="imgStyle" style="max-width: 900px;" />
+
+<img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_18.png" class="imgStyle" style="max-width: 900px;" />
+
+注意：在本案例中，由于采购实体没有属性用于标志采购明细，无法在流程节点中设置采购明细的数据权限，可以为采购实体增加一个明细属性，间接实现采购明细显示状态的控制。
+
+<img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_19.png" class="imgStyle" style="width: 400px;" />
+
+在审批节点的属性中配置数据权限，并在审批页面中为明细对应的表单项配置显示条件和是否预览。
+
+<img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_20.png" class="imgStyle" style="width: 400px;" />
+
+这种方案可实现对明细这一项表单内容的整体控制，但是无法实现对明细列表中每一项属性的控制，如果需要实现采购明细中每一项属性的权限控制，请参考下文[流程子表单的权限控制](#流程子表单的权限控制)
+
+#### 方式二：自定义权限表维护流程数据权限
+
+通过自行建立权限表，可实现更细粒度的权限控制。例如，在采购审批页面中，需要控制采购明细的列属性是否显示、是否可编辑等状态。
+
+示例：创建中间表实体：
+
+<img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_21.png" class="imgStyle" style="" />
+
+审批页中页面加载时查询中间表信息，并组装成Map数据返回
+
+<img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_22.png" class="imgStyle" style="" />
+<br>
+<img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_23.png" class="imgStyle" style="" />
+
+采购明细中可根据权限数据设置显示、编辑等能力
+
+<img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_24.png" class="imgStyle" style="" />
+
+<img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_25.png" class="imgStyle" style="" />
+
+最后维护一条数据到中间表中即可：
+
+<img src="../assets/liucheng20biaodanshujuquanxiankongzhishuoming_202407011714_26.png" class="imgStyle" style="" />
+
+## 补充说明
+
+### 流程子表单的权限控制
+
+如果流程关联的实体与其他实体存在一对多关系，则配置数据权限时也可以配置其他实体的字段权限。
+
+以下图为例，采购审批流程绑定了采购订单实体，商品实体的订单属性关联了订单实体的id，即一个采购订单对应多个商品信息，那么在流程节点的数据权限中也可以配置商品实体的字段权限。
+
+<img src="../assets/liuchengjiedianpeizhishuoming_202408261102_1.png" alt="0" style="max-width:900px;" />
+<br>
+<img src="../assets/liuchengjiedianpeizhishuoming_202408261102_2.png" alt="0" style="width:300px;" />
+
+在审批页中可以使用数据表格展示这种子实体数据，并调用流程逻辑查询子表单的数据权限，根据查询结果来设置子表单的可见性，控制子表单中的表单项是否为预览/编辑/隐藏，该逻辑的使用说明请参考：[流程逻辑-getFormDataPropertyPermissions（获取流程子表单数据字段权限）](../20.流程2.0/70.流程逻辑使用说明.md)。
+
+<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);">2024年09月10日</span>
+</div>