1. 概述
1.1 版本
FineDataLink 版本 | 功能变动 |
---|---|
4.1.1 | 统一产品内条件判断逻辑 |
4.1.5.5 | 「文件传输」使用该条件判断说明 |
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 集合中,则返回该数据(值为 null、值为空的数据不在返回结果中);否则,返回值为空 | ||
不属于 详情请参见:「包含」和「属于」的区别 | 无限制 | 空 | |
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 |