@EXPAND
メンバー・リスト内の各メンバーに対してメンバー・セット関数を呼び出すことで、メンバー検索を拡張します。 この関数によって返されたメンバーは、既存のメンバー・セットに追加されます。 重複メンバーはメンバー・セットから削除されません。
この関数は、一意のアウトラインおよび重複名アウトラインで使用できます。
構文
@EXPAND (mbrSetFunction, mbrList,[, genLevNum][, LAYERONLY | ALL][, topMbrinHierarchy])パラメータ
- mbrSetFunction
-
次のいずれかのメンバー・セット関数。メンバーのリストを戻します:
- mbrList
-
@LISTまたはメンバーのリストを戻すメンバー・セット関数(@DESCENDANTSなど)を使用してグループ化されたメンバーのカンマ区切りリスト。
- genLevNum
-
オプション: この引数は、
mbrSetFunctionに@ANCESTORS、@IANCESTORS、@DESCENDANTSまたは@IDESCENDANTSを指定した場合にのみ適用されます。メンバーを選択する上限の絶対世代番号または絶対レベル番号を定義する整数値。 正の整数は世代番号を表します。 0または負の整数はレベル番号を表します。
- LAYERONLY
-
オプション: この引数は、
mbrSetFunctionに@ANCESTORS、@IANCESTORS、@DESCENDANTSまたは@IDESCENDANTSを指定した場合にのみ適用されます。選択条件に一致する、指定された世代またはレベル(genLevNum)のメンバーのみを戻します。
この引数を指定する場合は、genLevNumを指定する必要があります。
- ALL
-
オプション: この引数は、
mbrSetFunctionに@ANCESTORS、@IANCESTORS、@DESCENDANTSまたは@IDESCENDANTSを指定した場合にのみ適用されます。指定した最上位メンバー(topMbrinHierarchy)から開始して、メンバー選択条件に一致するすべてのメンバーを戻します。
この引数を指定する場合は、topMbrinHierarchyを指定する必要があります。
- topMbrinHierarchy
-
オプション: この引数は、mbrSetFunctionに@EQUALを指定した場合にのみ適用されます。
メンバー検索のベースとなる完全修飾メンバー名。 指定したメンバーとその別名、およびそのすべての子孫が検索に含まれます。
@EQUAL for
mbrSetFunctionを指定し、topMbrinHierarchyを指定しない場合、Essbaseはアウトライン全体を検索します。
例
次の例は、次の重複名のアウトラインに基づいています:
Product
100
100–10
100–10–10
100–20
100–30
200
200–10
200–20
200–30
300
300–10
300–20
Diet
100–10
100–10–11
200–10
300–10
Bottle
200–10
300–20@EXPAND("@DESC", @LIST("Product"), -1, LAYERONLY)レベル1([100].[100-10]、[Product].[200]、[Product].[300]、[Diet].[100-10]および[Product].[Bottle])のProductディメンションのすべてのメンバーを返します。
@EXPAND("@EQUAL", @EXPAND("@CHILDREN", @LIST("[product].[100]", "[product].[200]")), , ,"Product")
Essbaseでは、最初に内部@EXPAND関数が実行されます。
@EXPAND("@CHILDREN", @LIST("[product].[100]", "[product].[200]"))の場合、メンバー・リストが展開され、メンバー100および200のすべての子(合計6メンバー)が含まれます。 次に、Essbaseによって外部@EXPAND関数が実行され、Product階層で6つのメンバーのいずれかとの一致が検索されます。