@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つのみです。