INFOR.GET.ELEMENT

该函数返回表示一个或多个元素特性的值。例如，标题 (MEMBER_CAPTION) 或 ID (MEMBER_UNIQUE_NAME)。

INFOR.GET.ELEMENT 支持以下功能：

  • 多选

    可从同一层次结构指定多个元素的唯一名称。

  • 检索所有特性
  • MDX 表达式

    例如，可指定 [HierarchyUN].DefaultMember 以返回默认元素特性或指定 elementUN.Children 以返回多个子级元素。

    如果从 MDX 表达式返回聚合的元素集合，则会在一个单元格中返回相应特性，并且用逗号分隔。

语法

该函数的语法为：

=INFOR.GET.ELEMENT("data_connection", "cube", [attribute], "hierarchy" {, element, ...})

下表显示参数及其说明：

参数 说明
data_connection 表示数据库唯一名称。它是字符串或单元格引用。
cube 表示多维数据集唯一名称。它是字符串或单元格引用。
attribute 表示特性唯一名称。它是字符串或单元格引用的矩阵。如果未指定，默认值为 MEMBER_CAPTION。
hierarchy 表示层次结构唯一名称。它是字符串或单元格引用。如果未指定层次结构，则默认值为空字符串，然后从元素唯一名称解析层次结构。
element 表示指定层次结构中的元素唯一名称。它是任何数量的字符串或单元格引用。
注意

如果未指定层次结构，则必须以长格式指定元素唯一名称，例如 [PERIOD].[ALL YEARS].[2018]。

。

返回值

此函数返回任何类型的单个单元格值。

对于指定的有效层次结构：

  • 如果元素参数指定为多个唯一名称（用逗号分隔），则返回聚合成员。多个元素必须来自同一个层次结构。
  • 如果元素参数为空，则返回指定层次结构的默认元素。
  • 如果元素参数仅是元素名称，则返回具有该名称的第一个可用元素。

当特性参数包含多个唯一名称（例如，MEMBER_CAPTION 和 MEMBER_UNIQUE_NAME）时，函数返回 1 x N 尺寸的数组。指定特性的顺序定义了返回项目的顺序。

如果未指定 [attribute] 参数，则函数将返回 MEMBER_CAPTION 特性。

错误

如果缺少任何必需参数，则函数将返回错误值。如果指定参数无效，则会跳过相应的元素。