维度表达式

函数一：已知维度成员的所有后代

即当前节点下的所有低于当前节点等级的节点。

• Descendant(维度成员名,排序方式(0/1),有效性过滤参数(0/1/2))

• IDescendant(维度成员名,排序方式(0/1),有效性过滤参数(0/1/2))（包含节点本身）

示例：

获取 Entity 维度 #root 节点下所有后代节点的维度表达式为： Entity{Descendant(#root,0)}

获取Entity维度#root节点下的所有后代节点，并且过滤实体激活版有效性，且返回纯子结构的维度表达式为 ： Entity{Descendant(#root,0,2)}

函数二：已知维度成员的所有子代

即当前节点下的所有次级节点。

• Children(维度成员名,排序方式(0/1),有效性过滤参数(0/1/2))

• IChildren(维度成员名,排序方式(0/1),有效性过滤参数(0/1/2))（包含节点本身）

示例：

获取 Entity 维度 #root 节点下所有子代节点的维度表达式为:

Entity{Children(#root,0)}

函数三：已知维度成员的所有末级节点

即当前节点下的所有最底层节点。

• Base(维度成员名,排序方式(0/1),有效性过滤参数(0/1/2))，已知维度成员本身为末级节点时返回本身

• IBase(维度成员名,排序方式(0/1),有效性过滤参数(0/1/2))（包含节点本身）

示例：

获取 Entity 维度 #root 节点下所有末级节点的维度表达式为:

Entity{Base(#root,0)}

函数四：已知维度成员的开始层级到结束层级之间的所有节点

• Level(维度成员名,排序方式(0/1),当前层级开始层级,当前层级结束层级,有效性过滤参数(0/1/2))

• ILevel(维度成员名,排序方式(0/1),当前层级开始层级,当前层级结束层级,有效性过滤参数(0/1/2))（包含节点本身）

示例：

获取 Entity 维度 TotalEntity 节点向下第一层级到第三层级之间的节点维度表达式：

Entity{Level(TotalEntity,0,1,3)}

参数释义（四种表达式函数都相同）

• 排序方式 0:正序 1:倒序

• 有效性过滤参数 0:否；1:是，并返回父点子结构成员；2：是，并返回纯子结构成员。该参数非必传，默认为0。该参数仅对多版本实体维生效。

• #root是一个虚拟节点，使用表达式函数不会返回#root节点，但是作为单个维度成员查询，会返回#root节点。Entity{IDescendant(#root,0)}的返回结果中不会出现#root，但是Entity{#root}则会返回#root。

示例： 获取 Entity 维度 TotalEntity 的所有末级节点，NoEntity，以及和 TotalEntiy 同级的 Company 节点下所有节点的维度表达式：

Entity{Base(TotalEntity,0);NoEntity;Descendant(Company,0)}

删除函数

从 函数一 获取的列表数据中去除 函数二 或者单独某个维度成员，去除的 函数二 和维度成员可为多个 Remove(函数一,函数二,维度成员名…)。

示例：

获取 Entity 维度 #root 节点的所有不是末级节点的后代节点，TotalEntity 不包含在内：

Entity{Remove(IDescendant(#root,0),Base(#root,0),TotalEntity)}

条件过滤

从 函数一 中获取的列表数据中维度成员的字段属性需要满足某些具体的条件。

表达式为：AndFilter/OrFilter/NAndFilter/NOrFilter(函数1,Attr(属性名,属性值))

Attr(属性名,属性值) 中属性值是否需要单引号要根据当前属性数据库设置的类型来设置：

• 若 ud5 的类型为 varchar，则字段属性表达式为 Attr(ud5,'1')

• 若 ud5 的类型为 int，则字段属性表达式为 Attr(ud5,1)

条件过滤有四种情况：

别名中特殊字符规则

原则上允许各种特殊字符，但部分特殊字符涉及到json格式或维度表达式预留字符等限制，需要特殊处理：

1，支持转义符（即反斜杠\），可以在别名中使用转义符，但因为转义符本身在json字符串语法规则中不能单独出现，所以在使用维度表达式时，需要使用两个连续的转义符来表示转义符。

例如：

有别名为：A\公司，那么在维度表示中需要这样写：IDescendant([A\公司],0)

2，不支持 换行符 （\n）和 回车符 （\r）

例如：以下别名不合法：A\n公司，A\r公司

3，支持英文单引号和英文双引号，但是因为英文双引号本身在json字符串语法规则中不能在字符串中直接出现，在维度表达式中使用时，需要在双引号前加上转义符（英文单引号不需要额外处理，直接使用即可）。

例如：有别名为：AB’C”公司,那么在维度表示中需要这样写：IDescendant([AB’C”公司],0)

4，因为维度表达式本身使用了[]作为边界符，所以如果别名中存在[]，必须要成对出现，并且在表达式中使用时，需要使用[[来代表[， 使用]]来代表]。 例如：有别名：A门店[某某路分店] ,那么在维度表示中需要这样写：[A门店[[某某路分店]]]

5，别名首尾不能使用空格，中间可以出现空格。

6，别名长度不能超过255。