Pinvou/pinvou-agent / pinvou3-app/src-tauri/resources/common/bundle/wecom-skills/wecomcli-smartpage
wecomcli-smartpage
Verified何时用:企业微信智能文档/智能主页/smartpage 相关诉求(含 doc.weixin.qq.com/smartpage/ 或 page.weixin.qq.com/smartpage/ 链接),或泛指「创建/写/整理文档」的企微诉求时使用;纯本地文档默认走本地工具。能力:新建/导入(.md)、读取、修改内容(整页重写/局部编辑/增删子页面)、上传附件、搭建带看板/图表的数据系统页面与信息收集表单、获取内置智能表格。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 13.5 KB |
| references/data-driven-pages.md | markdown | 4.1 KB |
| references/formula-reference.md | markdown | 6.9 KB |
| references/formula/arraylist.md | markdown | 10.7 KB |
| references/formula/datetime.md | markdown | 7.5 KB |
| references/formula/logic.md | markdown | 7.3 KB |
| references/formula/math.md | markdown | 8.5 KB |
| references/formula/operators.md | markdown | 4.8 KB |
| references/formula/pageblock.md | markdown | 3.4 KB |
| references/formula/templates.md | markdown | 11.9 KB |
| references/formula/text.md | markdown | 9.3 KB |
| references/formula/user.md | markdown | 607 B |
| references/mdx-syntax.md | markdown | 27.4 KB |
| references/smartpage-edit.md | markdown | 28.8 KB |
references/formula/logic.md
View on GitHub# 逻辑判断公式函数(`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, "完成", "进行中")
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |