1. 概述
1.1 版本
FineBI 版本 |
|---|
| 5.1 |
1.2 功能介绍
本文将详细介绍设置定时调度任务过程中，可以使用的公式及其用法。
注1：定时调度任务中，无法触发报表的 JS 事件。
注2：「调度对象」步骤中对象类型为报表模板和无调度对象时，可使用的公式及用法可参考 定时调度支持的公式 。
注3：定时调度任务中，公式的长度过长、公式解析后的收件人长度过长、公式解析后的主题过长等情况，都有可能导致定时调度任务执行失败。
2. BI 模板
注：下表所示的函数不能用于取单元格值，即单元格值不能作为参数在 BI 模板中使用。
| 类型 | 公式/参数/函数 | 使用位置 | 备注 |
|---|---|---|---|
| 参数 | 用户全局参数： ${fine_username} ${fine_position} ${fine_role} ${fr_username} ${fr_userposition} ${fr_authority} | 定时调度任务设置过程中不能使用 | 添加 SQL 数据集时可以使用用户全局参数 |
| 常用函数 | SUM、COUNT、AVERAGE、CHAR、DATE、MAX、MIN、TIME、RANGE | 调度对象-文件名称 调度周期-执行条件-公式判断 文件处理-邮件通知-主题和内容 文件处理-客户端通知-主题和内容 | 在「调度周期-执行条件-公式判断」中不要加${}，其他情况要加${} 例如AND(1+7=8,5+7=12)，在定时调度中应该写为${AND(1+7=8,5+7=12)}，不要加=号 |
| 数学和三角函数 | ABS、ACOS、ACOSH、ASIN、ASINH、ATAN、ATAN2、AVERAGE、CEILING、COMBIN、COS、SOSH、COUNT、DECIMAL、DEGREES、EVEN、EXP、FACT、FLOOR、INT、LN、LOG、LOG10、MAX、MIN、MOS、ODD、PI、POWER、PRODUCT、PROMOTION、RADIANS、RAND、RANDBETWEEN、ROUND、ROUND5、ROUNDDOWN、ROUNDUP、SIGN、SIN、SINH、SQRT、SUM、SUMPRECISE、SUMSQ、TAN、TANH、TOBINARY、TOHEX、TOOCTAL、TRUNC、WEIGHTEDAVERAGE | ||
| 文本函数 | CHAR、CNMONEY、CODE、CONCATENATE、ENDWITH、ENMONEY、ENNUMBER、EXACT、FIND、FORMAT、INDEXOF、LEFT、LEN、LOWER、MIN、NUMTO、PROPER、REGEXP、REPEAT、REPLACE、RIGHT、SPLIT、STARTWITH、SUBSTITUTE、TODOUBLE、TOINTEGER、TRIM、UPPER | ||
| 日期和时间函数 | DATE、DATEDELTA、DATEDIF、DATEINMONTH、DATEINQUARTER、DATEINWEEK、DATEINYEAR、DATESUBDATE、DATETONUMBER、DAY、DAYS360、DAYSOFMONTH、DAYSOFQUARTER、DAYSOFYEAR、DAYVALUE、ENDOFMONTH、HOUR、ISWORKDAY、LUNAR、MINUTE、MONTH、MONTHDELTA、NOW、SECOND、TIME、TODATE、TODAY、WEEK、WEEKDATE、WEEKDAY、YEAR、YEARDELTA | ||
| 逻辑函数 | AND、BITNOT、BITOPERATION、IF、OR、REVERSE、SWITCH | ||
| 报表函数 | COL、DECODE、ENCODE、I18N、ROW、COLCOUNT、COLNAME、FIELDS、MAP、RECORDS、ROWCOUNT、SQL、TABLEDATAFIELDS、TABLEDATAS、TABLES、VALUE | 调度对象-文件名称 调度周期-执行条件-公式判断 文件处理-邮件通知-主题和内容 文件处理-客户端通知-主题和内容 | 1）COL和ROW写在单元格中，在定时调度中虽然不会报错，但是没有意义，返回值为常数 0 。 COL() 返回当前单元格的列号。 例如，若当前单元格是 A5 ，在 A5 中写入：=col()，返回 1 ；若当前单元格是 C6 ，在 A5 中写入：=col()，返回 3 2）COLCOUNT、COLNAME、MAP、ROWCOUNT、TABLEDATAFIELDS、VALUE这些函数的参数中包括有数据集，在定时调度中，可以获取服务器数据集 |
| 其他函数 | WEBIMAGE、CLASS、CORREL、EVAL、INDEX、ISNULL、LET、MEDIAN、NVL、QUERY、RANK、SEQ、UUID、LUNAR | 调度对象-文件名称 调度周期-执行条件-公式判断 文件处理-邮件通知-主题和内容 文件处理-客户端通知-主题和内容 | 1）SEQ虽然被执行，但永远只有一次，所以值一直，没有意义 2）WEBIMAGE用来显示网页上的图片，在定时调度中返回com.fr.file.WebImage@23dd10da类似格式 |
| 自定义函数 | UBM、SUBSECTION | 调度对象-文件名称 调度周期-执行条件-公式判断 文件处理-邮件通知-主题和内容 文件处理-客户端通知-主题和内容 | 取单元格值的函数在 FineBI 中不能使用 |
