INFOR.GET.ELEMENTS

此函数是 INFOR.GET.ELEMENT 函数的增强变形。这可为一个或多个元素返回一个或多个特性值。可检索某个元素的子级，并请求标题 MEMBER_CAPTION 和 id MEMBER_UNIQUE_NAME。

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

  • 动态数组

    检索的值也散布到相邻的单元格。

  • 多选

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

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

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

    注意

    如果从 MDX 表达式返回一组元素集合，那么将会自动散布值，并分别返回每个元素的相应特性。

  • 缩进

    可指定用于元素级别缩进的字符串，并指示哪些特性应缩进。

    默认情况下只缩进第一个特性并且使用两个空格。

  • 分页

    有两个参数可用于分页行为。可以限制显示的记录数并定义使用的页面。

公式散布

如果函数返回多个值，则该值散布到相邻的空单元格。默认散布方向是元素垂直向下散布，特性值水平向右散布。

语法

该函数的语法为：

=INFOR.GET.ELEMENTS("spillByColumns", "data_connection", "cube", [attribute], "hierarchy" {, "number_of_records", "page", "indentString", [indentIndices], [element], ...})

下表显示参数及其说明：

参数 说明
spillByColumns 散布方向，可选布尔值。指定真按列散布，指定假按行散布。默认值：假。
data_connection 表示数据库唯一名称。它是字符串或单元格引用。
cube 表示多维数据集唯一名称。它是字符串或单元格引用。
特性 表示特性唯一名称。它是字符串或单元格引用的矩阵。如果未指定，则 MEMBER_CAPTION 是默认值。
层次结构 表示层次结构唯一名称。它是字符串或单元格引用。如果未指定层次结构，则默认值为空字符串，层次结构从元素唯一名称解析。
number_of_records 数字值或单元格引用，用作所示记录数限制。可选参数，默认值为：表示无限制的 0。
page 用于定义要显示的页面的数字值或单元格引用。可选参数，默认值为：1.
indentString 用于缩进的字符串。可选参数，默认值为：' '，两个空格。
indentIndices 代表要缩进的一个或多个特性的索引或单元格引用矩阵。具有默认值 1 的可选参数。默认情况下，第一个特性是缩进的。其他可能的值：0 表示缩进所有特性。-1 表示无缩进。
元素 所选层次结构中任何元素唯一名称或单元格引用的数量。由于 Excel 限制，最大为 249。
注意

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

返回值

此函数返回字符串值，表示一个或多个元素特性（如标题、MEMBER_CAPTION、id、MEMBER_UNIQUE_NAME）。如果提供两个元素唯一名称和两个特性，将返回 2*2 矩阵作为结果。

例如，如果指定 2016、2017 和 2018 的北美销售，则此函数返回所选年份概要值的 1*3 矩阵。