@rezti/dsh-rez-suite 0.1.49 → 0.1.51

package/templates/shared/wecomcli-smartpage/references/formula/operators.md

@@ -0,0 +1,246 @@
+# 公式运算符 - =, !=, <>, ==, !==, >, >=, <, <=, +, -, *, /, ^, &
+
+> 用于数值比较、文本拼接、四则运算等基础表达式构建，适用于条件筛选、数值计算、文本连接等场景。
+
+---
+
+## = - 等于
+
+**表达式**: `=`
+
+**函数说明**: 等于
+
+**参数说明**: 两个内容进行比较，比较内容是否相等，和顺序、格式等无关。
+
+**示例**:
+```
+1 = "01" =>  TRUE  // 文本字段的1和数字字段1是相等的
+[1,2]=[2,1]    =>  TRUE  // 列表内容一致就是相等的
+```
+
+---
+
+## != - 不等于
+
+**表达式**: `!=`
+
+**函数说明**: 不等于
+
+**参数说明**: 两个内容进行比较，比较内容是否不相等，和顺序、格式等无关。
+
+**示例**:
+```
+1 !=2     =>  TRUE
+[1,2,3] != [1,2]   =>  TRUE
+```
+
+---
+
+## <> - 不等于
+
+**表达式**: `<>`
+
+**函数说明**: 不等于
+
+**参数说明**: 两个内容进行比较，比较内容是否不相等，和顺序、格式等无关。
+
+**示例**:
+```
+1 <> 2     =>  TRUE
+[1,2,3] <> [1,2]   =>  TRUE
+```
+
+---
+
+## == - 严格相等
+
+**表达式**: `==`
+
+**函数说明**: 严格相等
+
+**参数说明**: 两个内容进行比较，比较内容、顺序、格式是否都一致。
+
+**示例**:
+```
+1=="1" => FALSE
+[1,2]==[2,1] => FALSE
+```
+
+---
+
+## !== - 严格不相等
+
+**表达式**: `!==`
+
+**函数说明**: 严格不相等
+
+**参数说明**: 两个内容进行比较，比较内容、顺序、格式是否都一致。
+
+**示例**:
+```
+1!=="1" => TRUE
+[1,2] !== [2,1] => TRUE
+```
+
+---
+
+## > - 大于
+
+**表达式**: `>`
+
+**函数说明**: 大于
+
+**参数说明**: 主要是数值类的大小比较
+
+**示例**:
+```
+3>1  =>  TRUE
+DATE(2026,5,22)>DATE(2026,5,10)  =>  TRUE
+[项目计划完成日期]>[项目实际完成日期]   =>  TRUE  // 判断项目是否按计划日期完工；结果为 TRUE 代表提前完成，否则代表延后。
+```
+
+---
+
+## >= - 大于等于
+
+**表达式**: `>=`
+
+**函数说明**: 大于等于
+
+**参数说明**: 主要是数值类的大小比较
+
+**示例**:
+```
+2>=2  =>  TRUE
+DATE(2026,5,22)>=DATE(2026,5,22)  =>  TRUE
+[项目计划完成日期]>=[项目实际完成日期]   =>  TRUE  // 判断项目是否按计划完工；结果为 TRUE 代表提前或准时完成，否则代表延后。
+```
+
+---
+
+## < - 小于
+
+**表达式**: `<`
+
+**函数说明**: 小于
+
+**参数说明**: 主要是数值类的大小比较
+
+**示例**:
+```
+1< 3 =>  TRUE
+DATE(2026,5,12)<DATE(2026,5,22)  =>  TRUE
+[项目实际完成日期]<[项目计划完成日期]   =>  TRUE  // 判断项目是否按计划日期完工；结果为 TRUE 代表项目提前完成，否则代表延后。
+```
+
+---
+
+## <= - 小于等于
+
+**表达式**: `<=`
+
+**函数说明**: 小于等于
+
+**参数说明**: 主要是数值类的大小比较
+
+**示例**:
+```
+2<=2 =>  TRUE
+DATE(2026,5,22)<=DATE(2026,5,22)  =>  TRUE
+[项目实际完成日期]<=[项目计划完成日期]   =>  TRUE  // 判断项目是否按计划日期完工；结果为 TRUE 代表项目提前或准时完成，否则代表延后。
+```
+
+---
+
+## + - 加法
+
+**表达式**: `+`
+
+**函数说明**: 两个数值相加
+
+**参数说明**: 左右两边相加的参数需要是数值型字段，比如数字、日期、进度；如果不是数值型字段会尝试转换为数值后参与计算。注意：+ 用于两个字段的简单相加。如果是多个字段求和，优先使用 SUM 函数。
+
+**示例**:
+```
+"2"+1=> 3
+[门店线上收入]+[门店线下收入]=> 总收入
+```
+
+---
+
+## - - 减法
+
+**表达式**: `-`
+
+**函数说明**: 两个数值相减
+
+**参数说明**: 左右两边相减的参数需要是数值型字段，比如数字、日期、进度；如果不是数值型字段会尝试转换为数值后参与计算。
+
+**示例**:
+```
+3-1=> 2
+[销售额]-[成本] => [利润]
+```
+
+---
+
+## * - 乘法
+
+**表达式**: `*`
+
+**函数说明**: 两个数值相乘
+
+**参数说明**: 左右两边相乘的参数需要是数值型字段，比如数字、日期、进度；如果不是数值型字段会尝试转换为数值后参与计算。
+
+**示例**:
+```
+3*2=> 6
+[订单量]*[商品单价]=> 销售额 //计算当个商品的销售额
+```
+
+---
+
+## / - 除法
+
+**表达式**: `/`
+
+**函数说明**: 两个数值相除
+
+**参数说明**: 左右两边相除的参数需要是数值型字段，且被除数不能为0，比如数字、日期、进度；如果不是数值型字段会尝试转换为数值后参与计算。
+
+**示例**:
+```
+6/2=> 3
+[销售额]/[目标额]=> 销售进度
+```
+
+---
+
+## ^ - 求幂
+
+**表达式**: `^`
+
+**函数说明**: 求幂
+
+**参数说明**: 计算数字的求幂结果
+
+**示例**:
+```
+2^2=> 4
+```
+
+---
+
+## & - 文本拼接
+
+**表达式**: `&`
+
+**函数说明**: 将两个文本进行拼接
+
+**参数说明**: 将两个文本内容进行拼接，返回合并内容后的结果。
+
+**示例**:
+```
+"智能" &"表格"  =>  智能表格
+[项目名称]&[项目时间] => 项目名称2026年5月22日
+```

package/templates/shared/wecomcli-smartpage/references/formula/pageblock.md

@@ -0,0 +1,76 @@
+# 页面控件专用公式函数
+
+> 用于在页面中打开外部链接或跳转其他页面，适用于超链接按钮、表单提交跳转、通过点击按钮跳转页面、修改数据库记录等场景。
+
+---
+
+## OPENLINK - 打开链接
+
+OPENLINK(链接地址, [打开方式])
+
+在页面控件中打开指定的链接。
+
+**示例**：
+
+// 打开外部链接
+OPENLINK("https://www.example.com")
+
+
+### 特殊用法 - 文档内页面互相跳转
+
+当你知道当前 URL 时（currentUrl），你可以通过修改/拼接 `p=<page_id>` 参数，来跳转到 `<page_id>` 对应的页面。
+
+// 假设 currentUrl="https://doc.weixin.qq.com/smartpage/<docid>?p=<current_page_id>"
+
+// 假设你想跳转到 page_id 为 <new_page_id> 的页面
+OPENLINK("https://doc.weixin.qq.com/smartpage/<docid>?p=<new_page_id>")
+
+---
+
+## ADDRECORD - 对指定表添加一行记录
+
+ADDRECORD(数据表,[字段1,值1,字段2,值2...])
+
+**参数说明**:
+- 数据表: 必填。表和视图，智能主页文档内的工作表和视图和图表
+- 字段: 数据表或视图（包括图表）下的字段
+- 值: 需要填入的字段值。不同字段类型，输入的格式不同
+
+**示例**：
+
+// 项目管理表新增一行记录
+ADDRECORD([项目管理表])
+
+// 项目管理表新增一行项目状态为"未开始"的记录
+ADDRECORD([项目管理表],[项目状态],"未开始")
+
+---
+
+## MODIFYRECORDS - 根据查询条件，修改数据表中某条/某些记录的值
+
+场景：用于条件/非条件方式修改数据表中字段值。通过查询语句动态指定范围
+
+MODIFYRECORDS(目标记录集, 字段1, 值1, [字段2, 值2...])
+- 目标记录集：支持指定单条记录（如 [表].FIRST()），也**完全支持**通过 FILTER 函数动态查询出的多条记录集合（如 [表].FILTER(条件)）。
+
+示例 1:
+// 将项目管理表首行记录的项目状态改为已完成
+MODIFYRECORDS([项目管理表].FIRST(),[项目管理表.项目状态],"已完成")
+
+示例 2：动态查询并修改
+// 将项目管理表中状态为“未开始”的所有项目改为“已完成”
+MODIFYRECORDS([项目管理表].FILTER([Each].[项目状态]="未开始"),[项目管理表.项目状态],"已完成")
+
+// 将项目管理表中名为“张三”的人的*所有*项目状态都改为“已完成”
+MODIFYRECORDS([项目管理表].FILTER([Each].[人名]="张三"),[项目管理表.项目状态],"已完成")
+// 将项目管理表中名为“张三”的人的*第一个*项目状态改为“已完成”
+MODIFYRECORDS([项目管理表].FILTER([Each].[人名]="张三").FIRST(),[项目管理表.项目状态],"已完成")
+
+// 与页面绑定。设计有个输入框title为项目状态输入框
+MODIFYRECORDS([项目管理表].FILTER([Each].[项目状态]=[页面1.项目状态输入框]),[项目管理表.项目状态],"已完成")
+
+示例 3: 更复杂的示例，与条件语句组合，实现“有则修改，无则添加”
+// 学生信息表中如果有学生姓名为 小妹 的，则把小孩数改成 50，否则插入一条。
+IF([学生信息].FILTER([Each].[学生名称]="小妹").COUNTA()>0,MODIFYRECORDS([学生信息].FILTER([Each].[学生名称]="小妹"),[学生信息.小孩数],50),ADDRECORD([学生信息],[学生信息.学生名称],"小妹",[学生信息.小孩数],50))
+
+> MODIFYRECORDS 结合 FILTER 是实现“查找并更新 (Find & Update)”的唯一标准做法，无需写成多步代码，一行公式即可实现查询+修改。