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 中不能使用 |