Cognos8.3函数使用手册(一)

Cognos8.3函数使用手册(一)  

1         Block Functions

1.1         _firstFromSet

原型	_firstFromSet ( set_exp, numeric_exp_max , numeric_exp_overflow )
说明	返回在集中找到的前几个（不超过 numeric_exp_max + numeric_exp_overflow）成员。 如果超过 numeric_exp_max + numeric_exp_overflow，则只返回成员的最大数目
案例	1、_firstFromSet([全险种综合N].[产品].[产品].[险类+],2,3) 2、_firstFromSet([全险种综合N].[产品].[产品].[险类+],2,20) 3、[全险种综合N].[产品].[产品].[险类+] 成员数为12
解释	1、2+3<12 , 返回集个数应为numeric_exp_max 即 2个 2、2+20>12 , 返回集个数应为成员最大集，即12个

 

1.2         _remainderSet

原型	_remainderSet (member_exp, set_exp , numeric_exp )
说明	当 set_exp set 的大小大于 numeric_exp 时，成员表达式将包括在返回的集中

 

2        family, hierarchy, and member functions

2.1         hierarchy

原型	hierarchy ( level | member | set_exp )
说明	返回包含指定级别、成员或成员集的层级
案例	1、hierarchy([机动车辆保险])
解释	1、返回产品的成员集,包含所有的产品结构

 

2.2         level

原型	level ( member )
说明	返回成员的级别
案例	1、level ([机动车辆保险])
解释	1、返回产品的成员集，仅包含[机动车辆保险]成员

 

2.3         levels

原型	levels ( hierarchy , index )
说明	返回层级中与根级别相距某一距离（由“index”指定）的级别
案例	1、level ([机动车辆保险],2)
解释	1、返回产品的成员集，包含[机动车辆保险]及同级成员下所有二级成员

 

2.4         rootMembers

原型	rootMembers ( hierarchy )
说明	返回层级的根成员
案例	1、rootMembers ([每日一览N].[产品].[产品])
解释	1、返回根成员产品

 

2.5         currentMember

原型	currentMember (hierarchy )
说明	返回迭代过程中某个层级的当前成员。 如果指定层级不在所计算的表达式的上下文中，则假定为其默认成员
案例	1、currentMember ([每日一览N].[产品].[产品])
解释	1、返回成员产品

 

2.6         defaultMember

原型	defaultMember ( hierarchy )
说明	返回层级的默认成员
案例	1、defaultMember ([每日一览N].[产品].[产品])
解释	1、返回成员产品

 

2.7         lag

原型	lag ( member , index_exp )
说明	返回排在指定成员之前特定位数的同胞成员
案例	1、lag([2008/6],5)
解释	1、[2008/1] 返回的月份为[2008/6]前移index_exp，即5个月

 

2.8         lead

原型	lead ( member , index_exp )
说明	返回排在指定成员之后特定位数的同胞成员
案例	1、lead([2008/6],5)
解释	1、[2008/11] 返回的月份为[2008/6]后移index_exp，即5个月

 

2.9         Members

原型	members ( hierarchy | level )
说明	返回层级或级别中的成员集。 如果返回层级中的成员，则结果中无法保证成员的顺序；要按某一个顺序列出成员，必须使用明确排序的函数（如 hierarchize）
案例	1、members ([每日一览N].[产品].[产品].[险类+])
解释	1、返回层级下所有成员

 

2.10     nextMember

原型	nextMember ( member )
说明	返回包含指定成员的级别中的下一个成员
案例	1、nextMember ([2008/6]
解释	1、返回[2008/7]

 

2.11     prevMember

原型	prevMember ( member )
说明	返回包含指定成员的级别中的下一个成员
案例	1、prevMember ([2008/6]
解释	1、返回[2008/5]

 

2.12     ancestor

原型	ancestor ( member, level | integer )
说明	返回指定（命名）级别上指定成员的祖项，或返回以下级别上指定成员的祖项：指定成员上面指定数量的级别。  注：当存在多个此类祖项时，结果可能不一致
案例	1、ancestor([机动车交通事故责任强制保险],1)
解释	1、返回[机动车辆保险]，即[机动车交通事故责任强制保险]的上级，若level为2，则返回[产品],也就是上两级

 

2.13     ancestor

原型	ancestor ( member, level | integer )
说明	返回指定（命名）级别上指定成员的祖项，或返回以下级别上指定成员的祖项：指定成员上面指定数量的级别。  注：当存在多个此类祖项时，结果可能不一致
案例	1、ancestor([机动车交通事故责任强制保险],[每日一览N].[产品].[产品].[险类+])
解释	1、返回[机动车辆保险]，即[机动车交通事故责任强制保险]的上级，与[每日一览N].[产品].[产品].[险类+]同级

 

2.14     ancestors

原型	ancestors ( member , level | index )
说明	返回某一成员在指定级别或高于该成员的级别中的所有祖项。 （在指定级别上，大多数数据源只支持一个祖项，而某些数据源则支持多个祖项。 因此结果是成员集。）
案例	1、ancestors([机动车交通事故责任强制保险],1)
解释	1、返回[机动车辆保险]，即[机动车交通事故责任强制保险]的上级，与[每日一览N].[产品].[产品].[险类+]同级

 

2.15     parent

原型	parent ( member )
说明	返回指定成员的父项成员
案例	1、ancestors ([机动车交通事故责任强制保险])
解释	1、返回[机动车辆保险]，即[机动车交通事故责任强制保险]的父级

 

2.16     cousin

原型	cousin ( member1 , member2 )
说明	返回 member2 的子项，该子项在 member2 下面的相对位置与 member1 在其父项下面的相对位置相同
案例	1、cousin([机动车辆保险特种车保险],[企业财产保险])
解释	1、返回[财产综合保险]

 

2.17     descendants

原型	descendants ( member | set_expr , level | distance [ , { self | before | beforewithmember | after } ] )
说明	返回指定级别 (限定名称) 或与根级别相距某一距离 (整数 0..n) 的级别上某成员或成员集的子项集。可以指定多个选项 (用空格隔开) 以确定要返回的成员
案例	1、descendants([企业财产保险],[每日一览N].[产品].[产品].[险种])
解释	1、返回[企业财产保险]下险种级别的所有集合

 

2.18     firstChild

原型	firstChild ( member)
说明	返回成员的第一个子项
案例	1、firstChild([企业财产保险])
解释	1、返回[财产基本保险]

 

2.19     firstSibling

原型	firstSibling ( member )
说明	返回成员父项的第一个子项
案例	1、firstChild([企业财产保险])
解释	1、返回[机动车辆保险]

 

2.20     lastChild

原型	lastChild ( member )
说明	返回指定成员的最后一个子项
案例	1、lastChild ([企业财产保险])
解释	1、返回[电厂机器损坏保险]

 

2.21     lastSibling

原型	lastSibling ( member )
说明	返回指定成员的父项的最后一个子项
案例	1、lastSibling ([企业财产保险])
解释	1、返回[未归类]

 

2.22     siblings

原型	siblings ( member )
说明	返回指定成员的父项的子项
案例	1、siblings ([企业财产保险])
解释	1、返回[产品]的所有子项

 

3        relative time functions

3.1         parallelPeriod

原型	parallelPeriod ( level [ , int_exp [ , member ] ] )
说明	返回先前时段中与指定成员具有相同相对位置的成员。此函数与“Cousin”函数类似，但与时序的关系更为密切。该函数先得出处于“level”的“member”的祖项 (称为“祖项”)；然后得出与“祖项”相距“int_exp”个位置的“祖项”同胞，并返回该同胞的子项中“member”的平行时段。如果未指定，“int_exp”默认值为 1，“member”的默认值为当前成员
案例	1、parallelPeriod([每日一览N].[日期].[日期].[年],1,[2008/7月])
解释	1、返回[2007/7月]

 

3.2         periodsToDate

原型	periodsToDate ( level , member )
说明	返回与指定成员处于同一级别的同胞成员集，并受指定级别限制。 它先查找处于“level”级别的“member”成员的祖项，然后返回此祖项中与“member”成员处于同一级别的子项（直到包括“member”成员）。 通常与时间维度配合使用
案例	1、periodsToDate([每日一览N].[日期].[日期].[年],[2008/5月])
解释	1、返回[2008/5月]前2008年内所有月

 

3.3         closingPeriod

原型	closingPeriod ( level [, member ] )
说明	返回指定级别上某一成员的子项中的最后一个同胞。 通常与时间维度配合使用
案例	1、closingPeriod([每日一览N].[日期].[日期].[月],[2008年])
解释	1、返回[2008年] 对应[每日一览N].[日期].[日期].[月]最后月

 

3.4         lastPeriods

原型	lastPeriods ( integer_exp , member )
说明	返回同一级别中以指定成员结尾的成员集。 返回的成员数是“integer_exp”的绝对值。 如果“integer_exp”为负数，则返回指定成员后面的成员，包括指定成员。 通常与时间维度配合使用
案例	1、lastPeriods(12,[2008/4月])
解释	1、返回 [2008/4月]前12个月

 

3.5         openingPeriod

原型	openingPeriod ( level [ , member ] )
说明	在指定级别上某一成员的子项当中，返回第一个同胞成员。 通常与时间维度配合使用
案例	1、openingPeriod([每日一览N].[日期].[日期].[月],[2008年])
解释	1、返回 [2008年]一月份

 

3.6         openingPeriod

原型	openingPeriod ( level [ , member ] )
说明	在指定级别上某一成员的子项当中，返回第一个同胞成员。 通常与时间维度配合使用
案例	1、openingPeriod([每日一览N].[日期].[日期].[月],[2008年])
解释	1、返回 [2008年]一月份

 

 

 

4        set functions

4.1         generate

原型	generate ( set_exp1 , set_exp2 [ , ALL ] )
说明	此函数为“set_exp1”中的每个成员计算“set_exp2”，然后合并成结果集。 如果指定了 ALL，则结果中保留重复值
案例	1、generate([每日一览N].[产品].[产品].[险类+],topCount(descendants(currentMember([每日一览N].[产品].[产品]),[每日一览N].[产品].[产品].[险种]), 2,[保单数量]))
解释	1、返回每个险类子成员[保单数量]排前的2项

 

4.2         nestedSet

原型	nestedSet ( set_expr1 , set_expr2 )
说明	返回在 set_expr1 当前成员的上下文中求得的一组 set_expr2 成员
案例	1、nestedSet(members([每日一览N].[产品].[产品].[险类+]),topCount(descendants(currentMember([每日一览N].[产品].[产品]),[每日一览N].[产品].[产品].[险种]), 2,[保单数量]))
解释	1、返回每个险类子成员[保单数量]排前的2项

 

4.3         filter

原型	filter ( set_exp , boolean_exp )
说明	返回按布尔条件过滤指定集后得出的集。 当且仅当“boolean_exp”的对应值为真时，结果中才包含每个成员
案例	1、filter([每日一览N].[产品].[产品].[险类+],[保单数量]>100000)
解释	1、返回[每日一览N].[产品].[产品].[险类+]中，[保单数量]>100000的所有项

 

4.4         item

原型	item ( set_exp , index )
说明	返回集中处于指定位置的成员。集的索引从零算起
案例	1、item([每日一览N].[产品].[产品].[险类+],3)
解释	1、返回[家财险]

 

4.5         set

原型	set ( member { , member } )
说明	返回表达式中定义的成员列表。 成员必须属于同一层级
案例	1、set([机动车辆保险],[企业财产保险],[工程保险])
解释	1、返回[机动车辆保险],[企业财产保险],[工程保险]

 

4.6         head

原型	head ( set_exp [ , index_exp ] )
说明	返回“set_exp”中的第一个要素“index_exp”。 “index_exp”的默认值为 1
案例	1、head([每日一览N].[产品].[产品].[险类+],3)
解释	1、返回[每日一览N].[产品].[产品].[险类+]前3个

 

4.7         tail

原型	tail ( set_exp [ , index_exp ] )
说明	返回“set exp”中最后的“index_exp”个要素。 “index_exp”的默认值为 1
案例	1、tail ([每日一览N].[产品].[产品].[险类+],3)
解释	1、返回[每日一览N].[产品].[产品].[险类+]后3个

 

4.8         subset

原型	subset ( set_exp, index_exp1 [ , index_exp2 ] )
说明	返回指定集中成员的子集，从“index_exp1”开始。 如果指定了计数“index_exp2”，则返回多个成员（如果存在）。 否则，将返回所有剩余成员
案例	1、subset([每日一览N].[产品].[产品].[险类+],2,5)
解释	1、返回[每日一览N].[产品].[产品].[险类+]第2+1个开始共5个项

 

4.9         members

原型	members ( hierarchy | level )
说明	返回层级或级别中的成员集。 如果返回层级中的成员，则结果中无法保证成员的顺序；要按某一个顺序列出成员，必须使用明确排序的函数（如 hierarchize）
案例	1、members([每日一览N].[产品].[产品].[险类+])
解释	1、返回[每日一览N].[产品].[产品].[险类+]所有成员

 

4.10     except

原型	except ( set_exp1 , set_exp2 [,ALL] )
说明	返回那些属于“set_exp1”但不属于“set_exp2”的成员。 只有当可选关键字“ALL”用作第三个自变量时，才会保留重复项
案例	1、except([每日一览N].[产品].[产品].[险类+],[企业财产保险])
解释	1、返回[每日一览N].[产品].[产品].[险类+]的成员，排除[企业财产保险]

 

4.11     order

原型	order ( set_exp , value_exp [ , ASC | DESC | BASC | BDESC ] )
说明	通过为指定集中的每个值计算“value_exp”而得出一组值，来排列指定集中的成员，并通过第三个参数进行修改。 有两种排序方法： 层级式（ASC 或 DESC）和非层级式（BASC 或 BDESC，此处 B 表示“打破层级”）。 层级式排序方法首先按照成员在层级中的位置来排列成员。 然后它根据“value_exp”排列每个成员的子项。 非层级式排序方法对集中的成员进行排序时不考虑层级。 如果没有明确指明，则默认为 ASC
案例	1、order(members([每日一览N].[产品].[产品].[险类+]),[保单数量],asc)
解释	1、返回[每日一览N].[产品].[产品].[险类+]的成员，按[保单数量]升序排列

 

4.12     hierarchize

原型	hierarchize ( set_exp )
说明	此函数用于对层级中某个集的成员进行排序。 在未指定其它排序条件时，级别中的成员按自然顺序（即成员在维度上的默认顺序）进行排列
案例	1、hierarchize(members([每日一览N].[产品].[产品].[险类+]))
解释	1、返回[每日一览N].[产品].[产品].[险类+]的成员，按自然排列

 

 

4.13     union

原型	union ( set_exp1 , set_exp2 [ , ALL ] )
说明	此函数返回“set_exp1”和“set_exp2”这两个集的并集。 只有当可选关键字“ALL”用作第三个自变量时，结果中才会保留重复项
案例	1、union(set([责任保险]),set([财产保险],[现金保险],[建筑工程一切险]))
解释	1、返回目标所有项

 

4.14     intersect

原型	intersect ( set_exp1 , set_exp2 [ , ALL ] )
说明	返回两个输入集的交集。 只有当可选关键字“ALL”用作第三个自变量时，结果中才会保留重复项
案例	1、intersect(set([机动车辆保险],[机动车辆保险摩托车、拖拉机保险],[商业楼宇财产综合险],[电厂财产保险一切险]),Members([每日一览N].[产品].[产品].[险种]))
解释	1、返回交集

 

4.15     except

原型	except ( set_exp1 , set_exp2 [,ALL] )
说明	返回那些属于“set_exp1”但不属于“set_exp2”的成员。 只有当可选关键字“ALL”用作第三个自变量时，才会保留重复项
案例	1、except(Members([每日一览N].[产品].[产品].[险种]),set([机动车辆保险],[机动车辆保险特种车保险],[机动车辆保险摩托车、拖拉机保险],[机动车提车险（暂保单）],[机动车提车险],[机动车交通事故责任强制保险]))
解释	1、返回除set_exp2所描述外的所有set_exp1成员