1. 概述
1.1 版本
| FineDataLink 版本 | 功能变动 |
|---|---|
| 4.1.1 | 统一产品内条件判断逻辑 |
1.2 功能简介
本文对产品内条件判断逻辑进行说明。包括：
「数据过滤」-添加条件 &「数据分发」-分发条件。
「条件分支」-添加条件 &「循环容器」-执行条件-配置条件。
「简道云输入」-筛选条件。
「MongoDB输入」-条件查询-配置条件。
「文件输入」-文件夹读取-文件筛选。
2. 具体说明
2.1 判断逻辑
4.1.1 及之后版本，产品内条件判断逻辑进行了统一。
具体说明如下表所示：
| 字段类型 | 条件类型 | 配置判断逻辑 | 含义 |
|---|---|---|---|
| 日期 | 介于 | 无限制≤值＜无限制（初始默认值） | 全部，包含null |
| 无限制≤值＜Y | 小于Y，不包含null | ||
| X≤值＜无限制 | 大于等于X | ||
| X≤值＜Y | 大于等于X，小于Y | ||
| 不介于 | 无限制≤值＜无限制 | 空 | |
| 无限制≤值＜Y | 大于等于Y | ||
| X≤值＜无限制 | 小于X，不包含null | ||
| X≤值＜Y | 小于等于X，大于等于Y，不包含null | ||
| 某个日期之前 | 值≤无限制 | 全部，包含null | |
| 值＜X | 小于X，不包含null | ||
| 某个日期之后 | 无限制≤值 | 全部，包含null | |
| X<值 | 大于X，不包含null | ||
| 等于 | 无限制 | 全部，包含null | |
| X | 等于X | ||
| 不等于 | 无限制 | 全部，包含null | |
| X | 不等于X，包含null | ||
| 为空 | - | null值 | |
| 非空 | - | 全部非null值 | |
| 文本 | 属于 | 无限制 | 全部，包含null |
| X | X | ||
| 不属于 | 无限制 | 空 | |
| X | 不含X，包含空字符串和null | ||
| 包含 | 空 | 全部，包含空字符串，不包含null | |
| X | 包含X的字符串，不包含空字符串和null | ||
| 不包含 | 空 | 空 | |
| X | 不包含X的字符串，包含空字符串，不包含null | ||
| 开头是 | 空 | 全部，包含空字符串，不包含null | |
| X | 开头是X的字符串，不包含空字符串和null | ||
| 开头不是 | 空 | 空 | |
| X | 开头不是X的字符串，包含空字符串，不包含null | ||
| 结尾是 | 空 | 全部，包含空字符串，不包含null | |
| X | 结尾是X的字符串，不包含空字符串和null | ||
| 结尾不是 | 空 | 空 | |
| X | 结尾不是X的字符串，包含空字符串，不包含null | ||
| 为空 | - | 空字符串和null | |
| 非空 | - | 全部，不包含空字符串和null | |
| 数值 | 属于 | 无限制 | 全部，包含null |
| X | =X | ||
| X,Y | 等于X或等于Y | ||
| 不属于 | 无限制 | 空 | |
| X | 不等于X，不包含空值和null | ||
| X,Y | 不等于X，且不等于Y，不包含空值和null | ||
| 介于 | 无限制≤值＜无限制 | 全部，包含null | |
| 无限制≤值＜Y | 小于Y，不包含null | ||
| X≤值＜无限制 | 大于等于X | ||
| X≤值＜Y | 大于等于X，小于Y | ||
| 不介于 | 无限制≤值＜无限制 | 空 | |
| 无限制≤值＜Y | 大于等于Y | ||
| X≤值＜无限制 | 小于X，不包含null | ||
| X≤值＜Y | 小于等于X，大于等于Y，不包含null | ||
| 大于 | 无限制 | 全部，包含null | |
| X | 大于X，不包括null | ||
| 小于 | 无限制 | 全部，包含null | |
| X | 小于X，不包括null | ||
| 大于等于 | 无限制 | 全部，包含null | |
| X | 大于等于X，不包括null | ||
| 小于等于 | 无限制 | 全部，包含null | |
| X | 小于等于X，不包括null | ||
| 为空 | - | null值 | |
| 非空 | - | 全部非null值 | |
| 布尔 | 为真 | - | 与数据库中布尔字符完全匹配时过滤出来：true或1 |
| 为假 | - | 与数据库中布尔字符完全匹配时过滤出来：false或0 | |
| 其他 | 等于 | 空 | 空 |
| X | 等于X，不包括null | ||
| 不等于 | 空 | 全部，不包括null | |
| X | 不等于X，不包括null |
不同的功能，支持的条件类型有一定的差异：
注：MongoDB、简道云，做筛选时不会展示不支持的字段类型对应的字段。
| 功能 | 字段类型支持情况 | 条件类型支持情况 |
|---|---|---|
| 「数据过滤」-添加条件 「数据分发」-分发条件 | 均支持 | 均支持 |
| 「条件分支」-添加条件 「循环容器」-执行条件-配置条件 | 不支持：其他 | 均支持 |
| 「文件输入」-文件夹读取-文件筛选 | 支持：
不支持：数值、布尔、其他 | 有限支持： 文本&日期：不支持 为空、非空 |
| 「MongoDB输入」-条件查询-配置条件 | 不支持：其他 | 均支持 |
| 「简道云输入」-筛选条件 | 不支持：布尔、其他 | 有限支持，见下面的列表 |
简道云接口对判断逻辑做了限制，FDL 基于接口提供的方式，提供如下条件类型：
| 字段类型 | 字段类型-英文 | 支持的条件类型 | 说明 |
|---|---|---|---|
| 日期时间 | datetime |
| - |
| 数字 | number |
| - |
| 文本 | text | 包括单行文本、下拉框、单选按钮组、流水号 | |
| 手机 | phone |
| verified表示填写了手机号且已验证的值；unverified表示填写了手机号但未验证值 |
| 流程状态 | flowState | 流程状态，仅对流程表单有效 | |
| 其他表单字段 | others |
| 子表单字段除外 |
2.2 逻辑运算符
「条件分支」、「循环容器」里，会将判断条件转成逻辑运算符显示：
| 产品语言 | 逻辑运算符 |
|---|---|
| 且条件 | && |
| 或条件 | || |
| 等于 | == |
| 不等于 | != |
| 大于 | > |
| 小于 | < |
| 大于等于 | >= |
| 小于等于 | <= |
| 层级嵌套 | () |
示例：判断条件为：参数${test}不等于1或者大于2，转化为逻辑运算表达式为：${test}!=1||${test}>2
3. 升级兼容说明
旧版本升级到 4.1.1 及之后版本后，升级后的条件类型说明如下：
1）「数据过滤」-添加条件 &「数据分发」-分发条件；「条件分支」-添加条件 &「循环容器」-执行条件-配置条件
| 类型 | 升级前-条件类型 | 升级前-过滤值 | 升级后-条件类型 | 升级后-过滤值 |
|---|---|---|---|---|
| 日期 | 介于 | X-Y | 介于 | X<值<Y |
| 不介于 | X-Y | 不介于 | X<值<Y | |
| 某个日期之前 | X | 某个日期之前 | 值<X | |
| 某个日期之后 | X | 某个日期之后 | X<值 | |
| 布尔 | 等于 | 1\true | 为真 | |
| 0\false | 为假 | |||
| 其他值，包括参数 | 为真 | |||
| 不等于 | 1\true | 为真 | ||
| 0\false | 为假 | |||
| 其他值，包括参数 | 为真 |
2）「MongoDB输入」-条件查询-配置条件
| 类型 | 升级前-条件类型 | 升级前-过滤值 | 升级后-条件类型 | 升级后-过滤值 |
|---|---|---|---|---|
| 数字 | 等于 | X | 属于 | X |
| 不等于 | X | 不属于 | X | |
| 范围 | X-Y | 介于 | X<值<Y | |
| 不为空 | 非空 | |||
| 日期 | 范围 | X-Y | 介于 | X<值<Y |
| 不为空 | 非空 | |||
定义日期的值环节：
| ||||
| 字符串 | 等于 | X | 属于 | X |
| 不等于 | X | 不属于 | X | |
| 等于任意一个 | X,Y,Z | 属于 | X,Y,Z | |
| 不等于任意一个 | X,Y,Z | 不属于 | X,Y,Z | |
| 不为空 | 非空 | |||
3）「简道云输入」-筛选条件
| 类型 | 升级前-条件类型 | 升级前-过滤值 | 升级后-条件类型 | 升级后-过滤值 |
|---|---|---|---|---|
| 日期 | 范围 | X-Y | 介于 | X≤值≤Y |
| 数字 | 范围 | X-Y | 介于 | X≤值≤Y |
| 文本 | 等于任意一个 | X,Y,Z | 属于 | X,Y,Z |
| 不等于任意一个 | X,Y,Z | 不属于 | X,Y,Z |
