@ILANCESTORS

指定されたメンバー・リストのメンバーと、メンバーのすべての祖先、または指定された世代またはレベルまでのすべての祖先を戻します。

この関数を別の関数のパラメータとして使用できます。関数にはメンバーのリストが必要です。

構文

@ILANCESTORS ((memberSetFunction) [,genLevNum])

パラメータ

memberSetFunction

メンバーのリストを戻すメンバー・セット関数。

@ILANCESTORSの使用方法によって、許可されるメンバー・セット関数が決まります。次のガイドラインに従います。

@ILANCESTORSを(FIX文内ではなく)単独で使用する場合は、@LIST関数を使用してメンバー名を指定する必要があります。例:
```
@LIST(mbr1,mbr2,...)
```
@ILANCESTORS関数がFIX文内で使用されている場合は、@UDAや@ATTRIBUTEなどのメンバー・セット関数を使用できます。例:
```
@UDA(dimName,uda)
```
```
@ATTRIBUTE (attMbrName)
```
この場合、@LIST関数を使用するかどうかを選択できます。たとえば、次の文は両方とも有効で、文は同じ結果を返します。

@ATTRIBUTEのみを使用する例:
```
FIX(@ILANCESTORS(@ATTRIBUTE(Caffeinated_True),@ATTRIBUTE(Ounces_12),"200-40"))
...
ENDFIX;
```
@LISTおよび@ATTRIBUTEの使用例:
```
FIX(@ILANCESTORS(@LIST(@ATTRIBUTE(Caffeinated_True),@ATTRIBUTE(Ounces_12),"200-40")))
...
ENDFIX;
```

注意:

指定したメンバー・リストのすべてのメンバーは、同じディメンションのものである必要があります。

genLevNum

オプション。メンバーを選択する上限の絶対世代番号または絶対レベル番号を定義する整数値。正の整数は世代番号を表します。 0または負の整数はレベル番号を表します。

例

すべての例は、Sample.Basicデータベースのものです。

@ILANCESTORS(@LIST(“100–10”,"200–20”))

100-10 (指定されたメンバー)、100 (100-10の祖先)、200-20 (指定されたメンバー)および200 (200-20の祖先)を戻します。結果に重複メンバーは含まれません。

@ILANCESTORS(@LIST(“100”,“100–10”))

100と100-10 (指定されたメンバー)、およびProduct (100と100-10の祖先)を戻します。結果に重複メンバーは含まれません。

@ILANCESTORS(@LIST(“100”,“Product”,“200”))

100、Productおよび200 (指定されたメンバー)を戻します。結果に重複メンバーは含まれません。

FIX(@ILANCESTORS(@UDA(Market,“New Market”)),2)
...
ENDFIX;

Nevada(新規市場UDAが割り当てられているメンバー)および西部(Nevadaの世代2の祖先)、Louisiana(新規市場UDAが割り当てられているメンバー)および南部(Louisianaの世代2の祖先)とColorado(新規市場UDAが割り当てられているメンバー)および中部(Coloradoの世代2の祖先)を戻します。

FIX(@ILANCESTORS(@ATTRIBUTE(Caffeinated_True),@ATTRIBUTE(Ounces_12),"200-40”))
...
ENDFIX;

100-10、100-20、200-10および300-30 (カフェイン酸12オンス飲料)、200-40 (指定されたメンバー)、100、200、300およびProduct (メンバーの祖先)を戻します。