@WEIGHTEDSUMX
リモート・データ・ソースからフェッチされる各メンバーの単位の重みに応じて、メンバー・リストのすべてのメンバーを集約します。@WEIGHTEDSUMXでは、計算フレームワークを一度のみコールすることで、通貨データベースの集計のパフォーマンスが向上します。
この機能を説明するために、次の用語が使用されます:
-
データ・ターゲット: 現在の計算が実行されているデータベース(@WEIGHTEDSUMXコールが発生したデータベース)。
-
データ・ソース: @WEIGHTEDSUMXによって問合せが行われるデータベース。 このデータベースはリモート(つまり、データ・ターゲットとは異なるマシン上)でもかまいません。
-
視点: データ・ターゲットで現在計算されているメンバーの組合せ(つまり、計算の左側を識別するメンバーの組合せ)。
構文
目標に応じて、この関数を呼び出す方法は複数あります。
リモート・キューブから値を取り込むには、次の構文を使用します:
@WEIGHTEDSUMX (mbrList, locationAlias [, CurrencyType, CurrencyRate, Period]);
mbrListおよびlocationAliasパラメータは必須です。 他のパラメータが指定されていない場合は、POVから取得されます。
別のアプリケーションおよびデータベースの値を同じEssbaseサーバー・インスタンスに組み込むには、次の構文を使用します:
@WEIGHTEDSUMX (mbrList, appname, dbname [, CurrencyType, CurrencyRate, Period]);
パラメータ
- mbrList
-
必須。 個々のメンバーの単位重量に従って集計されるメンバーのリストを指定します。 mbrListには、メンバー・リストまたはメンバー名のカンマ区切りリストを戻す計算関数を使用できます。 メンバー・リストには、複数のメンバーを戻す関数を含めることはできません。
メンバー・リストを返す関数の例: @CHILDREN、@DESCENDANTSおよび@RANGE。
メンバー名のカンマ区切りリストは、単一の引数として表す必要があります。 たとえば、"USD"、"ARS"、"AUD"、"BRL"などの通貨のリストは、@LIST ("USD", "ARS", "AUD", "BRL")のようにメンバー・リスト関数とともに使用したり、メンバーが同じレベルの場合は範囲として"USD":"BRL"のように、またはカッコで囲んだ場合は("USD", "ARS","AUD","BRL")のように、使用できます。
mbrListに指定したメンバーは、データ・ターゲットの現在の視点のメンバーに加えてデータ・ソースに送信されます。 次に、データ・ソースは優先度の高い順にメンバーの組合せを構成します:
-
mbrListで指定されたメンバー
-
現在の視点のメンバー
-
データ・ソース内の未指定のディメンションの最上位メンバー
次の式は、データ・ターゲットの視点を変更します。 データ・ソース(sourceDB)のキューブに2002年のデータのみが含まれているとします。 次の式は、Jan 2003のInventoryをDec 2002のInventory値に設定します:
2003(2003->Jan->Inventory = @WEIGHTEDSUMX (mbrList, locationAlias, Dec) ;)
次の式は、データ・ターゲットの特定の視点を定義します。 データ・ターゲットにメンバーJanが含まれ、データ・ソース(locationAlias)にメンバーJanuaryが含まれているとします。 次の式は、データ・ターゲット(Jan)のメンバーをデータ・ソース(January)の対応するメンバーにマップし、データ・ソースからJanuaryを取得します:
Jan = @WEIGHTEDSUMX (mbrList, locationAlias, January);
次の式は、同じレベルのメンバーの範囲を含むメンバーのカンマ区切りリストを使用した@RANGEの使用例です:
@WEIGHTEDSUMX(@RANGE("Entered","USD":"ZAR"), _FCCS_Rates_, "Rate.Average", "Rate_USD");
-
- locationAlias
-
必須。 データ・ソースのロケーション別名。 ロケーション別名は、データ・ソースを識別するディスクリプタです。 ロケーション別名は、計算スクリプトを実行するデータベースで設定する必要があります。 ロケーション別名はデータベース管理者によって設定され、データ・ソースのサーバー、アプリケーション、データベース、ユーザー名およびパスワードを指定します。
- appname, dbname
- アプリケーションおよびキューブの名前。 Essbaseサーバー・インスタンスが1つのみのデプロイメントにのみ使用します。
- CurrencyType
- オプション。 平均、クローズ、履歴などのメンバーを含む、通貨タイプを含むディメンションのメンバー。
- CurrencyRate
- オプション。 グローバル通貨レートを表すメンバーを持つ、通貨レートを含むディメンションのメンバー。
- 期間
- オプション。 時間ディメンションのメンバー。
ノート
-
データ・ターゲットにサインインし、データ・ソースにもプロビジョニングされている必要があります。
-
mbrListで指定されたメンバーがデータ・ソースに存在しない場合は、エラーが返されます。
-
データ・ソースで問合せを行うデータ・セルの数は、データ・ターゲットで必要なデータ・セルの数と一致する必要があります。
-
メンバー・リストには、複数のメンバーを戻す関数を含めることはできません。
-
ディメンションごとに指定できるパラメータは1つのみです。