codewave-openclaw-installer 1.0.0

package/skills/smart-customer-service/docs/codewave/10./346/226/260/346/211/213/345/205/245/351/227/250/080./345/210/233/345/273/272/347/254/254/344/270/200/344/270/252/345/256/236/344/275/223.md

@@ -0,0 +1,106 @@
+# 创建第一个实体
+
+## 1. 场景介绍
+
+实体是在CodeWave应用中实现数据存储的核心概念，定义实体之后可以在应用中使用该实体类型，进行数据的创建、删除、修改、查询等操作。本文将以工单管理系统为例，演示创建工单实体的步骤，指引用户为应用创建第一个实体，在后续文章中将会基于该实体进行进一步开发。关于实体的更多介绍可参考文档：[数据建模 - 实体](../20.应用开发/05.数据建模/20.实体/010.实体介绍.md)
+
+## 2. 前提条件
+
+创建一个CodeWave应用，并进入到该应用的IDE中。
+
+<img src="../assets/_202412301358_1.png" class="imgStyle" style="" />
+
+所需创建的工单实体中将包含以下字段：
+
+- 工单名称：用于标识工单的名称，通常是唯一的，便于识别和查找。
+- 优先级：表示工单的紧急程度，可以设置为枚举类型，例如“P0”、“P1”、“P2”。
+- 状态：表示工单的当前处理阶段，也可以设置为枚举类型，例如“待处理”、“处理中”、“已完成”。
+- 负责人：指派给工单的处理人姓名。
+- 工作量：估计完成工单所需的工作小时数，有助于资源规划和进度跟踪。
+- 描述：对工单的详细说明，包括问题描述、需求细节等。
+
+## 3. 操作步骤
+
+### 3.1 创建枚举
+
+工单实体的“优先级”字段和“状态”字段使用到了枚举类型，需要先创建对应的枚举。关于枚举的更多介绍请参考：[数据建模 - 枚举](../20.应用开发/05.数据建模/30.枚举.md)。
+
+1.  点击IDE左侧的“数据”切换到数据IDE中，点击枚举目录上的加号。创建一个枚举并命名为PriorityEnum，设置为Integer类型。
+
+    <img src="../assets/_202412301358_2.png" class="imgStyle" style="" />
+
+1.  双击目录树中创建好的枚举，点击如图所示加号按钮，添加枚举值和枚举标题，枚举值和标题可见下表。
+
+    | 枚举值 | 标题 |
+    | :-- | :- |
+    | 0   | P0 |
+    | 1   | P1 |
+    | 2   | P2 |
+
+    <img src="../assets/_202412301358_3.png" class="imgStyle" style="" />
+
+1.  创建完“工单优先级”枚举后，再创建“工单状态”枚举，将其命名为WorkOrderStatus，需要添加三个枚举项代表不同的状态。
+
+    | 枚举值        | 标题  |
+    | :--------- | :-- |
+    | Pending    | 待处理 |
+    | Processing | 处理中 |
+    | Completed  | 已完成 |
+
+    <img src="../assets/_202412301358_4.png" class="imgStyle" style="" />
+
+### 3.2 创建实体
+
+1.  如图所示，点击目录树上方的加号添加实体，将实体的名称命名为“WorkOrder”。
+
+    <img src="../assets/_202412301358_5.png" class="imgStyle" style="" />
+
+1.  打开创建好的实体，点击如图所示加号按钮为实体添加属性，需要添加六个属性，属性的名称、标题、数据类型按参考一下配置。
+
+    | 属性名称        | 属性标题 | 数据类型                |
+    | :---------- | :--- | :------------------ |
+    | title       | 工单名称 | String文本            |
+    | priority    | 优先级  | 枚举类型PriorityEnum    |
+    | status      | 状态   | 枚举类型WorkOrderStatus |
+    | handler     | 负责人  | String文本            |
+    | workload    | 工作量  | Decimal小数           |
+    | description | 描述   | String文本            |
+
+    <img src="../assets/_202412301358_6.png" class="imgStyle" style="" />
+
+1.  优先级和状态的数据类型需要选择对应的枚举。
+
+    <img src="../assets/_202412301358_7.png" class="imgStyle" style="" />
+
+1.  属性类型为String时，默认的最大长度限制为255，由于“描述”信息可能会比较长，可以选中描述属性后在下方修改最大长度为4000。
+
+    <img src="../assets/_202412301358_8.png" class="imgStyle" style="" />
+
+### 3.3 一键生成增删改查
+
+1.  设计完实体后，可以选中实体拖拽到页面并选择“列表（全）”，即可快速生成增删改查功能。可参考下一章实现第一个业务功能了解具体实现的细节。
+
+    <img src="../assets/_202412301358_9.gif" class="imgStyle" style="" />
+
+1.  实体中的勾选项决定了页面上可展示、可查询、可添加/修改的属性。
+
+    <img src="../assets/_202412301358_10.png" class="imgStyle" style="" />
+
+1.  勾选了“显示在表格”后，自动生成的数据表格中将展示该属性。
+
+    <img src="../assets/_202412301358_11.png" class="imgStyle" style="" />
+
+1.  勾选了“显示在筛选后”后，自动生成的筛选条件表单中将会有该属性。
+
+    <img src="../assets/_202412301358_12.png" class="imgStyle" style="" />
+
+1.  勾选了“显示在表单”后，自动生成的创建数据或修改数据弹窗中将会有该属性。
+
+    <img src="../assets/_202412301358_13.png" class="imgStyle" style="" />
+
+<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年12月30日</span>
+</div>

package/skills/smart-customer-service/docs/codewave/10./346/226/260/346/211/213/345/205/245/351/227/250/090./345/256/236/347/216/260/347/254/254/344/270/200/344/270/252/344/270/232/345/212/241/345/212/237/350/203/275.md

@@ -0,0 +1,325 @@
+# 实现第一个业务功能
+
+## 1. 场景介绍
+
+借助对组件属性的编辑、组件事件的添加以及逻辑的调用，可完成应用中的业务功能。以工单管理场景为例，支持实现的业务功能包含添加工单、删除工单、修改工单信息以及查询工单。
+
+其次，在实际的业务场景中，进行数据删除操作时通常需要在删除前提供二次确认，避免用户误操作导致数据丢失。因此本文将基于拖拽工单实体生成的业务功能，实现删除工单前进行二次确认。
+
+<img src="../assets/shixiandiyigeyewugongneng_202412301404_1.png" class="imgStyle" style="" />
+
+## 2. 前提条件
+
+本文基于实体来实现业务逻辑，并且通过拖拽实体直接生成基础业务功能。关于实体的创建以及拖拽的学习请参考[创建第一个实体](../10.新手入门/080.创建第一个实体.md)。
+
+- 本文为实现业务功能准备的实体WorkOrder如下：
+
+    <img src="../assets/shixiandiyigeyewugongneng_202412301404_2.png" class="imgStyle" style="" />
+
+- 准备一个页面。例如创建空白页面并命名为firstFunction。
+
+    <img src="../assets/shixiandiyigeyewugongneng_202412301404_3.png" class="imgStyle" style="" />
+
+## 3. 操作步骤
+
+### 3.1 拖拽生成数据表格
+
+向页面中拖拽实体，选择列表（全）。
+
+<img src="../assets/shixiandiyigeyewugongneng_202412301404_4.gif" class="imgStyle" style="" />
+
+拖拽实体后自动生成该实体相关的业务功能，包括[查询数据](#查询数据)、[创建数据](#创建数据)、[修改数据](#修改数据)和[删除数据](#删除数据)。
+
+各功能预览效果如下所示：
+
+#### 查询数据
+
+<img src="../assets/shixiandiyigeyewugongneng_202412301404_5.gif" class="imgStyle" style="" />
+
+1.  在数据表格中展示已有的工单数据，进入页面后即展示全量数据；图示数据仅作效果参考。
+2.  在上方表单中输入筛选条件，点击查询按钮后在数据表格中展示筛选后的数据。
+
+<details>
+    <summary title="什么是NASL">
+     点击展开：详细功能介绍
+    </summary>
+
+**由于工单数据存储在实体中，因此在数据表格中展示数据时需要先从服务端查询出实体数据，再将查询结果作为数据表格的“数据源”。**
+
+1.  在逻辑IDE中默认生成一个服务端逻辑，服务端逻辑名称默认根据页面名称生成，此处被命名为loadFirstFunctionTableView\_1。
+   
+    <img src="../assets/shixiandiyigeyewugongneng_202412301404_6.png" class="imgStyle" style="width:350px;" />
+
+2.  查询逻辑如下：
+
+    <img src="../assets/shixiandiyigeyewugongneng_202412301404_7.png" class="imgStyle" style="width:90%;" />
+
+    - 调用[数据查询](../20.应用开发/15.逻辑功能实现/40.逻辑组件使用/37.数据查询/30.数据查询.md)组件查询实体。双击数据查询组件可进入编辑页面，编辑内容包含查询数据源、筛选条件和排序规则。
+
+    - 查询数据源即实体WorkOrder；
+
+        <img src="../assets/shixiandiyigeyewugongneng_202412301404_8.png" class="imgStyle" style="width:90%;" />
+
+    - 筛选条件来自于页面中的表单，因此在服务端逻辑中创建实体类型输入参数filter来传递页面中的筛选条件，并使用数据筛选类别的组件将其与实体属性进行匹配；
+
+        <img src="../assets/shixiandiyigeyewugongneng_202412301404_9.png" class="imgStyle" style="width:350px;" />
+
+        <img src="../assets/shixiandiyigeyewugongneng_202412301404_10.png" class="imgStyle" style="width:90%;" />
+
+    - 排序规则来自于数据表格的属性，因此在服务端逻辑中创建输入参数sort、order来传递数据表格中的排序属性，并将输入参数填入排序规则。
+
+        <img src="../assets/shixiandiyigeyewugongneng_202412301404_11.png" class="imgStyle" style="width:90%;" />
+
+    - 使用分页组件对数据查询进行分页，分页参数来自于数据表格的属性，因此在服务端逻辑中创建输入参数page、size来传递数据表格的页码和分页大小属性，并将输入参数填入分页组件。
+    - 最后，将结果赋值给输出参数result，用于调用此服务端逻辑时输出查询的实体数据。
+
+3.  在数据表格的"数据源"中，使用“调用逻辑”组件调用此服务端逻辑，以获取实体数据。输入参数中用于排序和分页的属性来源于数据表格的可访问属性；用于筛选的filter属性介绍可查看下文。
+
+    <img src="../assets/shixiandiyigeyewugongneng_202412301404_12.png" class="imgStyle" style="width:90%;" />
+
+**由于筛选条件来源于查询表单，因此需要将查询表单中的信息通过数据表格的“数据源”传递到服务端逻辑中。**
+
+1.  为查询表单中的输入组件绑定变量，即可实现将输入值存储到变量中。在页面中创建实体类型的局部变量filter并将各个输入组件的值绑定为filter变量中的属性，例如将标题对应的单行输入组件绑定filter.title属性。
+
+    <img src="../assets/shixiandiyigeyewugongneng_202412301404_13.png" class="imgStyle" style="width:90%;" />
+
+2.  进入数据表格“数据源”属性的编辑表达式界面，将服务端逻辑的输入参数filter设为局部变量filter，即可将查询表单中的筛选条件传递到服务端逻辑中。
+
+    <img src="../assets/shixiandiyigeyewugongneng_202412301404_14.png" class="imgStyle" style="width:550px;" />
+
+3.  在表单中输入筛选条件后，需要重新加载表格来获取筛选后的数据。因此为“查询”按钮添加点击事件，并在事件逻辑中使用“调用逻辑”组件调用数据表格的reload。
+
+    <img src="../assets/shixiandiyigeyewugongneng_202412301404_15.png" class="imgStyle" style="width:90%;" />
+
+4.  此外，为了保证每次进入页面时获取到完整的表格数据，而非筛选后的数据，为页面添加进入时事件，在事件中使用“内置函数”组件调用Clear清空局部变量filter，即清空筛选表单。
+
+    <img src="../assets/shixiandiyigeyewugongneng_202412301404_16.png" class="imgStyle" style="width:90%;" />
+
+**完成数据获取后，即可通过其他组件或表格列的“值字段”在表格列中展示数据。例如在表格列中通过文本组件绑定current.item下的属性，即可在此列中通过文本依次展示属性值。**
+
+<img src="../assets/shixiandiyigeyewugongneng_202412301404_17.png" class="imgStyle" style="width:90%;" />
+
+至此，查询数据业务功能已完成。
+
+</details>
+
+
+
+#### 创建数据
+
+<img src="../assets/shixiandiyigeyewugongneng_202412301404_18.gif" class="imgStyle" style="" />
+
+1.  点击工单管理页面中的“创建”按钮 ，弹出弹窗；
+2.  在弹出窗口中的表单填写工单信息；
+3.  点击弹出窗口中的“立即创建”按钮，将表单中填写的工单信息创建为实体实例。
+
+
+<details>
+    <summary title="什么是NASL">      
+    点击展开：详细功能介绍
+    </summary>
+
+1.  为工单管理页面中的“创建”按钮添加点击事件，在事件中完成的逻辑如下：
+
+    <img src="../assets/shixiandiyigeyewugongneng_202412301404_19.png" class="imgStyle" style="width:90%;" />
+
+    - 由于创建和修改数据在同一个弹窗中实现，因此此处命名了一个Boolean类型局部变量isUpdate并使用“赋值”组件赋值为false，表示打开弹窗作为创建数据使用；
+
+        <img src="../assets/shixiandiyigeyewugongneng_202412301404_20.png" class="imgStyle" style="width:550px;" />
+
+    - 由于创建实体时要求填写的表单为空，因此此处命名了两个实体类型的局部变量input和workOrder，将空变量workOrder通过使用“内置函数”组件中的Clone克隆后赋值给input，表示在创建数据之前先清空变量input。
+
+        <img src="../assets/shixiandiyigeyewugongneng_202412301404_21.png" class="imgStyle" style="width:550px;" />
+
+    - 完成数据准备后，即可使用“调用逻辑”组件调用弹窗的组件逻辑open，用于打开弹窗。
+
+        <img src="../assets/shixiandiyigeyewugongneng_202412301404_22.png" class="imgStyle" style="width:550px;" />
+
+2.  为弹窗中的输入组件绑定变量，即可实现将输入值存储到变量中。此处将各个输入组件的值绑定为input变量中的属性，例如将标题对应的单行输入组件绑定input.title属性。
+
+    <img src="../assets/shixiandiyigeyewugongneng_202412301404_23.png" class="imgStyle" style="width:90%;" />
+
+3.  通过Boolean类型局部变量isUpdate标识组件是否显示。例如“立即创建”按钮的显示条件为"not(isUpdate)"，表示在创建时显示该按钮。
+
+    <img src="../assets/shixiandiyigeyewugongneng_202412301404_24.png" class="imgStyle" style="width:90%;" />
+
+4.  为弹窗中的“立即创建”按钮添加点击事件，在事件中完成的逻辑如下：
+
+    <img src="../assets/shixiandiyigeyewugongneng_202412301404_25.png" class="imgStyle" style="width:90%;" />
+
+    - 由于表单项可能定义了验证规则，因此需要在表单校验通过后允许继续创建。此处使用“调用逻辑”组件调用了表单的组件逻辑validate，当组件逻辑返回结果中的valid值为true时即表示校验通过；
+
+        验证规则可能是通过表单项的“验证规则”属性手动添加的，也可能是在实体中勾选“必填”后应用自动生成的。
+
+        <img src="../assets/shixiandiyigeyewugongneng_202412301404_26.png" class="imgStyle" style="width:550px;" />
+
+    - 使用“调用逻辑”组件调用实体的实体逻辑create，用于创建实体实例，逻辑的输入参数body即传递数据的实体类型局部变量input；
+
+        <img src="../assets/shixiandiyigeyewugongneng_202412301404_27.png" class="imgStyle" style="width:550px;" />
+
+    - 创建完成后，使用“调用逻辑”组件调用弹窗的组件逻辑close，用于关闭弹窗；
+
+        <img src="../assets/shixiandiyigeyewugongneng_202412301404_28.png" class="imgStyle" style="width:550px;" />
+
+    - 最后，使用“调用逻辑”组件调用数据表格的组件逻辑reload，用于重新加载数据表格，即重新调用查询数据的服务端逻辑。
+
+        <img src="../assets/shixiandiyigeyewugongneng_202412301404_29.png" class="imgStyle" style="width:550px;" />
+
+至此，创建数据业务功能已完成。
+
+</details>
+
+
+#### 修改数据
+
+<img src="../assets/shixiandiyigeyewugongneng_202412301404_30.gif" class="imgStyle" style="" />
+
+1.  点击表格行中的“修改”链接 ，弹出弹窗；
+2.  在弹出窗口中的表单展示需要修改的工单信息；
+3.  点击弹出窗口中的“立即修改”按钮，将表单中重新填写后的工单信息更新到对应的实体实例。
+   
+<details>
+    <summary title="什么是NASL">
+     点击展开：详细功能介绍
+    </summary>
+
+1.  为工单管理页面中的“修改”链接添加点击事件，在事件中完成的逻辑如下：
+
+    <img src="../assets/shixiandiyigeyewugongneng_202412301404_31.png" class="imgStyle" style="width:90%;" />
+
+    - 与创建数据时打开弹窗的思路类似，此时Boolean类型局部变量isUpdate应使用“赋值”组件赋值为true，表示打开弹窗作为修改数据使用；
+
+        <img src="../assets/shixiandiyigeyewugongneng_202412301404_32.png" class="imgStyle" style="width:550px;" />
+
+    - 与创建数据时打开弹窗的思路类似，此时局部变量input需要使用“赋值”组件赋值为表格行的实体数据，用于在表单中回显需要修改的工单数据。表格行的实体数据即current.item下的实体。
+
+        <img src="../assets/shixiandiyigeyewugongneng_202412301404_33.png" class="imgStyle" style="width:90%;" />
+
+2.  输入组件绑定变量、组件显隐设计思路与创建数据时类似。
+3.  为弹窗中的“提交修改”按钮添加点击事件，在事件中完成的逻辑如下：
+
+    <img src="../assets/shixiandiyigeyewugongneng_202412301404_34.png" class="imgStyle" style="width:90%;" />
+
+    - 与创建数据时提交创建的思路类似，此时需要使用“调用逻辑”组件调用实体的实体逻辑update，用于更新实体实例，逻辑的输入参数body即传递数据的实体类型局部变量input；
+
+        <img src="../assets/shixiandiyigeyewugongneng_202412301404_35.png" class="imgStyle" style="width:550px;" />
+
+至此，修改数据业务功能已完成。
+
+</details>
+
+
+#### 删除数据
+
+<img src="../assets/shixiandiyigeyewugongneng_202412301404_36.gif" class="imgStyle" style="" />
+
+点击删除按钮后删除对应的实体实例。
+
+<details>
+    <summary title="什么是NASL">
+    点击展开：详细功能介绍
+    </summary>
+
+为“删除”链接添加点击事件，在事件中完成的逻辑如下：
+
+<img src="../assets/shixiandiyigeyewugongneng_202412301404_37.png" class="imgStyle" style="width:90%;" />
+
+- 使用“调用逻辑”组件调用实体的实体逻辑delete，用于删除实体实例，逻辑的输入参数id即表格行实体数据的主键（id），即current.item下实体的id。
+
+    <img src="../assets/shixiandiyigeyewugongneng_202412301404_38.png" class="imgStyle" style="width:90%;" />
+
+- 最后，使用“调用逻辑”组件调用数据表格的组件逻辑reload，用于重新加载数据表格，即重新调用查询数据的服务端逻辑。
+
+    <img src="../assets/shixiandiyigeyewugongneng_202412301404_29.png" class="imgStyle" style="width:550px;" />
+
+至此，删除数据业务功能已完成。
+
+</details>
+
+
+### 3.2 实现删除前二次确认
+
+延用以上工单管理的业务功能，如下将继续演示如何实现删除操作前提供二次确认。大致效果如下：
+
+在数据表格行中点击“删除”按钮，弹出提示弹窗，提示用户“数据删除后将无法恢复，请谨慎操作！”，当用户点击弹窗内的“确认”按钮后再执行删除数据操作。
+
+1.  向页面拖拽一个弹窗组件。
+
+    <img src="../assets/shixiandiyigeyewugongneng_202412301404_40.gif" class="imgStyle" style="" />
+
+1.  编辑弹窗。
+
+    - 选中标题文本，更改弹窗标题为“是否删除”。
+
+        <img src="../assets/shixiandiyigeyewugongneng_202412301404_41.png" class="imgStyle" style="" />
+
+    - 选中内容文本，更改弹窗内容为“数据删除后将无法恢复，请谨慎操作！”。
+
+        <img src="../assets/shixiandiyigeyewugongneng_202412301404_42.png" class="imgStyle" style="" />
+
+    - 选中整体弹窗，设置弹窗提示图标为“警告”。
+
+        <img src="../assets/shixiandiyigeyewugongneng_202412301404_43.png" class="imgStyle" style="" />
+
+2.  为弹窗中的“确定”按钮添加点击事件，用于点击后删除数据。
+
+    <img src="../assets/shixiandiyigeyewugongneng_202412301404_44.gif" class="imgStyle" style="" />
+
+1.  在事件逻辑中完成删除数据的逻辑，逻辑与拖拽生成的业务功能中的[删除数据](#删除数据)类似，参考如下：
+
+    - 使用“调用逻辑”组件调用实体逻辑delete删除数据。
+
+        <img src="../assets/shixiandiyigeyewugongneng_202412301404_45.gif" class="imgStyle" style="" />
+
+    - 弹窗不同于数据表格行，无法直接获取到current.item，因此需要通过变量来传递需要删除的数据。此处创建了一个命名为deleteOrder的实体类型局部变量，并将其id属性作为实体逻辑delete的输入参数。
+
+        <img src="../assets/shixiandiyigeyewugongneng_202412301404_46.gif" class="imgStyle" style="" />
+
+    - 完成删除后，使用“调用逻辑”组件调用弹窗的组件逻辑close，用于关闭弹窗。
+
+        <img src="../assets/shixiandiyigeyewugongneng_202412301404_47.gif" class="imgStyle" style="" />
+
+    - 再使用“调用逻辑”组件调用数据表格的组件逻辑reload，用于重新加载表格数据。
+
+        <img src="../assets/shixiandiyigeyewugongneng_202412301404_48.gif" class="imgStyle" style="" />
+
+2.  修改表格行中的“删除”链接的点击事件。将原有的逻辑删除，当前逻辑用于打开二次确认的弹窗。参考如下：
+
+    - 为需要删除的实体数据deleteOrder赋值。此处即使用“赋值”组件为deleteOrder赋值current.item下的实体。
+    - 使用“调用逻辑”组件调用弹窗的组件逻辑open，用于打开弹窗。
+
+    <img src="../assets/shixiandiyigeyewugongneng_202412301404_49.png" class="imgStyle" style="" />
+
+3.  至此，二次确认删除数据业务功能已完成。建议点击“预览”查看效果。
+
+    <img src="../assets/shixiandiyigeyewugongneng_202412301404_50.png" class="imgStyle" style="" />
+
+## 4. 效果演示
+
+<img src="../assets/shixiandiyigeyewugongneng_202412301404_51.gif" class="imgStyle" style="" />
+
+<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年12月30日</span>
+</div>
+
+<style>
+/* 折叠块加边框、背景色、边距 */
+  details {
+      border: 1px solid #679CF8; /* 添加边框 */
+      border-radius: 6px;
+      background-color: #F8FCFF; /* 添加底色 */
+      padding: 10px 40px 10px 40px;
+      box-shadow: 0 2px 4px rgba(0, 0, 0, 0.2);
+  }
+
+  /* 折叠块标题不需要内边距 */
+  details summary {  
+    margin: 0 0 0 -20px;
+    font-weight: bold;
+    color: #679CF8;
+    cursor: pointer;
+  }
+  </style>

package/skills/smart-customer-service/docs/codewave/10./346/226/260/346/211/213/345/205/245/351/227/250/095./347/274/226/346/216/222/347/254/254/344/270/200/344/270/252/351/200/273/350/276/221.md

@@ -0,0 +1,154 @@
+# 编排第一个逻辑
+
+## 1.场景介绍
+
+在 CodeWave 开发平台中，提供了逻辑编排功能以及丰富的逻辑组件，为数据查询、计算、流转及存储等业务场景提供了高效解决方案。编排过程只需要拖拽功能节点至逻辑线，并完成功能节点的配置即可。本文以工单管理系统为例，从服务端逻辑的数据查询开始，指引用户编排第一个逻辑，演示业务逻辑如下：
+
+查询工单系统中所有状态为已完成的工单，判断其更新时间与创建时间的差值是否小于4小时，将符合的工单标记为“快速解决“。
+
+## 2.前提条件
+
+本文基于实体来实现业务逻辑，关于实体的创建以及拖拽的学习请参考[创建第一个实体](../10.新手入门/080.创建第一个实体.md)。为实现业务逻辑准备的实体WorkOrder如下：
+
+<img src="../assets/bianpaidiyigeluoji_202510291140_1.png" class="imgStyle" style="" />
+
+## 3.操作步骤
+
+### 3.1 了解逻辑IDE
+
+应用支持编排页面逻辑、事件逻辑和服务端逻辑，逻辑编排方式相同，编排时都包含画布和逻辑组件，但页面逻辑和事件逻辑在页面IDE中编排，而服务端逻辑在逻辑IDE中编排。并且两者功能侧重存在差异：
+
+- 页面逻辑和事件逻辑作为前端逻辑，更侧重页面交互、数据展示相关的轻量处理；
+- 服务端逻辑聚焦数据存储、复杂计算、权限校验等核心业务处理。
+
+本文演示的业务逻辑需要在服务端逻辑完成数据查询，因此以下将聚焦服务端逻辑的编排流程展开详细说明。
+
+进入逻辑模块并选中逻辑后，可以看到逻辑 IDE 主要分为三个区域，分别是逻辑目录、画布、组件/属性面板。
+
+<img src="../assets/bianpaidiyigeluoji_202510291140_2.png" class="imgStyle" style="" />
+
+- 逻辑目录：管理应用端下的服务端逻辑、接口、服务端全局变量及连接器。双击或右键各节点可进行查看详情、编辑等操作。
+- 画布：可视化编排逻辑的主要操作区域，用户可以将不同的逻辑组件放置于画布的逻辑线上以构建业务逻辑。
+- 组件/属性面板：组件面板包含所有逻辑组件，可直接拖拽到画布用户编排逻辑；属性面板可以对逻辑的名称、描述、是否开启事务和共享等进行设置。
+
+### 3.2 创建逻辑
+
+1. 在逻辑目录右侧点击“+”按钮，选择“添加服务端逻辑”。
+
+<img src="../assets/bianpaidiyigeluoji_202510291140_3.png" class="imgStyle" style="" />
+
+2. 自定义一个辨识度较高的逻辑名称，例如loadWorkOrder，方便后续查找。
+
+<img src="../assets/bianpaidiyigeluoji_202510291140_4.png" class="imgStyle" style="" />
+
+### 3.3 编排逻辑
+
+根据场景介绍，我们可以先简单梳理逻辑的实现步骤，再按照逻辑的执行顺序依次拖拽到画布的逻辑线上。
+
+1. 查询数据：查询出工单系统中所有状态为已完成的工单。
+2. 修改数据结构：新增“快速解决”标记字段，支持以下两种实现方式。为帮助用户更全面地了解逻辑编排的多元化，本文将采用第二种实现方法进行示例演示。
+
+   - 直接在原有实体中添加该字段，标记结果将同步存储至数据库；
+   - 新建数据结构，通过两个属性分别记录实体信息与标记信息，标记结果不持久化存储，每次调用相关逻辑时实时输出。
+
+3. 判断时间差：循环查询到的数据，计算每一条数据更新时间与创建时间的差值并判断是否小于4小时，为判断为真的数据的“快速解决”标记字段赋值。
+
+#### 3.3.1 查询数据
+
+1. 为服务端逻辑创建一个用于获取查询结果的局部变量并自定义命名，例如queryList，将其拖拽到画布的逻辑线上，此时应用会自动在逻辑线中添加赋值组件，并将局部变量置于赋值操作的左侧，以此支持对该局部变量进行赋值操作。
+
+    <img src="../assets/bianpaidiyigeluoji_202510291140_5.gif" class="imgStyle" style="" />
+
+2. 在赋值组件的右侧拖拽数据查询组件，用于查询工单实体数据。
+
+    <img src="../assets/bianpaidiyigeluoji_202510291140_6.gif" class="imgStyle" style="" />
+
+3. 双击编辑查询数据，选择实体WorkOrder作为查询对象。
+
+    <img src="../assets/bianpaidiyigeluoji_202510291140_7.gif" class="imgStyle" style="" />
+
+4. 继续编辑数据查询，设置筛选条件为“实体的状态字段 = 已完成“。
+
+    <img src="../assets/bianpaidiyigeluoji_202510291140_8.png" class="imgStyle" style="" />
+
+#### 3.3.2 修改数据结构
+
+1. 切换至数据模块，创建一个数据结构并自定义命名，例如WorkOrderStructure。在数据结构中添加两条属性:
+
+   - workOrder：工单实体类型，用于在修改数据结构后赋值实体数据；
+   - isQuickSolve：Boolean类型，用于在修改数据结构后赋值是否标记为“快速解决”，推荐设置默认值false。
+
+    <img src="../assets/bianpaidiyigeluoji_202510291140_9.png" class="imgStyle" style="" />
+
+2. 返回逻辑模块，向逻辑线中拖拽内置函数组件，选择列表（List）函数中的Transfrom对列表中的每一项数据进行数据结构转换。
+
+    <img src="../assets/bianpaidiyigeluoji_202510291140_10.png" class="imgStyle" style="" />
+
+3. 待转化数据结构的列表即queryList。
+
+    <img src="../assets/bianpaidiyigeluoji_202510291140_11.gif" class="imgStyle" style="" />
+
+4. 转换的数据结构为新建数据结构WorkOrderStructure，拖拽新建组件并全选WorkOrderStructure的属性。
+
+    <img src="../assets/bianpaidiyigeluoji_202510291140_12.gif" class="imgStyle" style="" />
+
+5. 拖拽变量到新建组件右侧，找到item.workOrder，即待转化数据结构的列表queryList中的每一项数据，将其初始化为数据结构WorkOrderStructure的workOrder属性的值。
+
+    <img src="../assets/bianpaidiyigeluoji_202510291140_13.gif" class="imgStyle" style="" />
+
+6. 创建一个用于获取转换结果的局部变量并自定义命名，例如transformList，将内置函数Transfrom的结果赋值给该局部变量。
+
+    <img src="../assets/bianpaidiyigeluoji_202510291140_14.png" class="imgStyle" style="" />
+
+#### 3.3.3 判断时间差
+
+1. 向逻辑线中拖拽ForEach组件，循环遍历transformList，计算每一项数据的时间差。
+
+    <img src="../assets/bianpaidiyigeluoji_202510291140_15.gif" class="imgStyle" style="" />
+
+2. 在循环中，使用If组件判断结果，在判断条件中使用比较运算，比较时间差值是否小于4。
+
+    <img src="../assets/bianpaidiyigeluoji_202510291140_16.png" class="imgStyle" style="" />
+
+3. 时间差值使用内置函数DateDiff计算，两个时间分别为创建时间和更新时间。
+
+    <img src="../assets/bianpaidiyigeluoji_202510291140_17.png" class="imgStyle" style="" />
+
+4. 判断为真时，为item.isQuickSolve赋值true，表示当前项数据标记为“快速解决”。
+
+    <img src="../assets/bianpaidiyigeluoji_202510291140_18.png" class="imgStyle" style="" />
+
+#### 3.3.4 输出结果
+
+创建一个输出参数result并将其赋值为局部变量transfromList，那么在调用逻辑时即可将该业务逻辑的最终结果输出。
+
+<img src="../assets/bianpaidiyigeluoji_202510291140_19.png" class="imgStyle" style="" />
+
+### 3.4 调用逻辑
+
+服务端逻辑的输出结果，通常用于前端数据展示。
+
+以本示例来说，输出结果的数据类型为 List 时，可直接作为组件数据源。在组件数据源的编辑表达式中，通过 “调用逻辑” 组件调用该服务端逻辑即可。
+
+<img src="../assets/bianpaidiyigeluoji_202510291140_20.png" class="imgStyle" style="" />
+
+更常见的使用场景是，在前端的页面逻辑或事件逻辑中，借助 “调用逻辑” 组件来调用服务端逻辑。例如，为按钮组件创建一个点击事件，在该事件逻辑中调用服务端逻辑。
+
+<img src="../assets/bianpaidiyigeluoji_202510291140_21.png" class="imgStyle" style="" />
+
+<img src="../assets/bianpaidiyigeluoji_202510291140_22.png" class="imgStyle" style="" />
+
+## 4.其他说明
+
+逻辑具体可细分为服务端逻辑、实体逻辑、扩展逻辑、页面逻辑、事件逻辑、组件逻辑及系统逻辑七类。本文仅选取服务端逻辑作为演示载体，展示逻辑编排的核心流程，其余逻辑的详细定义、适用场景及使用规范，可参考[逻辑的分类](../20.应用开发/15.逻辑功能实现/10.逻辑IDE/15.逻辑分类/10.逻辑的分类.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);">2025年10月29日</span>
+</div>