集約ストレージ・データベースでのカスタム計算および割当ての実行

カスタム計算機能は指定された様々な基準に基づいています。表209に、カスタム計算の定義に使用される基準の簡単な説明を示します。次に進む前にこれらの用語を確認してください。

カスタム計算スクリプトは、.csc拡張子を付けて作成および格納するファイルです。MDXの1つまたは一連のタプル表現ペアでカスタム計算スクリプトを作成し、セミコロンで終了します。構文は次のとおりです:

      tuple := numeric_value_expression;
   

tupleは1つ以上のメンバーのMDX指定で、その中のメンバー同士は同じ次元に属すことができません。タプルは等式の左側にあり、カスタム計算の結果が書き込まれる場所を判断する主要要因となります。

タプル式ではメンバー名のみを使用できます。カスタム計算スクリプトでは、メンバー関数の使用はサポートされていません。

numeric_value_expressionは、数字や算術演算子などの簡単なMDX数値式です。この表現は等式の右側にある必要があります。算術演算子のみが実行されます。算術演算子(AND、ORまたはIFステートメントなど)が使用されていない場合は、エラーが返されます。

数値式ではメンバー名を使用できますが、カスタム計算スクリプトではメンバー関数の使用はサポートされていません。

属性メンバーは、カスタム計算スクリプトの等式の左側で使用できません。

ソース領域も定義する必要があり、これがEssbaseのパフォーマンス・ヒントとして機能します。Essbaseは、ソース領域に指定されたデータをプリフェッチし、それを使用してスクリプトで指定されている計算を実行します。

カスタム計算スクリプトの例、およびソース領域の定義の詳細は、カスタム計算の使用例を参照してください。

カスタム計算は、MaxLのexecute calculationステートメントを使用して実行できます(集約ストレージ・バージョン)。

Essbase APIを使用してカスタム計算スクリプトを実行できます。EssPerformCustomCalcASOを使用して、集約ストレージ・データベースでカスタム計算を実行または確認します。カスタム計算の情報をESS_PERF_CUSTCALC_T構造体に指定します。

また、Oracle Hyperion Calculation Managerを使用することで、カスタム計算を設計し、それを実行のためEnterprise Scheduling Servicesに配置できます。

次のような次元のアウトラインを想定します:

POVはMDXセット式で、カスタム計算が実行される場所を示します。次のように指定されます:

      CrossJoin( { ( [Company], [101], [Jan], [Scenario] ) },
           Descendants( Geography, Geography.Levels(0)) )

   

DebitMemberはMDXメンバー式で、正の結果値が書き込まれる対象の借方メンバーを示します。[BeginningBalance_Debit]のように指定されます。

CreditMemberはMDXメンバー式で、負の結果値およびオフセット結果値が書き込まれる対象の貸方メンバーを示します。[BeginningBalance_Credit]のように指定されます。

オフセットはMDXタプル式で、オフセット項目が作成される場所を示します。([Account_NA], [Project_NA])のように指定されます。

オフセット式はターゲットおよびPOVと組み合せることで、オフセット項目が作成される場所を決定します。次元が重複する場合、オフセットの場所を解決するための順序はオフセット、ターゲット、POVの順序になります。

ターゲットはMDXタプル式で、カスタム計算の結果を書き込む場所を示します。(Allocation)のように指定されます。

ターゲット式はPOVと、カスタム計算スクリプト内の各行の左側と組み合せることで、結果が書き込まれる場所を決定します。次元が重複する場合、ターゲットの場所を解決するための順序は等式の左側、ターゲット、POVの順序になります。この例では、POVで指定されたScenarioメンバーよりターゲットが優先されるため、結果はAllocationメンバーに書き込まれます。

カスタム計算スクリプトの例を次に示します:

      (AccountA,Proj1) := 100;
([AccountB], [Proj1]) := ([AccountB], [Proj1]) * 1.1;
(AccountC,Proj1) := 
	((AccountB,Proj1,2007) + (AccountB, Proj1)) / 2;
(AccountA,Proj2) := 
	((AccountD,Proj1) + 
	  (AccountB,Proj2)) / 2;
   

POVの各組合せの場合、

ソース領域を定義するには、カスタム計算スクリプトを確認し、等式の右辺でどのメンバーが参照されるかを決定します。ソース領域には、少なくとも、カスタム計算スクリプトの割当てステートメントの右辺にあるすべてのメンバーが含まれる必要があります。

ソース領域を単一のMDXセットとして定義します。等式の右辺のメンバーが複数のディメンションに属している場合は、CrossJoinを使用して2つのセットからこのセットを作成できます。CrossJoinでは2つのセットのみが受け入れられるため、ネストしたCrossJoinの使用が必要な場合があります。

上記のカスタム計算スクリプトのソース領域は次のとおりです:

      
Crossjoin(
 {[AccountB], [AccountD]}, 
   Crossjoin(
    {[Proj1], [Proj2]}, {[2007]}
   )
)

   

スクリプトに割り当てられていないソース領域にメンバーを含める必要はありません。たとえば、スクリプトで使用されていないソース領域に[AccountC]を追加した場合は、無視されて、パフォーマンスがわずかに低下する場合があります。

ソース領域の数値を考慮する必要はありません。たとえば、カスタム計算スクリプト内の次の割当てでは、ソース領域に何も追加す必要はありません: ([Bud Var]):=10

割当ては指定された様々な基準に基づいています。表210に、割当ての定義に使用される基準の簡単な説明を示します。次に進む前にこれらの用語を確認してください。

Essbaseは割当ての実行時に、データベースの各種の領域を使用します。各領域は、領域で定義された各次元の1つ以上のメンバーで構成されます。

割当てパラメータ値は、次の方法で表記できます:

割当てパラメータ値の表記方法の詳細は、『Oracle Essbase APIリファレンス』を参照してください。

POVは、割当てが実行されるコンテキストを記述するデータベース内の対称領域を指定します。POVはレベル0メンバーのみで構成できます。POVで定義された次元は他のパラメータで使用できませんが、基準および基準の時間スパンは例外です。

割当ては、POVセット内のあらゆるメンバーの組合せに対して繰り返されます。POVの組合せの数は、複数のメンバーが存在する次元のメンバー数の積です。(メンバーが1つだけの次元は、組合せの数の計算に使用されません。)

たとえば、POVが2つの次元(CostCenterおよびProject)で構成され、割当てが2つのコスト・センター(CostCenter1およびCostCenter2)と3つのプロジェクト(Project1、Project2およびProject3)で行われると仮定します。POVの組合せの数は6になります:

      Project1,CostCenter1
Project1,CostCenter2
Project2,CostCenter1
Project2,CostCenter2
Project3,CostCenter1
Project3,CostCenter2
   

割当ては、割当てコンテキストが各組合せに正常に設定されるまで6回繰り返されます。

割当ての基準として想定される値はPOVの組合せによって異なります。基準の設定を参照してください。

範囲は、割当て値が計算されて書き込まれる、データベース内の対称領域を指定します。

割当て値を範囲内の特定のセルに書き込まない場合は、除外範囲パラメータを使用して範囲の対称サブセットを表記します。範囲のサブセットを除外している場合でも、Essbaseは範囲内のすべてのセルを使用して割当て値を計算します。

範囲からセルを除外すると、割当て値の合計が金額の値を下回る場合があります。

次の例では、範囲が6つのメンバーの組合せで構成され、金額が6で、割当てメソッドが分散のため、Essbaseが範囲全体で金額を均等に割り当てます。割当て分散金額は1です(6/6 = 1)。

表212に示すように、Essbaseは範囲の各セルに1を書き込みます。

表213に示すように、除外された範囲が(Project2,CostCtr2)のメンバーの組合せに設定されている場合、Essbaseは割当て分散金額をそのセルに書き込みません。したがって、割当て値の合計(5)は金額(6)を下回ります。割当てプロセス後の除外されたセルの値は、#MISSINGまたはゼロになります。

範囲と除外された範囲は、レベル0のメンバーのみで構成できます。

金額は割当てのソースを指定します。ターゲット領域のセルに金額値が割り当てられます。金額は、上位レベル・メンバーまたはレベル0メンバーで構成が可能で、数値式、タプルまたは定数として表すことができます。

金額を表す式によって特定の要件が決まります:

金額を詳細に定義するためにこれらのパラメータを使用できます:

次の例に示すように、金額コンテキストと金額の時間スパンを使用して同じ結果を導き出すことができます。金額はDept_Aの値ですが、金額の時間スパンはDept_AのJan、Feb、MarおよびAprの月のみに焦点を当てるために使用されます。表215に示すように、金額の時間スパンに含まれるメンバーの集約値(10)は、範囲内のセル全体に割り当てられる金額値です。

表216に示すように、Jan + Feb + Mar + Aprの演算式として金額を指定し、金額コンテキストをDept_Aとして設定することで、同じ金額値を導き出すことができます:

(オプション)基準は、範囲と組み合せることで、金額の割当て方法を決定する基準値の場所を定義します。基準は上位レベル・メンバーまたはレベル0メンバーで構成できます。

基準を詳細に定義するためにこれらのパラメータを使用できます:

ターゲットは、範囲と組み合せることで、割当て値が書き込まれるデータベース内の領域を定義します。ターゲットはレベル0メンバーのみで構成できます。

ターゲットを詳細に定義するためにこれらのパラメータを使用できます:

基準およびターゲットの時間スパンの設定の理解を参照してください。

割当てメソッドは、金額を均等に割り当てるか、比例的に割り当てるかを指定します。

丸めメソッドは、割当て値を丸めるかどうかを指定します(デフォルトは、丸めない)。

値を丸めることを選択した場合、丸めメソッドは丸め誤差の処理方法を指定します。丸め誤差を無視するか、すべての割当て値を丸めて丸め誤差合計を最大割当て値、最小割当て値または特定のセルに追加することを選択できます。丸め誤差を最大割当て値または最小割当て値に追加することを選択し、複数の最大割当て値または最小割当て値が存在する場合、Essbaseは丸め誤差を追加する対象となる、最大値または最小値の1つを選択します。

割当て値を丸めることを選択した場合、丸めメソッドを詳細に定義するためにこれらのパラメータを使用できます:

(オプション)オフセットは、各ソース金額のオフセット値が書き込まれる、データベース内の場所を指定します。

オフセットは割当ておよびカスタム計算で同様に動作します。カスタム計算および割当てのためのオフセット処理の理解を参照してください。

(オプション) debitMemberとcreditMemberは、レベル0のメンバーのみで構成できます。

借方メンバーおよび貸方メンバーは同じ次元の2つの異なるメンバーである必要があります。

debitMemberとcreditMemberは割当ておよびカスタム計算で同様に動作します。カスタム計算および割当てのための貸方および借方処理の理解を参照してください。

基準およびターゲットの時間スパンに指定されるメンバーの数は、表221で説明するように、Essbaseで基準の時間スパン・オプションおよびターゲットの時間スパン・オプションがそれぞれ処理される方法に影響します。基準またはターゲットの時間スパンが空である、あるいは単一の期間に設定されている状況では、Essbaseは、基準またはターゲットの時間スパン・オプションにそれぞれ設定した可能性のあるあらゆる設定を無視します。基準またはターゲットの時間スパンの一方または両方が複数の期間に設定されている状況では、Essbaseは、基準またはターゲットの時間スパン・オプションに特定の設定を必要とします。

      alloc_amt = (sum_across_basis_time_span/basis_total_range) * amount
   

      alloc_amt = (basis_mbr_value/basis_total_range) * amount
   

次の例は、POVの組合せを変更すると、割当ての基準として想定されている値にどのように影響するかを示しています。この例では、シェア割当てメソッドを使用し、前年の総賃貸料を現行の年のすべてのコスト・センターに、各コスト・センターの人数に基づいて割り当てます。集約ストレージ・データベースにDepartments、Time、CostCenterおよびMeasuresの4つの次元があり、割当て基準が表232のように指定されていると仮定します:

割当てが各POVの組合せに対して実行されます:

表233に示すように、各POVの組合せには、割当ての計算で使用される固有の基準値のセットがあります: 範囲内の各コスト・センターの人数とJan 2008の合計の人数です:

各POVについて、Essbaseは各コスト・センターの人数(各メンバーの基準値)を、範囲の合計人数(範囲の基準値)で除算してから、その値を各部門の合計賃貸料(金額)で乗算します。たとえば、Dept_A、CostCenter1の場合、メンバー基準値(1)が範囲の基準(11)で除算され、その結果(0.09090909)が金額(1000)で乗算されます: (1/11) * 1000 = 90.90909。Dept_B、CostCenter1の場合、割当て金額は666.6667です: (5/15) * 2000 = 666.6667。表234に、各コスト・センターに対する割当てシェア金額を示します:

この使用例の目的は、シェア割当てメソッドを使用することで、各部門が占有する平方フィート数に基づいて総月額賃貸料を部門全体で比例再配分することです。

次のような次元のアウトラインを想定します:

賃貸料割当ては様々な方法で実行が可能で、個々の方法は同じ結果になります。2つのシナリオが存在します。各シナリオについて、各パラメータが次のように定義されていると仮定します:

式メンバーは金額および基準では使用できますが、ターゲットでは使用できません。ただし、集約ストレージ・データベースではトランザクション・セマンティクスがサポートされていないため、金額または基準で式メンバーを使用する際にデータ不整合の問題が発生する可能性があります。

次の例では、ユーザー1が一連の部門の収益値を転記し、各部門の年次累計収益が割当ての基準となる、ボーナス金額の割当てをユーザー2が実行します。これらの操作が実行される順序が結果に影響を及ぼします:

また、割当てのための年次累計収益の計算にMDX式が使用されると仮定します。式の複雑性が結果に影響を及ぼす場合があります: