cognos纬度函数及实例.docx

1Block Functions1.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+312 ,返回集个数应为成员最大集，即12个1.2_remainderSet 原型_remainderSet (member_exp,set_exp , numeric_exp )说明当 set_exp set 的大小大于 numeric_exp 时，成员表达式将包括在返回的集中2family, hierarchy, and member functions2.1hierarchy 原型hierarchy ( level | member | set_exp )说明返回包含指定级别、成员或成员集的层级案例1、hierarchy(机动车辆保险)解释1、返回产品的成员集,包含所有的产品结构2.2level 原型level ( member )说明返回成员的级别案例1、level (机动车辆保险)解释1、返回产品的成员集，仅包含机动车辆保险成员2.3levels 原型levels ( hierarchy , index )说明返回层级中与根级别相距某一距离（由“index”指定）的级别案例1、level (机动车辆保险,2)解释1、返回产品的成员集，包含机动车辆保险及同级成员下所有二级成员2.4rootMembers 原型rootMembers ( hierarchy )说明返回层级的根成员案例1、rootMembers (每日一览N.产品.产品)解释1、返回根成员产品2.5currentMember 原型currentMember (hierarchy )说明返回迭代过程中某个层级的当前成员。如果指定层级不在所计算的表达式的上下文中，则假定为其默认成员案例1、currentMember (每日一览N.产品.产品)解释1、返回成员产品2.6defaultM vember 原型defaultMember ( hierarchy )说明返回层级的默认成员案例1、defaultMember (每日一览N.产品.产品)解释1、返回成员产品2.7lag 原型lag ( member , index_exp )说明返回排在指定成员之前特定位数的同胞成员案例1、lag(2008/6,5)解释1、2008/1 返回的月份为2008/6前移index_exp，即5个月2.8lead 原型lead ( member , index_exp )说明返回排在指定成员之后特定位数的同胞成员案例1、lead(2008/6,5)解释1、2008/11 返回的月份为2008/6后移index_exp，即5个月2.9Members 原型members ( hierarchy | level )说明返回层级或级别中的成员集。如果返回层级中的成员，则结果中无法保证成员的顺序；要按某一个顺序列出成员，必须使用明确排序的函数（如 hierarchize）案例1、members(每日一览N.产品.产品.险类+)解释1、返回层级下所有成员2.10nextMember 原型nextMember ( member )说明返回包含指定成员的级别中的下一个成员案例1、nextMember (2008/6解释1、返回2008/72.11prevMember 原型prevMember ( member )说明返回包含指定成员的级别中的上一个成员案例1、prevMember (2008/6解释1、返回2008/52.12ancestor 原型ancestor ( member, level | integer )说明返回指定（命名）级别上指定成员的组项，或返回以下级别上指定成员的组项：指定成员上面指定数量的级别。注：当存在多个此类组项时，结果可能不一致案例1、ancestor(机动车交通事故责任强制保险,1)解释1、返回机动车辆保险，即机动车交通事故责任强制保险的上级，若level为2，则返回产品,也就是上两级2.13ancestor 原型ancestor ( member, level | integer )说明返回指定（命名）级别上指定成员的组项，或返回以下级别上指定成员的组项：指定成员上面指定数量的级别。注：当存在多个此类组项时，结果可能不一致案例1、ancestor(机动车交通事故责任强制保险,每日一览N.产品.产品.险类+)解释1、返回机动车辆保险，即机动车交通事故责任强制保险的上级，与每日一览N.产品.产品.险类+同级2.14ancestors 原型ancestors ( member , level | index )说明返回某一成员在指定级别或高于该成员的级别中的所有组项。（在指定级别上，大多数数据源只支持一个组项，而某些数据源则支持多个组项。因此结果是成员集。）案例1、ancestors(机动车交通事故责任强制保险,1)解释1、返回机动车辆保险，即机动车交通事故责任强制保险的上级，与每日一览N.产品.产品.险类+同级2.15parent 原型parent ( member )说明返回指定成员的父项成员案例1、parent (机动车交通事故责任强制保险)解释1、返回机动车辆保险，即机动车交通事故责任强制保险的父级2.16cousin 原型cousin ( member1 , member2 )说明返回 member2 的子项，该子项在 member2 下面的相对位置与 member1 在其父项下面的相对位置相同案例1、cousin(机动车辆保险特种车保险,企业财产保险)解释1、返回财产综合保险2.17descendants 原型descendants ( member | set_expr , level | distance , self | before | beforewithmember | after )说明返回指定级别 (限定名称) 或与根级别相距某一距离 (整数 0.n) 的级别上某成员或成员集的子项集。可以指定多个选项 (用空格隔开) 以确定要返回的成员案例1、descendants(企业财产保险,每日一览N.产品.产品.险种)解释1、返回企业财产保险下险种级别的所有集合2.18firstChild 原型firstChild ( member)说明返回成员的第一个子项案例1、firstChild(企业财产保险)解释1、返回财产基本保险 2.19firstSibling 原型firstSibling ( member )说明返回成员父项的第一个子项案例1、firstChild(企业财产保险)解释1、返回机动车辆保险2.20lastChild 原型lastChild ( member )说明返回指定成员的最后一个子项案例1、lastChild (企业财产保险)解释1、返回电厂机器损坏保险2.21lastSibling 原型lastSibling ( member )说明返回指定成员的父项的最后一个子项案例1、lastSibling (企业财产保险)解释1、返回未归类2.22siblings 原型siblings ( member )说明返回指定成员的父项的子项案例1、siblings (企业财产保险)解释1、返回产品的所有子项3relative time functions3.1parallelPeriod 原型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.2periodsToDate 原型periodsToDate ( level , member )说明返回与指定成员处于同一级别的同胞成员集，并受指定级别限制。它先查找处于“level”级别的“member”成员的组项，然后返回此组项中与“member”成员处于同一级别的子项（直到包括“member”成员）。通常与时间维度配合使用案例1、periodsToDate(每日一览N.日期.日期.年,2008/5月)解释1、返回2008/5月前2008年内所有月3.3closingPeriod 原型closingPeriod ( level , member )说明返回指定级别上某一成员的子项中的最后一个同胞。通常与时间维度配合使用案例1、closingPeriod(每日一览N.日期.日期.月,2008年)解释1、返回2008年 对应每日一览N.日期.日期.月最后月3.4lastPeriods 原型lastPeriods ( integer_exp , member )说明返回同一级别中以指定成员结尾的成员集。返回的成员数是“integer_exp”的绝对值。如果“integer_exp”为负数，则返回指定成员后面的成员，包括指定成员。通常与时间维度配合使用案例1、lastPeriods(12,2008/4月)解释1、返回 2008/4月前12个月3.5openingPeriod 原型openingPeriod ( level , member )说明在指定级别上某一成员的子项当中，返回第一个同胞成员。通常与时间维度配合使用案例1、openingPeriod(每日一览N.日期.日期.月,2008年)解释1、返回 2008年一月份3.6openingPeriod 原型openingPeriod ( level , member )说明在指定级别上某一成员的子项当中，返回第一个同胞成员。通常与时间维度配合使用案例1、openingPeriod(每日一览N.日期.日期.月,2008年)解释1、返回 2008年一月份4set functions4.1generate 原型generate ( set_exp1 , set_exp2 , ALL )说明此函数为“set_exp1”中的每个成员计算“set_exp2”，然后合并成结果集。如果指定了 ALL，则结果中保留重复值案例1、generate(每日一览N.产品.产品.险类+,topCount(descendants(currentMember(每日一览N.产品.产品),每日一览N.产品.产品.险种), 2,保单数量)解释1、返回每个险类子成员保单数量排前的2项 4.2nestedSet 原型nestedSet ( set_expr1 , set_expr2 )说明返回在 set_expr1 当前成员的上下文中求得的一组 set_expr2 成员案例1、nestedSet(members(每日一览N.产品.产品.险类+),topCount(descendants(currentMember(每日一览N.产品.产品),每日一览N.产品.产品.险种), 2,保单数量)解释1、返回每个险类子成员保单数量排前的2项4.3filter 原型filter ( set_exp , boolean_exp )说明返回按布尔条件过滤指定集后得出的集。当且仅当“boolean_exp”的对应值为真时，结果中才包含每个成员案例1、filter(每日一览N.产品.产品.险类+,保单数量100000)解释1、返回每日一览N.产品.产品.险类+中，保单数量100000的所有项4.4item原型item ( set_exp , index )说明返回集中处于指定位置的成员。集的索引从零算起案例1、item(每日一览N.产品.产品.险类+,3)解释1、返回家财险4.5set 原型set ( member , member )说明返回表达式中定义的成员列表。成员必须属于同一层级案例1、set(机动车辆保险,企业财产保险,工程保险)解释1、返回机动车辆保险,企业财产保险,工程保险4.6head 原型head ( set_exp , index_exp )说明返回“set_exp”中的第一个要素“index_exp”。“index_exp”的默认值为 1案例1、head(每日一览N.产品.产品.险类+,3)解释1、返回每日一览N.产品.产品.险类+前3个4.7tail 原型tail ( set_exp , index_exp )说明返回“set exp”中最后的“index_exp”个要素。“index_exp”的默认值为 1案例1、tail (每日一览N.产品.产品.险类+,3)解释1、返回每日一览N.产品.产品.险类+后3个4.8subset 原型subset ( set_exp, index_exp1 , index_exp2 )说明返回指定集中成员的子集，从“index_exp1”开始。如果指定了计数“index_exp2”，则返回多个成员（如果存在）。否则，将返回所有剩余成员案例1、subset(每日一览N.产品.产品.险类+,2,5)解释1、返回每日一览N.产品.产品.险类+第2+1个开始共5个项4.9members 原型members ( hierarchy | level )说明返回层级或级别中的成员集。如果返回层级中的成员，则结果中无法保证成员的顺序；要按某一个顺序列出成员，必须使用明确排序的函数（如 hierarchize）案例1、members(每日一览N.产品.产品.险类+)解释1、返回每日一览N.产品.产品.险类+所有成员4.10except 原型except ( set_exp1 , set_exp2 ,ALL )说明返回那些属于“set_exp1”但不属于“set_exp2”的成员。只有当可选关键字“ALL”用作第三个自变量时，才会保留重复项案例1、except(每日一览N.产品.产品.险类+,企业财产保险)解释1、返回每日一览N.产品.产品.险类+的成员，排除企业财产保险4.11order 原型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.12hierarchize 原型hierarchize ( set_exp )说明此函数用于对层级中某个集的成员进行排序。在未指定其它排序条件时，级别中的成员按自然顺序（即成员在维度上的默认顺序）进行排列案例1、hierarchize(members(每日一览N.产品.产品.险类+)解释1、返回每日一览N.产品.产品.险类+的成员，按自然排列4.13union 原型union ( set_exp1 , set_exp2 , ALL )说明此函数返回“set_exp1”和“set_exp2”这两个集的并集。只有当可选关键字“ALL”用作第三个自变量时，结果中才会保留重复项案例1、union(set(责任保险),set(财产保险,现金保险,建筑工程一切险)解释1、返回目标所有项4.14intersect 原型intersect ( set_exp1 , set_exp2 , ALL )说明返回两个输入集的交集。只有当可选关键字“ALL”用作第三个自变量时，结果中才会保留重复项案例1、intersect(set(机动车辆保险,机动车辆保险摩托车、拖拉机保险,商业楼宇财产综合险,电厂财产保险一切险),Members(每日一览N.产品.产品.险种)解释1、返回交集4.15except 原型except ( set_exp1 , set_exp2 ,ALL )说明返回那些属于“set_exp1”但不属于“set_exp2”的成员。只有当可选关键字“ALL”用作第三个自变量时，才会保留重复项案例1、except(Members(每日一览N.产品.产品.险种),set(机动车辆保险,机动车辆保险特种车保险,机动车辆保险摩托车、拖拉机保险,机动车提车险（暂保单）,机动车提车险,机动车交通事故责任强制保险)解释1、返回除set_exp2所描述外的所有set_exp1成员1 top and bottom functions1.1bottomCount 原型bottomCount ( set_exp , index_exp , numeric_exp )说明此函数根据在set_exp的每个成员中算得的numeric_exp值对集进行排序，然后返回具有最小index_exp值的成员案例1、bottomCount(每日一览N.产品.产品.险类+,9,2008年)解释1、返回每日一览N.产品.产品.险类+维度，按2008年排列后项1.2topCount 原型topCount ( set_exp , index_exp , numeric_exp )说明此函数根据在“set_exp”的每个成员中算得的“numeric_exp”值对集进行排序，然后返回具有最大“index_exp”值的成员案例1、topCount(每日一览N.产品.产品.险类+,9,2008年)解释1、返回每日一览N.产品.产品.险类+维度，按2008年排列前项1.3bottomPercent 原型bottomPercent ( set_exp , numeric_exp1 , numeric_exp2 )说明此函数与 bottomSum 类似，但阈值是“numeric_exp1”占合计的百分数案例1、bottomPercent(每日一览N.产品.产品.险类+,5,保单数量)解释1、返回每日一览N.产品.产品.险类+维度，按保单数量占总量的百分比1.4bottomPercent 原型bottomPercent ( set_exp , numeric_exp1 , numeric_exp2 )说明此函数与 bottomSum 类似，但阈值是“numeric_exp1”占合计的百分数案例1、bottomPercent(每日一览N.产品.产品.险类+,5,保单数量)解释1、返回每日一览N.产品.产品.险类+维度，按保单数量占总量的百分比1.5topPercent 原型topPercent ( set_exp , numeric_exp1, numeric_exp2 )说明此函数与 topSum 类似，但阈值是“numeric_exp1”占合计的百分数案例1、topPercent(每日一览N.产品.产品.险类+,50,保单数量)解释1、返回每日一览N.产品.产品.险类+维度，按保单数量占总量的百分比50%1.6bottomSum 原型bottomSum ( set_exp , numeric_exp1 , numeric_exp2 )说明此函数根据在“set_exp”的相应成员中算得的“numeric_exp2”进行排序，然后挑选出累加合计值至少为“numeric_exp1”的最小项案例1、bottomSum(每日一览N.产品.产品.险类+,50000,保单数量)解释1、返回每日一览N.产品.产品.险类+维度，按保单数量累计和至少为50000的最小项1.7topSum 原型topSum ( set_exp , numeric_exp1 , numeric_exp2 )说明此函数根据在“set_exp”的相应成员中算得的“numeric_exp2”值进行排序，然后挑选出累加合计值至少为“numeric_exp1”的最大项案例1、topSum (每日一览N.产品.产品.险类+,50000,保单数量)解释1、返回每日一览N.产品.产品.险类+维度，按保单数量累计和至少为50000的最大项2value functions2.1completeTuple 原型completeTuple ( member , member )说明与“tuple”相似，它根据指定成员（它们必须来自不同的维度）确定单元格位置（交集）。不过，completeTuple 暗指包括自变量中未另外指定的所有维度的默认成员，而非当前成员。此单元格的值可通过“value”函数求得案例1、completeTuple(机动车辆保险,北京)解释1、返回机动车辆保险与北京交叉部分2.2Tuple 原型tuple (member , member )说明根据指定成员（它们必须来自不同的维度）确定单元格位置（交集）。默认情况下，包括来自所有维度（而非自变量中指定维度）的当前成员。如果在计算上下文时未指定维度的当前成员，假定为该维度的默认成员。此单元格的值可通过“value”函数求得案例1、