7、EPM Calculation Function and Calculation Command

1、计算方法 Calculation Function 

1.1  计算#MISSING 和Zero的计算逻辑。

下面的X代表数值。详细参考： Oracle Essbase Database Administrator's Guide

Calculation/Operation	Result
X + #MISSING	X
X – #MISSING #MISSING – X	X -X
X * #MISSING	#MISSING
X / #MISSING #MISSING / X X / 0	#MISSING #MISSING #MISSING
X % #MISSING #MISSING % X X % 0	#MISSING #MISSING #MISSING
X == #MISSING	False, unless X is #MISSING
X != #MISSING X <> #MISSING	True, unless X is #MISSING True, unless X is #MISSING
(X <= #MISSING)	(X <=0)
(X >= #MISSING)	(X >=0) or (X == #MISSING)
(X > #MISSING)	(X > 0)
(X < #MISSING)	(X < 0)
X AND #MISSING: 1 AND #MISSING (1 represents any nonzero value) 0 AND #MISSING #MISSING AND #MISSING	#MISSING 0 #MISSING
X OR #MISSING: 1 OR #MISSING (1 represents any nonzero value) 0 OR #MISSING #MISSING OR #MISSING	1 #MISSING #MISSING
IF (#MISSING)	IF (0)
f (#MISSING)	#MISSING for any Essbase function of one variable
f (X)	#MISSING for any X not in the domain of f, and any Essbase function of more than one variable (except where specifically noted)

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

1.2 计算方法的分类

关于essbase方法的分类大概分为如下几种：使用如下的方法可以在计算脚本中起到事半功倍的效果。

方法类别	方法用途	具体方法 （红色需要注意）
Boolean 布尔类型	一般和IF命令一起使用，返回 TRUE/FALSE  1/0 用于执行各种逻辑判断。	@ISACCTYPE当前成员是否有account标签。 @ISGEN                   @ISLEV      @ISSAMEGEN         @ISSAMELEV @ISMBR  @ISMBRUDA 是否用户定义的属性在这个成员上。   @ISUDA 是否成员维度有用户定义的属性。 @ISRANGENONEMPTY 定义的范围是否存在数据
RelationShip 关系型	关系函数根据当前单元格位置和一系列参数在数据库中查找特定的值。就是根据当前成员查找其相关的值。	@ATTRIBUTEBVAL 从布尔属性维度找到相关属性值。 @ATTRIBUTESVAL 从文本属性维度找到相关属性值。 @ATTRIBUTEVAL 从数字/时间属性维度找到相关属性值。 @CURGEN    当前成员所在维度的代数成员。  @GEN 当前成员所在代的数字。 @CURLEV      当前成员所在维度的LEV成员。  @LEV 当前成员所在LEV的数字。 @MDANCESTVAL  任意数量维度的成员组合的祖先。@ANCESTVAL   成员的祖先。 @MDPARENTVAL  任意数量维度的成员组合的父母。@PARENTVAL  成员的父母。 @SANCESTVAL    根成员下的 确定深度的共享成员的祖先。 @SPARENTVAL    根成员下的 确定深度的共享成员的祖先。 @XREF  与正在计算的数据库的值不同。 @XWRITE 将值写入与计算值不同的数据库。
Mathematial 数学方法	可以使用数学函数进行高级计算。	@EXP  自然对数e为底 ,表达式的幂。   @POWER 指数表达式。 @Factorial 阶乘。 @LN   自然对数e。 @LOG  任意数的自然对数。 @LOG10 以10为底的自然对数。 @MAXS 跳过空值，取最大值。 @REMAINDER 残值。 @VAR  方差。 @ VARPER 方差百分比。
Member Set 成员集合型	返回一个成员的list。 : 基于lev返回 ，Jan:Dec  返回Jan和Dec所在的lev的成员，包含头尾。 ::基于gen返回，Jan:Dec  返回Jan和Dec所在的Gen的成员，包含头尾。	@ALLANCESTORS  该成员所有的祖先，并包括共享成员。 @EQUAL 去匹配指定的成员。 建议看对应函数语法。
Range and Financial 区间，财务型	Range函数接受一组成员作为参数。 RangeList :一个维度上面的一系列成员。   XrangeList:一个或者多个维度上面的一系列成员。 @XRANGE(Jan:Mar)   返回 Jan   Feb   Mar 对于这类方法，如果没有指定Rangelist和Xrangelist 则 标注为时间维度中0级的成员成为默认成员。如果也没维度标签是时间维度则报错。	@ACCUM   在一个区间的成员和。 @SUMRANGE 一系列指定成员汇总列表。 @AVGRANGE 在一个区间的成员平均数。 @COMPOUND  以一定的比率，计算一个区间的复利（混合利率）。 @CURRMBRRANGE 基于相对位置的成员会被计算。 @DECLINE 使用余额递减，去计算一个成员在一个期间的折旧depreciation。 @DISCOUNT 以一定的利率和时间维度，去计算指定成员的折现值。 @GROWTH 代表线性增长的一系列值。 @INTEREST 代表线性增长的成员。 @IRR 跨时间或者指定的成员来计算 现金流内部收益率。 @MAXRANGE 跨范围最大成员。   @MAXSRANGE 剔除#MISSING和0 求出最大值。 @NEXT 区间的下一个值。  @NEXTS 跳过#MISSING/0 或者两者的下个值。 @NPV  net Present value 净现值关于收入和支出。 @PTD period-to-date 期间到日期的值。 @PRIOR 以前的值。  @PRIORS 跳过#MISSING/0以前的值。  @RANGE 一个成员和其他维度成员组成的值。@ RANGEFIRSTVAL 第一个值。 @RANGELASTVAL最后一个值。 @SHIFT ，SHIFTPLUS，SHIFTMINUS  一系列下一个区间的值。 @SLN  根据时间区间，用直线折旧法计算资产折旧金额。 @SYD 根据时间区间，用年度数字 计算资产折旧金额。 @XRANGE 同一Lev的成员列表。
Allocation 分配行		@ALLOCATE 分配值到最低lev。 @MDALLOCATE 在多维中分配到最低lev。
Forecasting 预测型	平滑的预测数据。	@MOVAGE  使用移动平均值来预测。 @MOVMAX  使用移动最大值来预测。 @MOVMED  使用移动中位数来预测。 @MOVSUM  使用移动和来预估。 @MOVSUMX  使用移动和来预估。 @SPLINE     使用平滑样条的曲线来预估。 @TREND   根据历史的曲线拟合未来数据值。
Statiscal  统计型	计算高级统计例如相关性correlation和方差variance.	@CORRELATION  两个并行数据加之间的相关系数。 @MODE 众数，出现频率最多的数据。   @MEDIAN  中位数。 @STDEV   standard deviation 标准差。  @STDEVRANGE   @VARIANCE 基于样本计算的方差。 @VARIANCEP  基于总体计算方差。
data & time 日期型		@TODATE 用来吧日期字符串转换为数字。
Miscellaneous 混合型		@CALCMODE  指定计算公式在单元格模式，还是块模式。以及是从上到下计算还是从下到上计算。 @CONCATENATE，@SUBSTRING,@NAME  用来操作字符串。 @RETURN  通过自定义信息来结束计算。 @ALLOCATE @CREATEBLOCK 使用值或#MISSING来填充。
Hybrid Aggregation Mode 支持型		支持 @ABS,@ALLANCESTORS,@ALIAS,@ANCESTORS,@ATTRIBUTE,@ATTRIBUTEBVAL,@ATTRIBUTESVAL,@ATTRIBUTEVAL,@AVG, @BETWEEN,@CALCMODE,@CHILDREN,@CONCATENATE,@COUNT,@CURGEN,@CURLEV,@DATEDIFF,@DATEPART,@VARIANCE,@VARIANCEP, @DATEROLL,@DESCENDANTS,@ENUMVALUE,@EQUAL,@EXP,@EXPAND,@FACTORIAL,@FORMATDATE,@GEN,@GENMBRS,@VARPER, @IALLANCESTORS,@IANCESTORS,@ICHILDREN,@IDESCENDANTS,@ILANCESTORS,@ILDESCENDANTS,@ILSIBLINGS,@INT,@VAR, @INTERSECT,@IRDESCENDANTS,@IRSIBLINGS,@ISACCTYPE,@ISANCEST,@ISATTRIBUTE,@ISCHILD,@ISDESC,@ISGEN,@UDA, @ISIANCEST,@ISIBLINGS,@ISICHILD,@ISIDESC,@ISIPARENT,@ISISIBLING,@ISLEV,@ISMBR,@ISMBRUDA,@ISMBRWITHATTR, @ISPARENT,@ISRANGENONEMPTY,@ISSAMEGEN,@ISSAMELEV,@ISSIBLING,@ISUDA,@LANCESTORS,@LDESCENDANTS,@LEV,@LEVMBRS, @LIKE,@LIST,@LN,@LOG,@LOG10,@LSIBLINGS,@MATCH,@MAX,@MAXRANGE,@MAXS,@MAXSRANGE,@MBRCOMPARE,@MBRPARENT,@MEDIAN, @MEMBERAT,@MERGE,@MIN,@MINRANGE,@MINS,@MINSRANGE,@MOD,@MODE,@NAME,@NEXT,@NEXTS,@NEXTSIBLING,@NOTEQUAL, @POWER,@PREVSIBLING,@PRIOR,@PRIORS,@RANGE,@RANGEFIRSTVAL,@RANGELASTVAL,@RANK,@RDESCENDANTS,@RELATIVE, @RELXRANGE,@REMAINDER,@REMOVE,@RETURN,@ROUND,@RSIBLINGS,@SHARE,@SHIFTMINUS,@SHIFTPLUS,@SHIFTSIBLING, @SIBLINGS,@SPARENTVAL,@SUBSTRING,@SUM,@SUMRANGE,@TODATE,@TODATEEX,@TODAY,@TRUNCATE,@WITHATTR, 其余不支持。
Custom-defined 自定义型	使用java编写并在服务上注册。

 

 

 

 

 

 

 

 

 

 

 

 

 

 

2、计算命令  Calculation Command.

使用计算脚本创建与数据库大纲不同的计算。计算命令是计算脚本的基本元素。

计算命令分类	方法用途	具体方法 （红色需要注意）
Conditional 条件命令	条件命令用来控制事件的流向。	IF  ELSEIF  ELSE ENDIF
Control Flow 控制流命令	被重复用作限制数据到一个子区。	FIX  ENDFIX  ， EXCLUDE  ENDEXCLUDE ：限制计算成员。 LOOP ENDLOOP：重复步骤。 FIXPARALLEV  ENDFIXPARALLEV  在子集上数据块启动并行计算。
Data Declaration  数据声明命令	用于声明并初始化 临时值。 在查询中不会返回值，只有在计算脚本才执行。如果想展示需要在数据库大纲创建，或者将变量赋值给现有成员。	ARRAY VAR
Functional 方法命令	用来计算，数据复制，导出数据，清除数据，货币转换。	AGG: CALC ALL: CALC AVERAGE: CALC DIM: CALC FIRST： CALC LAST: CALC TWOPASS: CCONV: CLEARBLOCK: CLEARCCTRACK: CLEARDATA: DATAEXPORT: DATAEXPORTCOND: SET DATAEXPORTOPTIONS: SET DATAIMPORTIGNORETIMESTAMP: SET AGGMISSG SET CACHE SET CCTRACKCALC: SET CLEARUPDATESTATUS: SET FRMLBOTTOMUP SET FRMLRTDYNAMIC: SET LOCKBLOCK: SET MSG; SET NOTICE: SET REMOTECALC: SET RUNTIMESUBVARS: SET UPDATECALC: SET UPTOLOCAL:
Member Formulas 成员公式	用于在脚本中计算默认的大纲公式。	“Profit_%”； Expenses=Payroll + Marketing；

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

3、实际脚本计算