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/40./347/273/204/344/273/266/345/234/272/346/231/257/20./350/241/250/346/240/274/345/234/272/346/231/257/070./345/246/202/344/275/225/345/256/236/347/216/260/350/214/203/345/233/264/345/206/205/346/237/245/350/257/242.md

@@ -0,0 +1,43 @@
+# 如何实现范围内查询
+
+## 1. 场景介绍
+
+对表格进行筛选时，如果筛选的属性标准不唯一，可以通过选择器的多选值进行范围内匹配。
+
+示例场景如下：筛选多种任务状态下的任务列表。
+
+![](../assets/rhsxfwnsx_update1.png)
+
+## 2. 数据准备
+
+为用于筛选的选择器绑定数据源或添加选项。例如示例中的任务状态属性数据类型为String，通过将所有可选状态存储在枚举中，使用枚举的text属性的集合作为选择器的数据源。
+
+![](../assets/rhsxfwnsx_update2.png)
+
+## 3. 操作步骤
+
+### 3.1 数据绑定
+
+1. 打开选择器的“可多选”属性。
+
+2. 创建List类型的数据变量，将该变量作为选择器的选中值。其中List中的数据类型取决于需要筛选的属性的数据类型。
+
+    ![](../assets/rhsxfwnsx_update3.png)
+
+### 3.2 修改查询逻辑
+
+1. 进入数据表格绑定数据源调用的服务端逻辑。
+
+2. 为服务端逻辑创建输入参数，数据类型与选择器的多选值数据类型相同。
+
+3. 为数据查询添加筛选条件，通过范围内匹配筛选属性值在选中值列表范围内的实体数据。
+
+    ![](../assets/rhsxfwnsx_update4.png)
+
+4. 进入表格绑定的数据源，将选择器的多选值作为服务端逻辑的输入参数。
+
+    ![](../assets/rhsxfwnsx_update5.png)
+
+## 4. 效果演示
+
+![](../assets/rhsxfwnsx_update6.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/40./347/273/204/344/273/266/345/234/272/346/231/257/20./350/241/250/346/240/274/345/234/272/346/231/257/075./345/246/202/344/275/225/344/275/277/347/224/250/346/225/260/346/215/256/346/237/245/350/257/242/345/256/236/347/216/260/350/241/250/346/240/274/345/210/206/351/241/265.md

@@ -0,0 +1,60 @@
+# 如何使用数据查询实现表格分页
+
+## 1. 场景介绍
+
+在使用数据查询展示表格内容时，一次性展示所有数据可能会导致页面加载缓慢，影响使用体验，通过分页可以每次只加载当前页所需的数据，从而提高页面加载速度和响应性能。
+
+本案例使用数据查询组件实现书籍信息的表格分页展示。
+
+## 2. 操作步骤
+
+### 2.1 数据准备
+
+已有实体Book代表书籍信息，数据库中已有若干条书籍记录。
+
+![0](../assets/rhsysjcxsxbgfy_0301_1.png)
+
+### 2.2 添加服务端逻辑
+
+1.添加服务端逻辑，为该逻辑添加输入参数和输出参数：
+
+- 输入参数：Integer整数类型的`page`代表当前页数，Integer整数类型的`size`代表每页查询多少条。
+- 输出参数：`result`，用于接收数据查询的结果，数据类型为平台自动推导，此处无需设置数据类型。
+
+![0](../assets/rhsysjcxsxbgfy_0301_2.png)
+
+2.逻辑中使用赋值和分页，赋值给输出参数`result`，分页的页数为输入参数`page`，每页记录数为输入参数`size`。
+
+![0](../assets/rhsysjcxsxbgfy_0301_3.png)
+
+3.拖拽数据查询组件到分页组件的分页对象中，双击数据查询，设置查询内容为Book实体。
+
+![0](../assets/rhsysjcxsxbgfy_0301_4.png)
+
+![0](../assets/rhsysjcxsxbgfy_0301_5.png)
+
+### 2.3 表格配置
+
+为页面添加数据表格组件。
+
+![0](../assets/rhsysjcxsxbgfy_0301_6.png)
+
+表格的数据源属性中使用调用逻辑组件，选择上文创建的服务端逻辑。
+
+![0](../assets/rhsysjcxsxbgfy_0301_7.png)
+
+展开浮窗中的“页面组件”，展开当前的表格组件，分别拖拽当前组件的page和size作为调用逻辑的输入参数。
+
+![0](../assets/rhsysjcxsxbgfy_0301_8.png)
+
+为数据表格添加列，表格列中使用文本组件展示Book的不同字段。
+
+![0](../assets/rhsysjcxsxbgfy_0301_9.png)
+
+![0](../assets/rhsysjcxsxbgfy_0301_10.png)
+
+发布预览。
+
+## 3. 效果演示
+
+![0](../assets/rhsysjcxsxbgfy_0301_11.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/40./347/273/204/344/273/266/345/234/272/346/231/257/20./350/241/250/346/240/274/345/234/272/346/231/257/080./345/246/202/344/275/225/344/275/277/347/224/250SQL/346/237/245/350/257/242/345/256/236/347/216/260/350/241/250/346/240/274/345/210/206/351/241/265/345/261/225/347/244/272.md

@@ -0,0 +1,114 @@
+# 如何使用SQL查询实现表格分页展示
+
+## 1. 场景介绍
+
+在使用SQL查询数据时，我们通常希望通过分页，将大量的数据分割成小块进行处理和管理。如下使用SQL查询实现表格分页展示的场景。
+
+## 2. 操作步骤
+
+### 2.1 数据准备
+
+准备已有数据的学生信息实体——Students。本示例直接[从Excel文件导入生成实体](../10.数据场景/010.如何从平台外导入并自动生成实体.md)，由于Excel文件中已有数据，因此导入后会连带数据一起。
+
+![image](../assets/rhsySQL_update0.png)
+
+![image](../assets/rhsySQL_update2.png)
+
+### 2.2 添加服务端逻辑，SQL查询数据，返回查询结果
+
+1. 添加服务端逻辑（loadStudents）。
+
+   ![image](../assets/rhsySQL_update4.png)
+2. 添加表格页输入参数（page）和输入参数（size）。
+
+   * 输入参数（page）：用于传递表格页数来查询该页数下对应的数据内容，数据类型为integer整数。
+   * 输入参数（size）：用于传递表格中每页显示数据数量来查询对应数量的数据内容，数据类型为integer整数。
+
+   ![image](../assets/rhsySQL_update5.png)
+3. 添加初始位置局部变量（offset），用于作为SQL查询语句的LIMIT关键字的传入参数，数据类型为Integer整数。
+
+   ![image](../assets/rhsySQL_update10.png)
+4. 添加逻辑，计算查询初始位置，如结尾说明所述，查询第一条记录的位置是0，所以计算方式为：（查询页数-1）*记录数。
+
+   ![image](../assets/rhsySQL_update12.png)
+5. 添加学生列表局部变量（studentList），用于承接SQL查询结果，数据类型为平台自动推导。
+
+   ![image](../assets/rhsySQL_update14.png)
+6. 拖拽SQL查询组件，查询学生信息实体（Students）获取学生列表数据。
+
+   ![image](../assets/rhsySQL_update16.png)
+7. 双击编辑SQL查询，输入SQL分页查询语句后退出。
+
+   ![image](../assets/rhsySQL_update18.png)
+8. 添加查询总记录数局部变量（total），用于承接SQL查询的总记录条数，数据类型为Integer整数。
+
+   ![image](../assets/rhsySQL_update20.png)
+9. 拖拽SQL查询组件，查询学生信息实体（Students）获取学生信息的总记录条数。
+
+   ![image](../assets/rhsySQL_update22.png)
+10. 双击编辑SQL查询，输入SQL聚合函数查询语句后退出。
+
+    ![image](../assets/rhsySQL_update24.png)
+11. 添加输出参数（result），用于承接返回结果，数据类型为平台自动推导。
+
+    ![image](../assets/rhsySQL_update26.png)
+12. 使用CreateListPage内置函数，将学生列表局部变量（studentList）转换为列表分页，传入学生列表局部变量（studentList）作为第一个list参数，传入查询总记录数局部变量（total）作为第二个指定数据条数的total参数。
+
+    ![image](../assets/rhsySQL_update28.png)
+
+### 2.3 页面布局
+
+1. 拖拽使用数据表格组件。
+
+   ![image](../assets/rhsySQL_update30.png)
+2. 以服务端逻辑作为数据源绑定到数据表格，把页面组件包含的对应属性作为服务端逻辑的输入参数。
+
+   ![image](../assets/rhsySQL_update32.png)
+
+   ![image](../assets/rhsySQL_update34.png)
+3. 定义表格显示内容，并绑定对应数据。
+
+   （1）添加表格列。
+
+   ![image](../assets/rhsySQL_update36.png)
+
+   （2）依次给表格列绑定值字段。
+
+   ![image](../assets/rhsySQL_update38.png)
+
+### 2.4 发布预览
+
+在发布预览过程中可能会出现因当前数据的行存储长度太大，超过行数据最大长度限制所导致的报错问题，报错内容如下图：
+
+![image](../assets/rhsySQL_update40.png)
+
+解决办法：通过调整属性的最大长度来改变行的存储长度，如下图：
+
+![image](../assets/rhsySQL_update42.png)
+
+## 3. 效果演示
+
+![image](../assets/rhsySQL_update44.png)
+
+## 4. 说明
+
+* LIMIT 字段指定初始位置的基本语法格式如下：
+
+  ```
+  SELECT * FROM tableName LIMIT 初始位置，记录数
+  ```
+
+  其中，“初始位置”表示从哪条记录开始显示；“记录数”表示显示记录的条数。第一条记录的位置是 0，第二条记录的位置是 1，后面的记录依次类推。
+
+  注意：LIMIT后的两个参数必须都是正整数。
+* COUNT 聚合函数计算指定参数的记录总数，基本语法格式如下：
+
+  ```
+  SELECT COUNT(指定参数) FROM tableName
+  ```
+
+  其中，“指定参数”可以是表字段名，可以是*（代指全部）。
+
+**特别提示：在发布预览过程中，可能会出现数据表格的数据无法正常展示的情况，可以通过对应发布预览环境的应用数据库检查修改导入的数据内容来解决。**
+
+![image](../assets/rhsySQL_update46.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/40./347/273/204/344/273/266/345/234/272/346/231/257/20./350/241/250/346/240/274/345/234/272/346/231/257/086./345/246/202/344/275/225/350/256/276/347/275/256/350/241/250/346/240/274/345/212/250/346/200/201/345/210/227-1.md

@@ -0,0 +1,175 @@
+# 如何设置表格动态列
+
+## 1. 场景介绍
+
+表格动态列允许根据需求动态配置数据表格中的列。这种功能使得表格可以灵活地适应不断变化的数据展示需求。例如，在企业资源规划应用中，用户可以根据报表需求动态选择显示销售额、成本、利润等列，并隐藏其他列，从而根据特定的业务场景定制化展示数据。
+
+**本案例目标**：
+
+实现数据表格日期列可以根据用户选择的时间范围动态展示，其中动态列标题展示数据为日期，动态列对应行展示数据为该活动在对应日期下的活动时长。
+
+![0](../assets/szbgdtl_20240307_1902_1.gif)
+
+## 2. 前提条件
+
+1. 已有Activity实体信息如下：
+
+   * name：活动名称，String类型。
+   * startTime：活动日期，Date类型。
+   * duration：活动时长，Integer类型。
+
+   <img src="../assets/szbgdtl_20240307_1902_0.png" alt="0" style="border: 1px solid #ccc;" />
+2. 页面已有基础表格和数据。
+
+   ![0](../assets/szbgdtl_20240307_1902_2.png)
+
+## 3. 实现思路
+
+使用数据表格的动态列功能时，通常需要构建特殊的数据源，即使用Map结构对作为表格动态列数据源。其中，使用Map结构作为表格动态列数据源的主要原因是其提供了动态的键值对存储方式，能够按需指定列标识和对应的列配置信息。
+
+* 数据准备：创建DataStructure数据结构，活动名称并建立其与startTime、duration两者的映射关系，
+* 页面设计：基于基础据表格进行改造，删除页面多余元素，保留筛选表单和数据表格，添加活动日期选择等功能。
+* 数据处理：查询并转换数据结构，以确保数据表格绑定数据源后能够快速获取相应表格动态列下的数据。
+* 动态列构建：添加表格列分组，并在其中添加表格动态列，配置动态列数据源。
+* 页面展示：确保动态列能正确展示学生的选修科目及对应分数信息。
+
+## 4. 操作步骤
+
+### 4.1 新建数据结构
+
+为了以活动名称区分表格行，并在动态列中展示当前活动在各活动时间的活动时长，可以自定义如下DataStructure数据结构。该数据结构使用name属性存储活动名称并建立startTime、duration两者的映射关系，用于后续为数据表格构建 `list<name:String,map<startTime:String,duration:Integer>>`结构的数据源。
+
+> 由于键值对数据类型的局限性，以下startTime设为String类型，在实际操作步骤中需完成类型转换。
+
+<img src="../assets/szbgdtl_20240307_1902_3.png" alt="0" style="border: 1px solid #ccc;" />
+
+### 4.2 重构基础页面
+
+1. 删除页面多余组件。
+
+   数据表格只保留数据表格列序号列和活动名称列、筛选表单只保留活动日期项。
+
+   * 目前页面布局：
+
+     ![0](../assets/szbgdtl_20240307_1902_2.png)
+   * 最终页面布局：
+
+     ![0](../assets/szbgdtl_20240307_1902_5.png)
+
+     <img src="../assets/szbgdtl_20240307_1902_6.png" alt="0" style="border: 1px solid #ccc;" />
+2. 实现日期区间选择功能，并监听选择数据。
+
+   > 监听选择数据是为了能够捕获用户在日期区间选择器中所选取的起始日期和结束日期。这样做是为了在用户进行日期选择后，能够立即获取所选日期的数值，以便在点击“查询”按钮时使用这些日期数据进行数据筛选。
+   >
+
+   1）选中活动日期筛选表单项内日期选择组件，开启“区间选择”功能。
+
+   <img src="../assets/szbgdtl_20240307_1902_7.png" alt="0" style="border: 1px solid #ccc;" />
+
+   2）在页面下添加类型为Date的局部变量startTime和endTime，用于存储日期选择的起始值和结束值。
+
+   <img src="../assets/szbgdtl_20240307_1902_8.png" alt="0" style="border: 1px solid #ccc;" />
+
+### 4.3 重构表格数据源
+
+进入数据表格绑定的服务端逻辑，将原始数据格式转化为能体现映射关系的数据结构的列表后输出。
+
+1. 新建局部变量tableData，无需设置数据类型。用于临时存储查询到的所有活动信息数据。
+2. 将原来逻辑中查询出的数据赋值给局部变量tableData。
+
+   <img src="../assets/szbgdtl_20240307_1902_9.png" alt="0" style="border: 1px solid #ccc;" />
+3. 将查询出的数据转换成能够体现表格动态列的数据结构 `List<DataStructure>`后再输出。
+
+   使用内置函数Transform根据by定义的处理方式对查询出的表格数据的每一项数据进行处理，得到新项，返回新项构成的 `list<name:String,map<startTime:String,duration:Integer>>`类型的数据。其中参数by定义的处理方式为将每一项数据都转换为DataStructure数据结构，需注意在将数据中的startTime字段作为DataStructure数据结构中dataMap中的key时，需先使用内置函数ToString将startTime字段转为String类型。
+
+   <img src="../assets/szbgdtl_20240307_1902_10.png" alt="0" style="border: 1px solid #ccc;" />
+
+   完成重构后，表格的“current”变量格式变化如下：
+
+   ![0](../assets/dtlc1.0_20240416.png)
+
+   此时，由于数据表格数据源数据结构变更导致页面报错，根据提示信息修复问题即可。例如，点击首条报错信息右侧自动修复按钮，系统会自行修复错误引用。
+
+   <img src="../assets/szbgdtl_20240307_1902_12.png" alt="0" style="border: 1px solid #ccc;" />
+
+### 4.4 构建表格动态列
+
+为实现下图红框部分效果，需要添加表格动态列，并完成配置。
+
+![0](../assets/szbgdtl_20240307_1902_13.png)
+
+#### 4.4.1 添加表格动态列
+
+选中数据表格，添加表格动态列。
+
+<img src="../assets/szbgdtl_20240307_1902_14.png" alt="0" style="border: 1px solid #ccc;" />
+
+#### 4.4.2 构建动态列数据源
+
+为实现下图红框部分效果，需要自定义逻辑构建 `List<String>`类型数据作为的数据表格动态展示列数据源。从而实现根据日期选择器的筛选结果动态展示列。
+
+![0](../assets/szbgdtl_20240307_1902_15.png)
+
+1. 在页面下添加类型为的 `List<String>`局部变量dateList，用于在点击查询时获取日期区间列表。在查询按钮的点击事件逻辑下添加局部变量addDate，用于临时存日期区间的中间值。
+
+   <img src="../assets/szbgdtl_20240307_1902_16.png" alt="0" style="border: 1px solid #ccc;" />
+2. 重新编辑查询按钮的点击事件逻辑。在选择日期范围后生成包含日期范围内所有日期的列表。
+
+   1）再点击查询时先清空日期区间列表。
+
+   <img src="../assets/szbgdtl_20240307_1902_17.png" alt="0" style="border: 1px solid #ccc;" />
+
+   2）根据用户选择的起止时间生成日期区间内所有日期的集合。
+
+   1. **初始化变量**：将存储起始日期的局部变量（startTime）值赋值给临时存储日期区间的中间值的局部变量（addDate），以防止变量污染对后续用户操作造成影响。
+   2. **循环遍历**：
+
+      i. 使用 while 循环，条件为临时变量（addDate）小于等于结束日期（endTime）。
+
+      ii. 在每次循环中，将临时变量（addDate）数据类型转换为字符串，并将其添加到日期列表（dateList）中。
+
+      iii. 使用内置函数（AlterDateTime）为临时变量（addDate）增加一天，以便在每次循环中逐步增加日期，直到达到结束日期为止。
+
+   <img src="../assets/szbgdtl_20240307_1902_18.png" alt="0" style="border: 1px solid #ccc;" />
+
+#### 4.4.3 配置动态列
+
+1. 为动态列绑定 `List<String>`类型数据源，数据源即存储日期区间列表的局部变量dateList。
+
+   <img src="../assets/szbgdtl_20240307_1902_19.png" alt="0" style="border: 1px solid #ccc;" />
+2. 为动态列表头文本绑定动态数据**局部变量current.columnItem**。current.columnItem为当前列的对象，即**当前动态列对应的日期**。
+
+   <img src="../assets/szbgdtl_20240307_1902_20.png" alt="0" style="border: 1px solid #ccc;" />
+
+#### 4.4.4 配置动态列对应单元格
+
+为实现下图红框部分，需配置动态列对应单元格的值。
+
+![0](../assets/szbgdtl_20240307_1902_21.png)
+
+在单元格中拖入文本并绑定动态值。
+
+通过映射（Map）函数中的[Get内置函数](../../../20.应用开发/15.逻辑功能实现/50.内置函数使用/25.映射（Map）函数.md)把当前列日期（current.ColumnItem）作为Map中的参数key来匹配参数map（current.item.dataMap）中对应单元格的值，其中参数map即为DataStructure数据结构中startTime、duration两者的映射，如下图所示：
+
+<img src="../assets/szbgdtl_20240307_1902_22.png" alt="0" style="border: 1px solid #ccc;" />
+
+<img src="../assets/szbgdtl_20240307_1902_23.png" alt="0" style="border: 1px solid #ccc;" />
+
+## 4. 效果演示
+
+![0](../assets/szbgdtl_20240307_1902_1.gif)
+
+<style>
+  h4 {
+    font-size: 18px;
+  }
+  h5 {
+    font-size: 16px;
+  }
+</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年04月16日</span>
+</div>