INFOR.GET.ELEMENTS

この関数は INFOR.GET.ELEMENT 関数の拡張バリアント型です。1 つまたは複数のエレメントに対して 1 つまたは複数の属性値を返します。たとえば、特定のエレメントの子を取得し、キャプション (MEMBER_CAPTION) と ID (MEMBER_UNIQUE_NAME) の両方を要求できます。

INFOR.GET.ELEMENTS では、次の機能がサポートされています。

  • 動的配列

    取得された値は隣接するセルにスピルされます。

  • 複数選択

    同じ階層から複数のエレメントの一意の名前を指定できます。

  • すべての属性の取得
  • MDX 式

    たとえば、[HierarchyUN].DefaultMember を指定してデフォルトエレメント属性を返すか、elementUN.Children で複数の子エレメントを返します。

    注: 

    エレメントのセットが MDX 式から返される場合、値は自動的にスピルされ、対応する属性が各エレメントに対して個別に返されます。

  • インデント

    エレメントのレベルインデントに使用する文字列を指定し、インデントする属性を示すことができます。

    デフォルトでは、最初の属性のみがインデントされ、2 つのスペースが使用されます。

  • ページング

    ページング動作に使用できる引数は 2 つあります。表示するレコードの数を制限し、使用するページを定義することができます。

数式のスピル

関数が複数の値を返すと、それらの値は隣接する空白のセルにスピルされます。デフォルトのスピル方向では、エレメントを垂直下方向に、属性値を水平右方向にスピルします。

構文

この関数の構文は次のとおりです。

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

次の表にパラメーターとその説明を示します。

パラメーター 説明
spillByColumns スピル方向のオプションのブール値。列でスピルする場合は True、行でスピルする場合は False を指定します。デフォルト値: False。
data_connection データベースの一意の名前を表します。文字列またはセル参照です。
cube キューブの一意の名前を表します。文字列またはセル参照です。
attribute 属性の一意の名前を表します。これは文字列またはセル参照のマトリックスです。指定されていない場合、MEMBER_CAPTION がデフォルト値になります。
hierarchy 階層の一意の名前を表します。文字列またはセル参照です。階層が指定されていない場合、デフォルト値は空の文字列で、階層はエレメントの一意の名前から解析されます。
number_of_records 表示するレコード数の制限として使用される数値またはセル参照です。任意のパラメーター、デフォルト値: 0 = 制限なし。
page 表示するページを定義する数値またはセル参照です。任意のパラメーター、デフォルト値: 1。
indentString インデントに使用される文字列です。任意のパラメーター、デフォルト値: 「 」、2 つの空白。
indentIndices インデントする 1 つ以上の属性を表すインデックスまたはセル参照のマトリックスです。デフォルト値 1 を持つ任意のパラメーターです。です。デフォルトでは、最初の属性がインデントされます。使用可能なその他の値: 0 = すべての属性をインデントする。-1 = インデントなし。
element 選択した階層に基づくエレメントの一意の名前またはセル参照のマトリックスの数です。Excel の制限があるため最大数は 249 です。
注: 

階層が指定されていない場合は、エレメントの一意の名前を長い形式で指定する必要があります。たとえば、[PERIOD].[ALL YEARS].[2018] です。

戻り値

この関数は、1 つまたは複数のエレメントに対して、1 つまたは複数のエレメント属性キャプション (MEMBER_CAPTION)、ID (MEMBER_UNIQUE_NAME) などを表す文字列値を返します。2 つのエレメントの一意の名前と 2 つの属性を指定すると、結果として 2 × 2 のマトリックスを返します。

たとえば、2016 年、2017 年、2018 年の「北米の売上」を指定すると、選択した年度に対する 1 × 3 のサマリー値のマトリックスを返します。