codewave-openclaw-installer 1.0.0

package/skills/smart-customer-service/docs/codewave/80./345/270/270/350/247/201/345/234/272/346/231/257/346/241/210/344/276/213/50./351/200/273/350/276/221/345/234/272/346/231/257/50./345/234/250/351/200/273/350/276/221/344/270/255/350/260/203/347/224/250/347/254/254/344/270/211/346/226/271/346/216/245/345/217/243.md

@@ -0,0 +1,124 @@
+# 在逻辑中调用第三方接口
+
+## 1. 场景介绍
+
+本案例实现功能：调用外部接口获取图片信息，并在页面的中展示图片列表，实现如下图效果。
+
+需调用第三方get接口，接口文档地址：[https://api.apiopen.top/swagger/index.html#/开放接口/get_api_getImages](https://api.apiopen.top/swagger/index.html#/%E5%BC%80%E6%94%BE%E6%8E%A5%E5%8F%A3/get_api_getImages)
+
+![0](../assets/dydsfjk1.png)
+
+## 2. 操作步骤
+
+### 2.1 创建第三方API应用
+
+在集成中心 > 应用API管理 点击创建应用，录入相关信息。本台中调用第三方接口需要先创建第三方API应用，用于表示API提供方应用的信息。
+
+![0](../assets/dydsfjk2.png)
+
+### 2.2 创建API
+
+创建应用后点击列表中的应用名称进入到详情页，点击API管理，点击创建API，录入接口信息。
+
+说明：请求标识、请求路径须参照第三方接口文档。
+
+![0](../assets/dydsfjk3.png)
+
+![0](../assets/dydsfjk4.png)
+
+### 2.3 添加请求信息
+
+创建API成功后从列表点击名称进入API详情，点击请求信息，点击修改，编辑请求信息后点击保存。
+
+说明：添加的请求信息由请求的API决定，具体应查阅所调用API的文档。本案例所使用的第三方接口，请求信息Query参数都为选填项。
+
+![0](../assets/dydsfjk5.png)
+
+### 2.4 添加响应信息
+
+1. 在API详情页点击响应信息，点击修改，添加ResponseBody的结构信息，点击保存。其中参数result是复杂数据结构，需要新建数据模型。
+
+   数据模型：AP响应信息结果中可能包含复杂数据结构，须创建对应的自定义数据结构。
+
+    本案例接口的响应内容，根据该JSON创建数据模型：
+    ```
+    {
+    "code": 200,
+    "message": "成功!",
+    "result": {
+        "total": 19080,
+        "list": [
+        {
+            "id": 6364,
+            "title": "夜间 天空 星星 月亮 5K",
+            "url": "https://pic.netbian.com/uploads/allimg/170619/171845-149786392565a1.jpg",
+            "type": "scenery"
+        }
+        ]
+    }
+    }
+    ```
+    ![0](../assets/dydsfjk6.png)
+
+说明：创建数据模型有两种方式
+
+* 方式一：可在选择数据类型时快速创建。
+
+  ![0](../assets/dydsfjk7.png)
+
+  ![0](../assets/dydsfjk8.png)
+* 方式二：可以在API管理 > 数据模型 > 创建数据模型 中进行创建和查看。
+
+  ![0](../assets/dydsfjk9.png)
+
+### 2.5 接口调试（可选）
+
+调用接口之前可进行接口调试，在服务端逻辑 > 接口 > 外部接口，选择“查看全部接口”，在接口列表中选择需要调试的接口，配置请求参数后点击“开始调试”，下方窗口中可以预览接口请求的结果。
+
+![0](../assets/dydsfjk10.png)
+
+### 2.6 调用接口
+
+如果IDE是v2.21及以下版本，调用接口前需提前导入接口。
+
+<details>
+      <summary title="点击查看2.21及以下版本导入接口方式" style="font-weight: bold; color: #679CF8; cursor: pointer;">
+            点击查看2.21及以下版本导入接口方式
+      </summary>
+<img src="../assets/dydsfjk11.png" alt="image"/>      
+<img src="../assets/dydsfjk12.jpg" alt="image"/>   
+</details>
+
+v2.21及以上版本，可直接使用调用接口组件直接调用，无需提前导入接口。
+
+1. 创建一个服务端逻辑，为在页面中实现后端分页效果，需添加类型为integer的输入参数page、size，局部变量apiResult，并创建输出参数result。其中apiResult、result的类型可在后续由平台自动推导。
+
+   ![0](../assets/dydsfjk13.png)
+2. 拖拽变量apiResult至逻辑中，自动生成赋值，将调用接口组件放置赋值右侧，并选择所调用的接口。并将入参page、size放置在对应位置。
+
+   ![0](../assets/dydsfjk14.png)
+3. 拖拽出参result至逻辑中，自动生成赋值，将内置函数组件拖拽至赋值右侧，选用CreateListPage，将变量apiResult中的属性list放置在list中，将变量apiResult中的属性total放置在total中。
+
+   CreateListPage用于将List转换为{list:List,total:Integer整数}，实现列表分页效果。
+
+   ![0](../assets/dydsfjk15.png)
+4. 在页面拖拽生成数据表格，数据源绑定上文添加的服务端逻辑。
+
+   ![0](../assets/dydsfjk16.png)
+5. 服务端逻辑的page、size参数分别使用数据表格的page、size
+
+   ![0](../assets/dydsfjk17.png)
+6. 为数据表格添加两个表格列，分别用于展示图片标题、图片链接。
+
+   ![0](../assets/dydsfjk18.png)
+7. 图片标题列将文本组件放置在表格列插槽中，文本内容绑定current > item > title。图片链接列使用链接组件，链接组件的文本属性和链接地址属性都绑定current > item > url。
+
+   ![0](../assets/dydsfjk19.png)
+
+    链接的跳转地址绑定url字段。
+
+   ![0](../assets/dydsfjk20.png)
+
+8. 发布预览查看效果。
+
+   ![0](../assets/dydsfjk1.png)

package/skills/smart-customer-service/docs/codewave/80./345/270/270/350/247/201/345/234/272/346/231/257/346/241/210/344/276/213/50./351/200/273/350/276/221/345/234/272/346/231/257/55./345/246/202/344/275/225/345/260/206/346/234/215/345/212/241/347/253/257/351/200/273/350/276/221/350/256/276/347/275/256/344/270/272/344/273/205/347/231/273/345/275/225/345/220/216/345/217/257/350/260/203/347/224/250.md

@@ -0,0 +1,60 @@
+# 如何将服务端逻辑设置为仅登录后可调用
+
+## 场景介绍
+
+希望为页面上使用到的服务端逻辑设置调用权限，只有在登录状态下才能成功调用。
+
+以下通过两种方式实现，可根据具体的需求选择合适的方案。
+
+## 操作步骤
+
+### 方式一：使用页面的权限控制
+
+可以对整体页面或页面上的组件进行权限控制，组件中使用到的服务端逻辑便会同时受到限制。弊端是必须跟随页面，无法针对服务端逻辑本身进行权限控制。
+
+**操作示例：**
+
+- 为页面设置权限控制：选中页面后，在右侧属性面板中开启“权限控制”，添加授权角色。只有账号已登录且为该角色的用户才能访问该页面。
+
+    <img src="../assets/ruhejiangfuwuduanluojishezhiweijindengluhoukediaoyong_202502101859_1.png" class="imgStyle" style="" />
+
+- 为页面组件设置权限控制：选中页面上的组件后，在右侧属性面板中开启“权限控制”，添加授权角色。只有账号已登录且为该角色的用户才能看到该页面组件。
+
+    <img src="../assets/ruhejiangfuwuduanluojishezhiweijindengluhoukediaoyong_202502101859_2.png" class="imgStyle" style="" />
+
+### 方式二：在服务端逻辑中判断是否已登录
+
+如何希望服务端逻辑不跟随页面走鉴权，而是单独判断该逻辑的鉴权，则可以在逻辑中手动判断是否已登录，如果已登录则正常执行，如果未登录则抛出异常，并在抛出异常时提示需要登录，如下图所示。
+
+> 异常的概念介绍与使用方式请参考文档：[异常处理](../../20.应用开发/15.逻辑功能实现/45.逻辑编辑/85.异常处理.md)。
+
+<img src="../assets/ruhejiangfuwuduanluojishezhiweijindengluhoukediaoyong_202502101859_3.gif" class="imgStyle" style="" />
+
+**操作示例：**
+
+1.  在服务端逻辑中判断currentUser变量是否有效，有效则正常执行后续逻辑，否则result返回异常类型。
+
+    > currentUser变量位于全局变量下，代表请求服务端时当前登录用户的信息。
+
+    <img src="../assets/ruhejiangfuwuduanluojishezhiweijindengluhoukediaoyong_202502101859_4.png" class="imgStyle" style="" />
+
+1.  在页面中可以用两种方式处理返回了异常类型的逻辑。
+
+    - 方式一：设置调用服务端逻辑后事件。
+
+        选择**页面IDE>事件逻辑>调用服务端逻辑后**，在该事件逻辑的对应分支下提示需要登录账号才可调用。
+
+        <img src="../assets/ruhejiangfuwuduanluojishezhiweijindengluhoukediaoyong_202502101859_5.png" class="imgStyle" style="" />
+
+    - 方式二：手动处理异常。
+
+        在页面中调用服务端逻辑时，开启“手动处理Error”，使用匹配组件判断逻辑返回类型，为异常类型时可以弹出消息提示必须登录账号才允许调用。
+
+        <img src="../assets/ruhejiangfuwuduanluojishezhiweijindengluhoukediaoyong_202502101859_6.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);">2025年02月10日</span>
+</div>

package/skills/smart-customer-service/docs/codewave/80./345/270/270/350/247/201/345/234/272/346/231/257/346/241/210/344/276/213/50./351/200/273/350/276/221/345/234/272/346/231/257/60./345/246/202/344/275/225/345/234/250/346/234/215/345/212/241/347/253/257/351/200/273/350/276/221/344/270/255/346/211/223/345/215/260/346/227/245/345/277/227.md

@@ -0,0 +1,58 @@
+# 如何在服务端逻辑中打印日志
+
+## 1. 场景介绍
+
+在服务端逻辑中，通常使用日志组件打印输入参数及执行结果。
+
+## 2. 操作步骤
+
+### 2.1 打印日志
+
+在服务端逻辑中，拖拽打印日志组件放置需要打印日志的位置，此场景以打印逻辑的输出参数result为例。
+
+> 注意：
+>
+> 当变量数据类型为String时，可直接打印；
+>
+> 当变量数据类型为其他基本数据类型时，需将其转换成String字符串类型后打印；
+>
+> 当变量数据类型为对象时，需将其序列化成String字符串类型后打印。
+
+<img src="../assets/fwddyrz_0604_1949_1.png" style="border: 1px solid #ccc;" />
+
+### 2.2 查看日志
+
+应用详情的运维管理页中，可分别查看开发环境或生产环境制品的日志。点击开发环境的更多操作，点击查看日志，进入开发环境日志详情页面。
+
+<img src="../assets/fwddyrz_0604_1949_2.png" style="border: 1px solid #ccc;" />
+
+<img src="../assets/fwddyrz_0604_1949_3.png" style="border: 1px solid #ccc;" />
+
+在日志详情页面，可通过时间范围的筛查看日志，亦可通过搜索关键字、服务端逻辑名称、筛选日志级别以及勾选是否只看组件输出日志来查看日志。
+
+<img src="../assets/fwddyrz_0604_1949_4.png" style="border: 1px solid #ccc;" />
+
+## 3. 说明
+
+CodeWave智能开发平台的提供了多种方式进行筛选日志，并提供导出日志功能：
+
+* 时间范围：支持选择预设的时间范围（如近1小时、近6小时、近1天）和自定义时间范围进行筛选日志。
+* 关键字搜索：支持通过关键字筛选日志。
+* 日志级别：支持根据包括INFO、ERROR、WARN、DEBUG四种不同的级别筛选日志。
+
+在实际开发中，我们可以根据需要来设置日志级别，以输出对应级别的日志信息。
+
+* INFO：用于输出程序的运行状态，一般用于生产环境中；
+* WARN：用于输出程序中一些警告信息，表示程序出现了一些不影响正常运行但需要关注的情况；
+* ERROR：用于输出程序中的错误信息，表示程序出现了一些需要立即处理的错误；
+* DEBUG：用于调试程序，输出程序中一些关键信息，可以在开发环境和测试环境中使用。
+* 服务端逻辑：支持根据特定服务端逻辑名称筛选日志。
+* 只看组件输出日志：支持仅查看组件输出的日志。
+* 导出日志：支持导出当前筛选结果或全量日志。
+
+<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年06月04日</span>
+</div>

package/skills/smart-customer-service/docs/codewave/80./345/270/270/350/247/201/345/234/272/346/231/257/346/241/210/344/276/213/50./351/200/273/350/276/221/345/234/272/346/231/257/70./345/246/202/344/275/225/351/200/200/345/207/272/345/275/223/345/211/215/347/231/273/345/275/225/347/212/266/346/200/201.md

@@ -0,0 +1,24 @@
+# 如何退出当前登录状态
+
+## 1.场景介绍
+
+在基于身份认证的应用程序中，用户已经登录并希望退出当前的登录状态，想要安全地结束会话并返回到登录页面。
+
+## 2.操作步骤
+
+1. 在可视化开发页面中，找到“退出”或类似的按钮组件，如应用程序的导航栏的"安全退出"（登出）选项。
+
+   ![image-20230807164357859](../assets/logout1.png)
+2. 选中单击"安全退出"选项，为其添加一个点击事件logout。
+
+   ![image-20230807164357859](../assets/logout2.png)
+3. 编辑点击事件logout逻辑
+
+   ![image-20230807164357859](../assets/logout3.png)
+4. 发布预览
+
+## 3.效果演示
+
+当触发调用logout逻辑后平台默认设置为弹出弹窗提示用户“是否确认退出登录”，用户点击确认后会返回到平台自带的登录页面。
+
+![image-20230807164357859](../assets/logout4.gif)

package/skills/smart-customer-service/docs/codewave/80./345/270/270/350/247/201/345/234/272/346/231/257/346/241/210/344/276/213/50./351/200/273/350/276/221/345/234/272/346/231/257/80./345/246/202/344/275/225/351/230/273/346/255/242/344/272/213/344/273/266/345/220/221/344/270/212/344/274/240/351/200/222.md

@@ -0,0 +1,41 @@
+# 如何阻止事件向上传递
+
+## 1.场景介绍
+
+阻止事件向上传递是指在构建应用程序或界面时，可以通过设置特定的属性或配置来阻止事件从子组件向父组件传递从而避免发生冲突。
+
+例如，在商品管理的应用网页中包含多个嵌套的组件，链接的点击事件与卡片的点击事件发生冲突，点击修改链接时并没有弹出修改弹窗，而是触发了卡片的点击跳转动作。同样删除链接的点击事件也会与卡片的点击事件发生冲突。
+
+冲突详情：
+
+![image-20230807164357859](../assets/stopPropagation1.gif)
+
+为了解决这个冲突，可以采取以下方法来阻止事件向上传递：
+
+在修改链接的点击事件逻辑中使用stopPropagation，以阻止修改链接的点击事件传递给父组件。这样，点击修改链接时不会触发卡片的跳转动作，而是弹出修改弹窗。同样的冲突解决方案也适用于删除链接。
+
+## 2.操作步骤
+
+1. 在可视化开发页面中，找到发生冲突的父子组件。
+
+   ![image-20230807164357859](../assets/stopPropagation2.png)
+2. 选中卡片上的修改链接
+
+   ![image-20230807164357859](../assets/stopPropagation3.png)
+3. 编辑卡片上修改链接的点击事件，在事件逻辑起始位置调用系统逻辑下的事件逻辑stopPropagation
+
+   ![image-20230807164357859](../assets/stopPropagation4.png)
+4. 发布预览
+
+## 3.效果演示
+
+   ![image-20230807164357859](../assets/stopPropagation5.gif)
+
+## 4.说明
+
+阻止事件向上传递的关键是在子组件的事件逻辑中调用逻辑stopPropagation，以阻止事件继续传递到父组件。这样可以控制事件的范围，避免事件在多个层次的组件中触发。阻止事件传递只会阻止事件在子组件向父组件传递，不会影响同一组件上的其他事件处理逻辑的执行。
+
+阻止事件向上传递的主要目的包括：
+
+* 控制事件处理范围：通过阻止事件向上传递，可以确保事件仅在当前组件内部处理，而不被父组件或其他组件干扰。这使得开发者能够精确控制事件的处理范围，避免冲突和混乱。
+* 避免不必要的事件触发：在复杂的应用程序或界面中，存在大量的组件，它们可能都具有相同类型的事件。如果事件向上传递，可能导致多个组件同时触发事件处理逻辑，这可能造成不必要的计算和资源消耗。通过阻止事件向上传递，可以避免不必要的事件触发，提高应用程序的性能和效率。

package/skills/smart-customer-service/docs/codewave/80./345/270/270/350/247/201/345/234/272/346/231/257/346/241/210/344/276/213/50./351/200/273/350/276/221/345/234/272/346/231/257/85./345/246/202/344/275/225/345/256/236/347/216/260/351/241/265/351/235/242/345/210/267/346/226/260.md

@@ -0,0 +1,34 @@
+# 如何实现页面刷新
+
+## 问题描述
+
+如何实现手动刷新页面，包括PC端页面和H5端页面。
+
+## 解决方案
+
+当页面需要整体重新加载时，可使用JS代码块刷新整个页面。
+
+```javascript
+// 简单刷新页面
+location.reload();
+
+// 强制从服务器重新加载（忽略缓存）
+location.reload(true);
+```
+
+在逻辑组件中使用“JS代码块”组件即可。
+
+<img src="../assets/ruheshixianyemianshuaxin_202408281651_1.png" class="imgStyle" style="" />
+
+## 补充说明
+
+### 局部内容刷新
+
+如果只希望更新页面上的局部内容，而不是刷新整体页面，可参考文档：[如何实现页面上局部内容刷新](../50.逻辑场景/86.如何实现页面上局部内容刷新.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年08月28日</span>
+</div>

package/skills/smart-customer-service/docs/codewave/80./345/270/270/350/247/201/345/234/272/346/231/257/346/241/210/344/276/213/50./351/200/273/350/276/221/345/234/272/346/231/257/86./345/246/202/344/275/225/345/256/236/347/216/260/351/241/265/351/235/242/344/270/212/345/261/200/351/203/250/345/206/205/345/256/271/345/210/267/346/226/260.md

@@ -0,0 +1,53 @@
+# 如何实现页面上局部内容刷新
+
+## 问题描述
+
+如何实现手动刷新页面上的局部内容，例如刷新数据表格展示的数据。
+
+## 解决方案
+
+当页面上组件展示的数据需要刷新时，可根据组件数据源类型的不同选择不同的刷新方式：
+
+### 组件的数据源为逻辑时
+
+组件展示内容的数据源为逻辑时，可调用组件的reload逻辑实现组件数据源的更新，reload逻辑用于重新加载数据源。
+
+以下图为例，数据表格的数据源绑定了服务端逻辑，点击“刷新”按钮时，调用该数据表格的reload逻辑即可刷新表格数据。
+
+<img src="../assets/ruheshixianyemianshujushuaxin_202406182040_1.png" class="imgStyle" style="" />
+
+<img src="../assets/ruheshixianyemianshujushuaxin_202406182040_2.png" class="imgStyle" style="" />
+
+在“调用逻辑”组件中搜索`reload`可快速定位到该组件的reload逻辑。
+
+<img src="../assets/ruheshixianyemianshujushuaxin_202406182040_3.png" class="imgStyle" style="" />
+
+### 组件的数据源为变量时
+
+组件展示数据为变量时，修改该变量即可更新页面数据。
+
+以下图为例，数据表格的数据源绑定了bookList变量，点击“刷新”按钮时，为bookList变量重新赋值，实现表格数据的刷新。
+
+<img src="../assets/ruheshixianyemianshujushuaxin_202406182040_4.png" class="imgStyle" style="" />
+
+<img src="../assets/ruheshixianyemianshujushuaxin_202406182040_5.png" class="imgStyle" style="" />
+
+本案例中，点击刷新按钮后，调用服务端逻辑并赋值给bookList变量。
+
+需要注意的是，使用变量作为数据源时，通常需要对变量进行初始化，例如在进入页面时为该变量赋值。
+
+<img src="../assets/ruheshixianyemianshujushuaxin_202406182040_6.png" class="imgStyle" style="" />
+
+## 补充说明
+
+### 刷新整个页面
+
+页面需要整体重新加载时，可使用JS代码块`location.reload();`刷新整个页面，文档请参考[如何实现页面刷新](../50.逻辑场景/85.如何实现页面刷新.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年8月28日</span>
+</div>

package/skills/smart-customer-service/docs/codewave/80./345/270/270/350/247/201/345/234/272/346/231/257/346/241/210/344/276/213/50./351/200/273/350/276/221/345/234/272/346/231/257/90./345/246/202/344/275/225/345/256/236/347/216/260/345/256/232/346/227/266/344/273/273/345/212/241.md

@@ -0,0 +1,84 @@
+# 如何实现定时任务
+
+## 1. 场景介绍
+
+定时任务是指按照预定的时间规则或间隔周期性地执行某个任务的一种机制。它可以自动化地完成指定的操作，以减少手动干预的工作量，提高工作效率。
+
+案例目标：每日零点根据商品过期时间，对商品状态进行修改。
+
+## 2. 前提条件
+
+1. 已有枚举，包含以下商品状态值：
+
+   * 枚举值0，标题启用；
+   * 枚举值1，标题过期。
+
+   <img src="../assets/rhsxdsrw_20240429_181916_001.png" alt="0" style="border:1px solid #ccc;" />
+2. 已有Product实体，包含以下商品信息：
+
+   * 商品名称：name，String文本类型
+   * 商品价格：price，Decimal 小数类型
+   * 商品状态：status，ProductStatus枚举类型
+
+   <img src="../assets/rhsxdsrw_20240429_181916_002.png" alt="0" style="border:1px solid #ccc;" />
+3. 已有基础页面和数据，如下：
+
+   ![0](../assets/rhsxdsrw_20240429_181916_003.png)
+
+## 3. 操作步骤
+
+### 3.1 创建并编辑服务端逻辑
+
+1. 创建服务端逻辑updateStatusTimer。
+2. 编辑服务端逻辑。
+
+   **获取当前日期**
+   a. 在逻辑下创建局部变量currDate，设置数据类型为Date日期类型，用于后续暂存当前日期。
+   b. 将局部变量拖拽至逻辑中生成赋值，在赋值右侧拖入内置函数，选择CurrDate，用于获取当前日期并暂存至局部变量currDate。
+
+   <img src="../assets/rhsxdsrw_20240429_181916_004.png" alt="0" style="border:1px solid #ccc;" />
+
+   **批量更新数据**
+   a. 新建局部变量update存储更新数据。
+
+   <img src="../assets/rhsxdsrw_20240429_181916_005.png" alt="0" style="border:1px solid #ccc;" />
+
+   b. 拖入调用逻辑组件，选择Product.updateBy，用于根据筛选条件批量更新商品数据。
+
+   <img src="../assets/rhsxdsrw_20240429_181916_006.png" alt="0" style="border:1px solid #ccc;" />
+
+   * 设置输入参数filter（筛选条件）：1.过期时间小于当前日期；2.商品状态为“启用”状态。
+
+     <img src="../assets/rhsxdsrw_20240429_181916_007.png" alt="0" style="border:1px solid #ccc;" />
+   * 设置输入参数body：在参数插槽内放置局部变量update，选择局部更新status（状态）属性。
+
+     <img src="../assets/rhsxdsrw_20240429_181916_008.png" alt="0" style="border:1px solid #ccc;" />
+
+### 3.2 设置定时任务
+
+1. 逻辑编写完成后，右键对应的服务端逻辑，选择设置定时任务，打开设置定时任务窗口。
+
+   <img src="../assets/rhsxdsrw_20240429_181916_009.png" alt="0" style="border:1px solid #ccc;" />
+2. 在规则表达式中输入0 0 0 * * ?，意为每日00：00：00运行，也可在右侧查看最近10次的运行时间。在左下角导入规则模板中，平台提供了几种常用模板可进行参考。规则表达式填写完成后，点击“保存”按钮，定时任务即设置完成。
+
+   ![0](../assets/rhsxdsrw_20240429_181916_010.png)
+3. 发布预览后，该定时任务即可生效。
+
+   <img src="../assets/rhsxdsrw_20240429_181916_011.png" alt="0" style="border:1px solid #ccc;" />
+
+   已设置定时任务的服务端逻辑可右键查看定时任务或取消定时任务，定时任务修改后需再次发布才能生效。
+
+   <img src="../assets/rhsxdsrw_20240429_181916_012.png" alt="0" style="border:1px solid #ccc;" />
+
+## 4. 说明
+
+1. 已有输入参数的服务端逻辑下不支持设置定时任务。
+2. 设置了定时任务的服务端逻辑不支持添加输入参数。
+3. 输入规则表达式时需使用英文符号。
+
+<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年08月16日</span>
+</div>

package/skills/smart-customer-service/docs/codewave/80./345/270/270/350/247/201/345/234/272/346/231/257/346/241/210/344/276/213/55./346/225/260/346/215/256/346/237/245/350/257/242/345/234/272/346/231/257/05./345/246/202/344/275/225/346/237/245/350/257/242/345/271/266/350/216/267/345/217/226/345/256/236/344/275/223/346/225/260/347/273/204.md

@@ -0,0 +1,90 @@
+# 如何查询并获取实体数组
+
+## 场景介绍
+
+需要查询实体中的数据，返回查询结果集的实体列表。例如，已有Book实体用于存储书籍信息，现需要在CodeWave应用中查询出所有书籍。
+
+## 前提条件
+
+已创建实体，本案例使用Book实体表示书籍信息。
+
+<img src="../assets/ruhechaxunbinghuoqushitishuzu_202408262002_1.png" class="imgStyle" style="" />
+
+## 操作步骤
+
+1. 在IDE左侧选择“逻辑”，点击加号并选择“添加服务端逻辑”，用于创建一个服务端逻辑。
+
+    <img src="../assets/ruhechaxunbinghuoqushitishuzu_202408262002_2.png" class="imgStyle" style="" />
+
+2. 为新建的逻辑命名，并添加输出参数，输出参数无需设置数据类型。
+
+    <img src="../assets/ruhechaxunbinghuoqushitishuzu_202408262002_3.png" class="imgStyle" style="" />
+
+3. 拖拽赋值组件到画布中，左侧选择输出参数。（可以将result变量拖拽到画布中快捷生成赋值）
+
+    <img src="../assets/ruhechaxunbinghuoqushitishuzu_202408262002_4.png" class="imgStyle" style="" />
+
+4. 拖拽数据查询组件，放到赋值右侧。
+
+    <img src="../assets/ruhechaxunbinghuoqushitishuzu_202408262002_5.png" class="imgStyle" style="" />
+
+5. 双击画布中的数据查询组件，进入到数据查询编辑界面。
+
+    <img src="../assets/ruhechaxunbinghuoqushitishuzu_202408262002_6.gif" class="imgStyle" style="" />
+
+6. 从浮窗中拖拽需要查询的实体放到画布中。
+
+    <img src="../assets/ruhechaxunbinghuoqushitishuzu_202408262002_7.gif" class="imgStyle" style="" />
+
+7. 如果实体中已存在数据，可以点击下方的“开始调试”按钮，预览查询结果。如果创建了实体后还没有发布过，可跳过此步骤。
+
+    <img src="../assets/ruhechaxunbinghuoqushitishuzu_202408262002_8.png" class="imgStyle" style="" />
+
+8. 点击如图所示按钮，可回到逻辑编辑界面。
+
+    <img src="../assets/ruhechaxunbinghuoqushitishuzu_202408262002_9.png" class="imgStyle" style="" />
+
+9. 逻辑编辑完成，可调用该逻辑查询Book实体的所有数据。
+
+    <img src="../assets/ruhechaxunbinghuoqushitishuzu_202408262002_10.png" class="imgStyle" style="" />
+
+## 补充说明
+
+- 本案例是使用数据查询组件来查询实体数据，另外也可以使用[SQL查询组件](../../20.应用开发/15.逻辑功能实现/40.逻辑组件使用/37.数据查询/35.SQL查询.md)实现。
+- 需要特别注意，使用数据查询组件进行查询时，查询结果并不是`List<实体>`，而是`List<数据结构>`，该数据结构中包含了实体。以本案例的Book示例为例，查询结果的数据结构如下所示。
+
+    ```json
+    [
+        {
+            "book":{
+                "id":1
+                "createdTime":"2024-06-19T17:13:50.495Z"
+                "updatedTime":"2024-06-19T17:13:50.495Z"
+                "createdBy":null
+                "updatedBy":null
+                "name":"三国演义"
+        },
+        {
+            "book":{
+                "id":2
+                "createdTime":"2024-06-19T17:13:50.495Z"
+                "updatedTime":"2024-06-19T17:13:50.495Z"
+                "createdBy":null
+                "updatedBy":null
+                "name":"红楼梦"
+        }      
+    ]
+    ```
+
+- 在查询实体的时候，通常还需要设置分页和筛选条件。
+
+    - 分页：分页是为了避免一次性查询出所有数据，减少数据量从而优化性能，分页组件的介绍与示例请参考：[数据查询-分页](../../20.应用开发/15.逻辑功能实现/40.逻辑组件使用/37.数据查询/40.分页.md)。未设置分页时默认查询出所有数据。
+    - 筛选条件：在查询中添加筛选条件，用于仅查询满足特定条件的实体数据，例如只查询名称中包含“数学”的书籍。场景示例可参考[如何通过筛选条件查询并显示数据](../../80.常见场景案例/40.组件场景/20.表格场景/060.如何通过筛选条件查询并显示数据.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年08月26日</span>
+</div>