INFOR.GET.ELEMENT
この関数は、1 つまたは複数のエレメントの属性を表す値を返します。たとえば、キャプション (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 |
指定した階層からエレメントの一意の名前を表します。文字列またはセル参照の数のいずれかです。 注:
階層が指定されていない場合は、エレメントの一意の名前を長い形式で指定する必要があります。たとえば、 |
戻り値
この関数は任意のタイプの単一のセル値を返します。
指定された、有効な階層についてです。
エレメントパラメーターがカンマで区切られた複数の一意の名前として指定されている場合、集合メンバーを返します。複数エレメントは、同じ階層からのものである必要があります。エレメントパラメーターが空の場合、指定した階層からデフォルトエレメントを返します。エレメントパラメーターがエレメント名のみである場合、その名前の最初の使用可能なエレメントを返します。
たとえば MEMBER_CAPTION や MEMBER_UNIQUE_NAME など、属性パラメーターに複数の一意の名前が含まれる場合、1 x N サイズの配列を返します。指定された属性の順序は、返された項目の順序を定義します。
[attribute] 引数が指定されていない場合、MEMBER_CAPTION 属性を返します。
エラー
必須のパラメーターがない場合は、関数はエラー値を返します。指定されたパラメーターが無効な場合、対応する element はスキップされます。