@rezti/dsh-rez-suite 0.1.49 → 0.1.51

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

@@ -0,0 +1,247 @@
+# 逻辑判断公式函数(`AND`, `FALSE`, `IF`, `IFBLANK`, `IFERROR`, `IFS`, `ISBLANK`, `ISERROR`, `ISNULL`, `NOT`, `OR`, `SWITCH`, `TRUE`)
+
+> 用于条件判断、状态标记、错误处理、空值处理等逻辑控制，适用于数据校验、状态显示、条件渲染等场景。
+
+---
+
+## AND - 逻辑与
+
+**表达式**: `AND(逻辑表达式1, [逻辑表达式2, ...])`
+
+**函数说明**: 使用 AND 函数，它是一个逻辑函数，用于确定测试中的所有条件是否均为 TRUE。所有参数的计算结果为 TRUE 时，AND 函数返回 TRUE；只要有一个参数的计算结果为 FALSE，即返回 FALSE。
+
+[警告] **不能使用 && 运算符**：公式系统不支持 JavaScript 的 && 运算符，必须使用 AND() 函数
+
+**参数说明**: 逻辑表达式1：必填， 一个表达式或对包含表达式字段的引用，代表某种逻辑值，即 TRUE 或 FALSE。
+
+**示例**:
+```
+[正例] AND(2>1, 92>100)
+[正例] AND([Each].[状态]="已完成", [Each].[金额]>1000)
+
+[反例] 2>1 && 92>100  // 不支持 &&
+[反例] [状态]="已完成" && [金额]>1000  // 不支持 &&
+[反例] [状态]="已完成" AND [金额]>1000  // AND不能写在条件中间！
+```
+
+---
+
+## FALSE - 假值
+
+**表达式**: `FALSE()`
+
+**函数说明**: 返回逻辑值FALSE。
+
+**参数说明**: FALSE函数语法没有参数
+
+**示例**:
+```
+FALSE() => FALSE
+```
+
+---
+
+## IF - 简单条件
+
+**表达式**: `IF(逻辑表达式, 为 TRUE 时的返回值, [为 FALSE 时的返回值])`
+
+**函数说明**: 当逻辑表达式结果为TRUE时返回一个值，为FALSE时返回一个值。
+
+**参数说明**:
+- 逻辑表达式：一个表达式或对包含表达式字段的引用，代表某种逻辑值，即 TRUE 或 FALSE
+- 为 TRUE 时的返回值：当"逻辑表达式"为 TRUE 时的返回值
+- [为 FALSE 时的返回值]：当"逻辑表达式"为 FALSE 时的返回值
+
+**示例**:
+```
+IF([是否完成]="是",1,2) ，表示如果是否完成等于是，则返回 1, 否则返回 2。
+IF([分数] >= 60, "及格", "不及格")
+IF([金额] > 10000, "大客户", "普通客户")
+IF([分数] >= 90, "优秀", IF([分数] >= 60, "及格", "不及格"))
+```
+
+---
+
+## IFBLANK - 空值判断
+
+**表达式**: `IFBLANK(值, 空值情况的返回值)`
+
+**函数说明**: 检测目标值是否为空，为空则返回第二个参数对应的值，非空则返回值本身
+
+**参数说明**:
+- 值： 必需。 非空时返回的值
+- 空值情况返回的值：值为空返回的值
+
+**示例**:
+```
+IFBLANK([商品名称],"未登记") => 商品名称
+商品名称为空，则返回"未登记"
+IFBLANK([备注], "无备注")
+```
+
+---
+
+## IFERROR - 错误处理
+
+**表达式**: `IFERROR(值, 错误情况的返回值)`
+
+**函数说明**: 检查目标值是否错误，如果错误，则返回指定的值；否则返回值的结果。 使用IFERROR函数可捕获和处理公式中的错误。
+
+**参数说明**:
+- 值：必需。检查是否存在错误的参数
+- 错误情况的返回值：必需。公式的计算结果错误时返回的值
+
+**示例**:
+```
+IFERROR([总价]/[数量],"计算中有错误") => "计算中有错误"
+IFERROR([金额] / [数量], 0)
+```
+
+---
+
+## IFS - 多条件判断
+
+**表达式**: `IFS(条件1, 值1, [条件2, ...], [值2, ...])`
+
+**函数说明**: 判断是否满足一个或多个条件并返回第一个 TRUE 条件对应的结果。适合多个条件判断，比嵌套IF()可读性更好
+
+**参数说明**:
+- 条件1:判断的第一个条件
+- 值1:条件1结果为TRUE时返回的值
+- 条件2:条件1结果为FALSE时，继续判断的条件
+- 值2:条件2结果为TRUE时返回的值
+
+**示例**:
+```
+IFS([分数]>=80,"优秀",[分数]>=70,"良好",[分数]>=60,"及格",TRUE,"不及格")
+IFS([分数] >= 90, "优秀", [分数] >= 70, "良好", [分数] >= 60, "及格", TRUE, "不及格")
+```
+
+---
+
+## ISBLANK - 空值判断
+
+**表达式**: `ISBLANK(值)`
+
+**函数说明**: 检测参数值是否为空，为空则返回逻辑值 TRUE；否则，返回 FALSE。
+
+**参数说明**: 值： 必需，检测值是否为空的字段
+
+**示例**:
+```
+ISBLANK([名称]) => TRUE
+ISBLANK("")=>TRUE
+IF(ISBLANK([手机号]), "未填写", "已填写")
+```
+
+---
+
+## ISERROR - 错误判断
+
+**表达式**: `ISERROR(值)`
+
+**函数说明**: 检测参数值是否为错误值，错误值则返回逻辑值 TRUE；否则，返回 FALSE。
+
+**参数说明**: 值： 必需，检测值是否为错误的字段
+
+**示例**:
+```
+ISERROR(2/0) => TRUE
+IF(ISERROR([金额] / [数量]), "计算错误", [金额] / [数量])
+```
+
+---
+
+## ISNULL - 空值判断
+
+**表达式**: `ISNULL(值)`
+
+**函数说明**: 检测参数值内容是否为空，为空则返回逻辑值 TRUE；否则，返回 FALSE。空字符串不为空
+
+**参数说明**: 值： 必需，检测值是否为空的字段
+
+**示例**:
+```
+// 页面上
+ISNULL([数据表.文本]) => FALSE   // 该字段有记录且非空
+ISNULL([页面.输入框]) => FALSE  // 控件有值
+
+// 当前行
+ISNULL([文本]) => TRUE             // 当前行该字段为空
+ISNULL("") => FALSE              // 空字符串 "" 在 ISNULL 语义下不视为空（与 ISBLANK 不同）
+```
+
+> ISNULL 与 ISBLANK 区别：ISBLANK 认为 `""` 是空，返回 TRUE；ISNULL 不认为 `""` 是空，返回 FALSE。
+
+---
+
+## NOT - 逻辑非
+
+**表达式**: `NOT(逻辑表达式)`
+
+**函数说明**: 对参数的逻辑值取反。如果逻辑为 FALSE，NOT 将返回 TRUE；如果逻辑为 TRUE，NOT 将返回 FALSE。
+
+**参数说明**: 逻辑表达式：必需，计算结果为 TRUE 或 FALSE 的任何值或表达式
+
+**示例**:
+```
+NOT(92>100) => TRUE
+NOT([已完成])
+```
+
+---
+
+## OR - 逻辑或
+
+**表达式**: `OR(逻辑表达式1, [逻辑表达式2, ...])`
+
+**函数说明**: 使用 OR 函数，它是一个逻辑函数，用于确定测试中的所有条件是否均为 FALSE。所有参数的计算结果为 FALSE 时，OR 函数返回 FALSE；只要有一个参数的计算结果为 TRUE，即返回 TRUE。
+
+[警告] **不能使用 || 运算符**：公式系统不支持 JavaScript 的 || 运算符，必须使用 OR() 函数
+
+**参数说明**: 逻辑表达式1：必填，一个表达式或对包含表达式字段的引用，代表某种逻辑值，即 TRUE 或 FALSE。
+
+**示例**:
+```
+[正例] OR(2>1, 92<100)
+[正例] OR([状态]="高优先级", [状态]="紧急")
+
+[反例] 2>1 || 92<100  // 不支持 ||
+[反例] [状态]="高优先级" || [状态]="紧急"  // 不支持 ||
+```
+
+---
+
+## SWITCH - 条件匹配
+
+**表达式**: `SWITCH(表达式, 值1, 结果1, [值2, ...], [结果2, ...])`
+
+**函数说明**: 通过和表达式结果比较，按照匹配结果返回对应的值，如果不匹配，则返回可选默认值
+
+**参数说明**:
+- 表达式：输出结果的值，可以是一个字段
+- 值1:和表达式结果进行匹配的值
+- 结果1:值1和表达式结果匹配后返回的值
+- 值2:值1和表达式结果不匹配的时候，则和值2 进行匹配
+
+**示例**:
+```
+SWITCH([日期],1,"周日",2,"周一","不匹配") => 周一 //如果WEEKDAY([日期])的结果为1，则返回周日，结果等于2则返回周一，否则返回"不匹配"。
+SWITCH([状态], "1", "待处理", "2", "进行中", "3", "已完成", "未知")
+```
+
+---
+
+## TRUE - 真值
+
+**表达式**: `TRUE()`
+
+**函数说明**: 返回逻辑值TRUE。
+
+**参数说明**: TRUE函数语法没有参数
+
+**示例**:
+```
+TRUE() => TRUE
+IF([已完成] = TRUE, "完成", "进行中")
+```

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

@@ -0,0 +1,362 @@
+# 公式数学计算函数 - ABS, AVERAGE, CEILING, COUNT, COUNTA, COUNTIF, EXP, FLOOR, INT, LOG, MAX, MIN, POWER, RAND, ROUND, ROUNDUP, SQRT, SUM, SUMIF, VALUE
+
+> 用于数值计算、统计汇总、平均值、最大最小值、四舍五入等数学运算，适用于金额计算、统计分析、数据汇总等场景。
+
+---
+
+## 基本运算
+
+[字段A] + [字段B]      加法
+[字段A] - [字段B]      减法
+[字段A] * [字段B]      乘法
+[字段A] / [字段B]      除法
+
+**示例**：
+
+[单价] * [数量]                 计算总价
+([收入] - [支出]) / [收入]      计算利润率
+
+---
+
+## ABS - 绝对值
+
+**表达式**: `ABS(数值)`
+
+**函数说明**: 返回数值的绝对值。
+
+**参数说明**: 数值：必需， 需要计算其绝对值的数值。
+
+**示例**:
+```
+ABS(-2) => 2
+ABS([实际值] - [目标值])     计算偏差的绝对值
+```
+
+---
+
+## AVERAGE - 平均值
+
+**表达式**: `AVERAGE(值1, [值2, ...])`
+
+**函数说明**: 计算一组值的平均值。
+
+**参数说明**: 数值1：数值1是必需的，后续数值是可选的，要从中查找平均值。
+
+**示例**:
+```
+AVERAGE(2,3,3,5,7,10) => 5
+[成绩表.分数].AVERAGE()
+```
+
+---
+
+## CEILING - 向上舍入
+
+**表达式**: `CEILING(数值, 舍入基数)`
+
+**函数说明**: 返回将参数值向上舍入（沿绝对值增大的方向）为最接近的指定舍入基数的倍数。
+
+**参数说明**:
+- 数值：必需，要舍入的值
+- 舍入基数：用于向上舍入的基数
+
+**示例**:
+```
+// 将金额向上取整到百位
+CEILING([金额], 100)
+```
+
+---
+
+## COUNT - 数字计数
+
+**表达式**: `COUNT(值1,[值2,...])`
+
+**函数说明**: 统计数据集中数字的个数
+
+**参数说明**: 值1：必需，要计算其中数字的个数的第一项，可以是列或参数列表。值2：可选，要计算其中数字的个数的其他项，可以是列或参数列表，最多可包含 255 个。
+
+**示例**:
+```
+COUNT(1, "智能表格") => 1
+COUNT(1,2) => 2
+[订单表.金额].COUNT()       // 统计有效金额数量
+```
+
+---
+
+## COUNTA - 非空计数
+
+**表达式**: `COUNTA(值1, [值2, ...])`
+
+**函数说明**: 统计数据集中非空元素的个数
+
+**参数说明**: 值:可以是多个值，也可以是数据表.字段，也可以是多个字段
+
+**示例**:
+```
+[项目管理].[项目名称].COUNTA() => 项目数 //统计 [项目名称] 整列里面项目名称非空的个数
+[多选].COUNTA() => 选项个数 //统计 [多选] 每个记录里面选项个数
+LIST(1,2,"智",).COUNTA() => 3 //统计列表 [1,2,"智"] 里面非空元素个数
+[任务表.任务名称].COUNTA()  // 统计任务总数
+```
+
+---
+
+## COUNTIF - 条件计数
+
+**表达式**: `数据范围.COUNTIF(筛选条件)`
+
+**函数说明**: 计算列表中符合筛选条件的元素个数
+
+**参数说明**:
+- 数据范围：参与条件筛选的范围
+- 筛选条件：取数据范围的值进行条件筛选，返回符合筛选条件的值
+
+**示例**:
+```
+[项目管理].COUNTIF([Each].[项目状态]="已完成")=> 已完成的记录数  //统计已完成下的项目数
+LIST(1,2,3,4).COUNTIF([Each]>2)  =>  2 //列表中大于2的元素个数
+[订单表.状态].COUNTIF("已完成")
+```
+
+---
+
+## EXP - 自然指数
+
+**表达式**: `EXP(数值)`
+
+**函数说明**: 返回 e 的 n 次幂。 常数 e 约等于 2.71828182845904，是自然对数的底数。EXP 是计算自然对数的 LN 的反函数。
+
+**参数说明**: 数值：必需，底数 e 的指数
+
+**示例**:
+```
+EXP(2) => 7.3890561
+```
+
+---
+
+## FLOOR - 向下舍入
+
+**表达式**: `FLOOR(数值, 舍入基数)`
+
+**函数说明**: 返回将参数值向下舍入（沿绝对值减小的方向）为最接近的指定舍入基数的倍数。
+
+**参数说明**:
+- 数值：必需，要舍入的值
+- 舍入基数：用于向下舍入的基数
+
+**示例**:
+```
+// 产品价格为 ￥4.42 时，使用公式FLOOR将价格向下舍入到最接近的 5 分钱。
+FLOOR(4.42,0.05) 
+```
+
+---
+
+## INT - 向下取整
+
+**表达式**: `INT(数值)`
+
+**函数说明**: 将数值向下舍入到最接近的整数。
+
+**参数说明**: 数值：必需，需要进行向下舍入取整的实数
+
+**示例**:
+```
+INT(8.9) => 8
+INT([数值])
+```
+
+---
+
+## LOG - 对数
+
+**表达式**: `LOG(数值, 底数)`
+
+**函数说明**: 根据指定底数返回数值的对数。
+
+**参数说明**:
+- 数值：必需，想要计算其对数的正实数
+- 底数：可选，对数的底数。 如果省略底数，则假定其值为 10
+
+**示例**:
+```
+LOG(8, 2) => 3
+LOG(100, 10)  // 2
+```
+
+---
+
+## MAX - 最大值
+
+**表达式**: `MAX(值1, [值2, ...])`
+
+**函数说明**: 返回一组值中的最大值。
+
+**参数说明**: 数值1：数值1是必需的，后续数值是可选的，要从中查找最大值
+
+**示例**:
+```
+MAX(10,7,9,27,2) => 27
+[销售表.销售额].MAX() // 最高销售额
+```
+
+---
+
+## MIN - 最小值
+
+**表达式**: `MIN(值1, [值2, ...])`
+
+**函数说明**: 返回一组值中的最小值。
+
+**参数说明**: 数值1：数值1是必需的，后续数值是可选的，要从中查找最小值
+
+**示例**:
+```
+MIN(10,7,9,27,2) => 2
+[库存表.数量].MIN()   // 最低库存
+```
+
+---
+
+## POWER - 幂运算
+
+**表达式**: `POWER(基数, 指数)`
+
+**函数说明**: 返回数值乘幂的结果。若要对数值进行幂运算，请使用 POWER 函数。
+
+**参数说明**:
+- 数值：必需，基数可为任意实数
+- 指数：必需， 基数乘幂运算的指数
+
+**示例**:
+```
+POWER(5,2) => 25
+POWER(2, 8)   // 256
+```
+
+---
+
+## RAND - 随机数
+
+**表达式**: `RAND()`
+
+**函数说明**: 返回一个大于等于 0 且小于 1 的平均分布的随机数
+
+**参数说明**: RAND函数语法没有参数
+
+**示例**:
+```
+RAND() => 0.834763
+(RAND() * 100).INT() => 66
+```
+
+---
+
+## ROUND - 四舍五入
+
+**表达式**: `ROUND(数值, 位数)`
+
+**函数说明**: 将数值四舍五入到指定的位数。
+
+**参数说明**:
+- 数值：必需，要四舍五入的数值
+- 位数：整数，必需。 要进行四舍五入运算的位数。如果位数大于0，则将数值四舍五入到指定的小数位数。如果位数等于0，则将数值四舍五入到最接近的整数。如果位数小于0，则将数值四舍五入到小数点左边的相应位数
+
+**示例**:
+```
+ROUND(23.7825, 2) => 23.78
+ROUND([金额] / [数量], 2)     保留2位小数
+```
+
+---
+
+## ROUNDUP - 向上舍入
+
+**表达式**: `ROUNDUP(数值,位数)`
+
+**函数说明**: 将数值朝着远离 0（零）的方向，按指定位数进行向上舍入
+
+**参数说明**:
+- 数值：必需，要舍入的值
+- 位数：代表舍入的位数，大于0（代表小数点右边舍入的位数），等于0（代表舍入为整数），小于0（代表小数点左边舍入的位数）
+
+**示例**:
+```
+ROUNDUP(3.2,0) => 4 // 3.2取整就是4
+ROUNDUP(3.24,1) => 3.3 // 3.24向上舍入为1个小数位就是3.3
+ROUNDUP(13.2,-1) => 20 //13.2 向小数点左边舍入一位，就是20
+```
+
+---
+
+## SQRT - 平方根
+
+**表达式**: `SQRT(数值)`
+
+**函数说明**: 返回正的平方根。
+
+**参数说明**: 数值：必需，要计算其平方根的数值。如果 数值为负数，则 SQRT 返回#NUM！ 错误值
+
+**示例**:
+```
+SQRT(16) => 4
+SQRT([面积])
+```
+
+---
+
+## SUM - 求和
+
+**表达式**: `SUM(值1, [值2, ...])`
+
+**函数说明**: SUM函数将值相加。 你可以将多个值或是列的单元格相加，或者将二者的组合相加。注意：SUM是进行多列（3列及以上）求和的标准做法，优先使用 SUM([字段A], [字段B], [字段C], ...) 替代 [字段A]+[字段B]+[字段C] + ...。
+
+**参数说明**: 数值1：数值1是必需的，后续数值是可选的
+
+**示例**:
+```
+// 计算数值和
+SUM(1,1) => 2
+// 计算金额列之和
+[销售表.金额].SUM()
+// 计算当前记录的多个字段之和
+SUM([字段A], [字段B], [字段C])
+```
+
+---
+
+## SUMIF - 条件求和
+
+**表达式**: `数据范围.SUMIF(筛选条件)`
+
+**函数说明**: 对列表中符合筛选条件的元素进行求和
+
+**参数说明**:
+- 数据范围：参与条件筛选的范围
+- 筛选条件：取数据范围的值进行条件筛选，返回符合筛选条件的值
+
+**示例**:
+```
+[商品销售表.销售额].SUMIF([Each]>1000)=> 销售额数值  //统计销售额大于1000的销售总和
+LIST(1,2,3,4).SUMIF([Each]>2)  => 7 //对列表中大于2的元素求和
+[销售表.金额].SUMIF([销售表.状态], "已完成")
+```
+
+---
+
+## VALUE - 文本转数字
+
+**表达式**: `VALUE(文本)`
+
+**函数说明**: 将表示数值的文本字符串转换为数值。
+
+**参数说明**: 文本：必需， 用引号括起来的文本或包含要转换文本的列的单元格
+
+**示例**:
+```
+VALUE("1,000") => 1000
+VALUE("123")
+```