ブロック・ストレージ・データベース用の式の作成

表47に、式で使用できる演算子のタイプをリストします:

#MISSING、ゼロおよびその他の値での演算子の使用方法は、『Oracle Essbaseテクニカル・リファレンス』のEssbaseの関数に関する項を参照してください。

式には、次元名とメンバー名を含めることができます。例:

メンバーに定数値を割り当てることができます。例:

      California = 120;
   

この式では、「California」は疎次元のメンバーで、120は定数値です。「California」のすべての存在可能なデータ・ブロックがEssbaseで自動的に作成され、すべてのデータ・セルに値120が割り当てられます。何千ものデータ・ブロックが作成される場合もあります。

疎次元で値が必要な交差のみに定数を割り当てるには、FIXステートメントを使用します。疎次元のメンバーに割り当てられた定数値を参照してください。

疎次元のメンバーに定数以外の値を割り当てるときに、そのメンバーのデータ・ブロックが存在していない場合、Essbaseで「等式によるブロックの作成」を使用可能にするまでは、新しいブロックが作成されません。デフォルトでは、「等式によるブロックの作成」は無効になっています。

たとえば、計算を実行する前には存在していなかったWestのブロックを作成するには、次の式での「等式によるブロックの作成オプション」を有効にする必要があります:

      West = California + 120;
   

データベース・レベルで「等式によるブロックの作成」を使用可能にして、ブロックが常に生成されるようにできます。または、SET CREATEBLOCKONEQ ON | OFF計算コマンドを使用することで計算スクリプト内でブロック生成を制御できます。

アプリケーションまたはデータベース・レベルで「等式によるブロックの作成」を使用可能にすると、不要なブロックが作成され、計算パフォーマンスに影響が出る場合があります。計算スクリプトを使用してブロックの作成を制御するには、SET CREATEBLOCKONEQ ON | OFF計算コマンドを使用します。疎次元のメンバーに割り当てられた非定数値を参照してください。

式で算術演算を使用して、基本的な等式を作成できます。等式は、データベース・アウトラインまたは計算スクリプト内に含めることができます。

等式の構文は次のとおりです:

      member
       = 
      mathematical_operation
      ;
   

memberは、データベース・アウトラインのメンバー名です。mathematical_operationは、有効な算術演算です。

次の例では、Essbaseはデータベースのデータを循環しながら、Sales内の値からCOGS内の値を減算し、結果をMarginに配置します:

      Margin = Sales - COGS;
   

次の例は、データベース・アウトラインおよび計算スクリプトにおける等式の使用方法を示しています。アウトラインでは、次の式をMarkupメンバーに適用します:

      (Retail - Cost) % Retail;
   

次に、計算スクリプトで次の式を使用します:

      Markup = (Retail - Cost) % Retail;
   

Essbaseはデータベースのデータを循環しながら、Retail内の値からCost内の値を減算し、結果の値をRetailの値のパーセンテージとして計算し、その結果をMarkupに配置します。

Essbaseには、式の構文エラーをユーザーに通知する、Essbaseサーバーベースの式構文検査機能が組み込まれています。たとえば、ユーザーが間違った関数名を入力すると、Essbaseによりそのことが通知されます。カスタム定義のマクロや関数名のリストに対して、不明な名前を検証できます。ユーザーがアウトラインに関連付けられたサーバーやアプリケーションに接続していない場合は、不明な名前を検証するため、Essbaseにより自動的に接続が確立されます。

式のセマンティク・エラーは、構文検査機能では通知できません。セマンティク・エラーは、式が期待どおりに動作しないときに発生します。セマンティク・エラーを見つけるには、計算を実行して、予想どおりの結果が得られるかどうかを確認します。

Essbaseにより、式エディタの下部に構文検査の結果が表示されます。Essbaseで構文エラーが検出されなかった場合は、「エラーはありません」というメッセージが表示されます。

Essbaseで1つ以上の構文エラーが検出された場合は、エラーのある行の行番号とエラーの短い説明が表示されます。たとえば、式の行末文字としてセミコロンを入力しなかった場合、Essbaseにより次のようなメッセージが表示されます:

      Error: line 1: invalid statement; expected semicolon
   

式エディタまたはアウトライン・エディタでの検証で式が承認されても、アウトラインが保存されるときにEssbaseサーバーでセマンティク・エラーが検出された場合は、次のような措置がとられます:

式を修正し、アウトラインを保存すると、メンバー・コメント内のメッセージが削除されます。アウトラインを再度開くと、更新されたコメントが表示されます。

単一の条件テストまたは一連の条件テストを行う式を定義すれば、計算のフローを制御できます。

IFおよびENDIFコマンドでは、条件ブロックが定義されます。IFコマンドとENDIFコマンドの間に置かれた式は、テストがTRUE(1)を戻す場合にのみ実行されます。テストがFALSE(0)を戻す場合は、ELSEおよびELSEIFコマンドを使用して代替アクションを指定できます。各ELSEコマンドに続く式は、前のテストがFALSE(0)を戻す場合にのみ実行されます。各ELSEIFコマンドに続く条件は、前のIFコマンドがFALSE(0)を戻す場合にのみテストされます。式の構文の理解を参照してください。

計算スクリプトで条件式を使用するときは、この項の例で示すように、その式を丸カッコで囲み、データベース・アウトラインのメンバーと関連付けます。

IFコマンドとともに、条件テストの結果に基づいて、TRUEまたはFALSE(それぞれ1または0)を戻す関数を使用できます。これらの関数は、ブール関数と呼ばれています。

ブール関数を使用して、使用する式を決定します。この決定は、現在のメンバーの組合せの特性に基づいて行われます。たとえば特定の計算を、入力データを含む製品次元内のメンバーのみに制限するには、計算の前に、@ISLEV(Product,0)に基づいたIFテストを配置します。

関数パラメータのいずれかが、@ISMBR(Sales -> Budget)のような次元間メンバーである場合は、TRUE(1)の値を戻すように、次元間メンバーのすべての部分を現在のセルのプロパティと合わせる必要があります。

表49に、条件を指定するブール型関数をリストします:

データベース・アウトラインに式を配置するときは、IF、ELSE、ELSEIFおよびENDIFコマンドとブール関数のみを使用して、計算フローを制御できます。計算スクリプト内では、その他の制御コマンドも使用できます。

計算スクリプトの作成方法や、計算スクリプトを使用してEssbaseによるデータベース計算を制御する方法については、ブロック・ストレージ・データベース用の計算スクリプトの作成。を参照してください。個々のEssbase関数および計算コマンドについては、『Oracle Essbaseテクニカル・リファレンス』を参照してください。

次の式を、データベース・アウトラインのCommissionメンバーに適用できます。

次の例の式では、売上が500000を超える場合、売上の1%の歩合が計算されます:

      IF(Sales > 500000)
   Commission = Sales * .01;
ENDIF;
   

この式を計算スクリプト内に記述する場合は、式とCommissionメンバーを次のように関連付ける必要があります:

      Commission (IF(Sales > 500000)
   Commission = Sales * .01;
ENDIF;)
   

Essbaseでは、データベース内を循環して、次の計算が実行されます:

次の例の式では、現在のメンバーの祖先をテストした後、適切なPayroll計算式が適用されています:

      IF(@ISIDESC(East) OR @ISIDESC(West))
   Payroll = Sales * .15;
ELSEIF(@ISIDESC(Central))
   Payroll = Sales * .11;
ELSE
   Payroll = Sales * .10;
ENDIF;
   

この式を計算スクリプト内に記述する場合は、式とPayrollメンバーを次のように関連付ける必要があります:

      Payroll(IF(@ISIDESC(East) OR @ISIDESC(West))
   Payroll = Sales * .15;
ELSEIF(@ISIDESC(Central))
   Payroll = Sales * .11;
ELSE
   Payroll = Sales * .10;
ENDIF;)
   

Essbaseでは、データベース内を循環して、次の計算が実行されます:

多次元計算の概念についてを参照してください。@ISIDESC関数については、『Oracle Essbaseテクニカル・リファレンス』を参照してください。

表50に、式内で多くの算術演算を実行できる数学関数をリストします:

表51に、関係関数をリストします。この関数では、特定の値を検索するため、Essbaseで現在計算中のメンバーの組合せを使用できます:

個別のEssbase関数については、『Oracle Essbaseテクニカル・リファレンス』を参照してください。

表52に、特定の範囲のメンバーに対して式を実行できる範囲関数をリストします:

表53に、式内に財務計算を含めることができる財務関数をリストします:

この項では、メンバーを参照する式の作成について説明します。

                     Mar2001
                  

                     Mar2001, Apr2001, May2001
                  

                     Jan2000:Dec2000
                  

                     Q1_2000::Q4_2000
                  

                     Q1_97::Q4_98, FY99, FY2000
                  

                     @SIBLINGS(Dept01), Dept65:Dept73, Total_Dept
                  

次元間にわたるメンバーの組合せの操作

次元間演算子を使用して、特定メンバーの組合せのデータ値を指します。ハイフン(-)と大なり記号(>)を使用して、次元間演算子を作成します。次元間演算子とメンバーの間にはスペースを入力しないでください。

図114は多次元キューブを簡単に例示したもので、JanはX軸の1番目の列、SalesはY軸の4番目および最上部の行、そしてActualはZ軸の1番目の行に存在します。この例では、Sales -> Jan -> Actualが単一のデータ値の交差部です。

図 114. 単一のデータ値の指定

次の例では、各市場の各製品に様々な支出を割り当てることにより、次元間演算子の使用方法を示します。すべての市場のすべての製品について、Misc_Expensesの値がわかっています。この式では、Product -> Marketの個々の組合せに、様々な支出(Misc_Expenses)の合計のパーセンテージが割り当てられます。割当ては、各市場の各製品のSalesの値に基づいて行われます。

         Misc_Expenses = Misc_Expenses -> Market -> Product * 
      

            (Sales / ( Sales -> Market -> Product));
      

Essbaseでは、データベース内を循環して、次の計算が実行されます:

1. 現在のメンバーの組合せのSales値が、すべての市場とすべての製品のSalesの合計値(Sales -> Market -> Product)で除算されます。

2. 手順1で計算された値と、すべての市場とすべての製品のMisc_Expenses値(Misc_Expenses -> Market -> Product)とが乗算されます。

3. 計算結果が現在のメンバーの組合せのMisc_Expensesに割り当てられます。

次元間演算子を使用すると、パフォーマンスに重大な影響が出る場合があります。最適化のガイドラインについては、次元間演算子の使用を参照してください。

この項では、値に関連する式について説明します。

      1. January Ending   = January Opening – Sales + Additions
2. February Opening = January Ending
3. February Ending  = February Opening – Sales + Additions
4. March Opening    = February Ending
5. March Ending     = March Opening – Sales + Additions
   

      IF(NOT @ISMBR (Jan))
   "Opening Inventory" = @PRIOR("Ending Inventory");
ENDIF;
"Ending Inventory" = "Opening Inventory" - Sales + Additions;
   

      "Opening Inventory"
(IF(NOT @ISMBR (Jan))
   "Opening Inventory" = @PRIOR("Ending Inventory");
ENDIF;)
"Ending Inventory" = "Opening Inventory" - Sales + Additions;
   

実績値と予定値との差異または差異のパーセンテージの計算

@VARおよび@VARPER関数を使用して、予定値と実績値との差異または差異のパーセンテージを計算できます。

差異は、正または負の値になることがありますが、これは、会計次元のメンバー(支出アイテムまたは支出外アイテム)に関する差異を計算しているかどうかによって異なります:

• 支出アイテム。実績値が予定値に満たない場合(たとえば実際のコストが予定コストより低い場合)、Essbaseに表示される差異は正の値になります。

• 支出外アイテム。実績値が予定値に満たない場合(たとえば売上実績が売上予想より低い場合)、Essbaseに表示される差異は負の値になります。

Essbaseでは、デフォルトで、メンバーは支出外アイテムであると想定され、これに従って差異が計算されます。

  Essbaseにメンバーが支出アイテムであると指定するには:

1. アウトライン・エディタで、メンバーを選択します。

   このメンバーは、勘定科目としてタグ付けされた次元上に存在している必要があります。

2. 式エディタを開きます。

   Oracle Essbase Administration Services Online Helpの「アウトライン内の式の作成および編集」を参照してください。

3. メンバーに支出アイテムとしてタグ付けします。

   差異レポート・プロパティの設定を参照してください。

@VARまたは@VARPER関数を使用しているとき、実績値が予定値より低い場合、Essbaseに表示される差異は正の値になります。たとえば、Sample.BasicのTotal Expensesの子は支出アイテムです。シナリオ次元のVarianceおよびVariance%メンバーを使用して、実績値と予定値の差異を計算できます。図115を参照してください。

図 115. 差異の例

予測関数では、データを補間したり将来の値を計算したりする目的でデータを操作できます。表59に、値を予測する関数をリストします:

個別のEssbase関数については、『Oracle Essbaseテクニカル・リファレンス』を参照してください。

統計関数では、Essbase内で高度な統計を計算できます。

日付関数により、他の関数で日付を使用できます。

@TODATE: 日付文字列が、計算式で使用できる数値に変換されます

計算モード関数では、Essbaseで式の計算に使用される計算モードを指定できます。

@CALCMODE: Essbaseで式の計算に使用される計算モード(セル、ブロック、ボトムアップまたはトップダウン)を指定する

式および計算スクリプト内で使用するカスタム定義関数を作成して、Essbase計算スクリプト言語ではサポートされていない計算を実行できます。カスタム定義関数はJavaプログラミング言語で記述し、Essbaseサーバーに登録する必要があります。Essbase計算機フレームワークでは、カスタム定義関数は外部関数として呼び出されます。

カスタム定義関数は、計算スクリプト・エディタの関数ツリー内に表示されます。計算スクリプト・エディタを使用して、カスタム定義関数を選択したり、式に挿入したりできます。

カスタム定義計算関数の作成。を参照してください。

代替変数は、期間情報など、定期的に変更される情報のプレースホルダとして機能します。データベース・アウトラインに適用する式の中で、代替変数を使用できます。

アウトラインの計算が完了すると、Essbaseにより、代替変数はユーザーが割り当てた値に置き換えられます。Administration Services、MaxLまたはESSCMDを使用して、代替変数を作成したり、代替変数に値を割り当てたりできます。

代替変数は、サーバー・レベル、アプリケーション・レベルまたはデータベース・レベルで設定できます。Essbaseでは、計算スクリプトを実行しているアプリケーションおよびデータベースから、代替変数にアクセスできる必要があります。代替変数の使用を参照してください。

式で代替変数を使用するには、アンパサンド(&)に続けて代替変数名を入力します。

Essbaseでは、&に続くテキスト文字列はすべて代替変数と見なされます。

たとえば、代替変数UpToCurrがJan:Junと定義されているとします。次の@ISMBR関数を条件付きテストの一部として使用できます:

      @ISMBR(&UpToCurr)
   

Essbaseでは、アウトラインの計算時に、次のように代替変数が置き換えられます:

      @ISMBR(Jan:Jun)
   

アウトライン・メンバー式では、ユーザー固有のシステム設定のプレースホルダとしてシステム環境変数を使用できます。環境変数は、オペレーティング・システム・レベルで定義されているので、Essbaseサーバー上のすべての式で使用できます。

式での環境変数の使用方法は、計算スクリプトで環境変数を使用する場合と同じです。計算スクリプトおよび式での環境変数の使用を参照してください。