1. Oracle Essbase計算および問合せリファレンス
  2. 計算コマンド
  3. 計算コマンド・リスト
  4. EXCLUDE…ENDEXCLUDE
機械翻訳について

EXCLUDE…ENDEXCLUDE

EXCLUDEコマンドを使用すると、関連するコマンドの影響を受けないメンバーの固定範囲を定義できます。 ENDEXCLUDEコマンドは、EXCLUDEコマンド・ブロックを終了します。

この例に示すように、EXCLUDEコマンド・ブロック内のすべてのコマンドがコールされた後、計算スクリプトの次の要素の前にENDEXCLUDEをコールします。

EXCLUDE..ENDEXCLUDEコマンドで計算しないメンバーを指定する方が、FIX…ENDFIXコマンドでメンバー名の複雑な組合せを指定するよりも簡単な場合があります。

構文

EXCLUDE (Mbrs)
COMMANDS ;
ENDEXCLUDE

パラメータ

Mbrs

任意の数のデータベース・ディメンションのメンバー名またはメンバーのリスト。 Mbrsには、次のものも含めることができます:

  • AND/OR operators. AND演算子は、すべての条件を満たす必要がある場合に使用します。 OR演算子は、複数の条件を満たす必要がある場合に使用します。

  • メンバー・セット関数。他のメンバーに基づいてメンバー・リストを構築するために使用されます。

COMMANDS

EXCLUDEの実行中に実行されるコマンド。

ノート

  • EXCLUDE…ENDEXCLUDEコマンドは計算スクリプト内でのみ使用し、アウトライン・メンバー式では使用しないでください。

  • FIXコマンド・ブロック内にEXCLUDEコマンドを含めることができます。

  • EXCLUDEコマンド・ブロック内のFIXコマンドでEXCLUDE文ですでに指定されているセルが指定されている場合、それらのセルは計算されず、アプリケーション・ログ・ファイルに警告メッセージが書き込まれます。

  • EXCLUDEコマンド・ブロックにCALC ALL、CLEARDATAおよびDATACOPYコマンドを含めることはできません。

  • AND演算子とOR演算子は優先順位が同じで、左から右に評価されます。 カッコを使用して式をグループ化します。 たとえば: A OR B AND Cは、((A OR B) AND C)と同じです。 ただし、部分式(たとえば、(A OR (B AND C))は式全体の前に評価され、異なる結果が生成されます。

  • EXCLUDEコマンド・ブロック内では、AND演算子は2つのセットの共通部分を表し、OR演算子は2つのセットの結合を表します。 式では、これらの演算子はブール演算子です。 異なるディメンションのメンバーに対してANDまたはOR演算子を使用すると、次の値が戻されます:

    • AND: 空のセット。 EXCLUDE文は無視され、計算は警告メッセージで続行されます。

    • OR: 2つのメンバー・セットの和集合。 EXCLUDE (Jan OR Market)はFIX (Jan, Market)と同じです。

  • NOT演算子はEXCLUDEコマンド・ブロックではサポートされていません。 @REMOVE関数を使用します。

  • ENDEXCLUDEの後にセミコロンを付ける必要はありません。

  • @ATTRIBUTEおよび@WITHATTR関数を使用して、EXCLUDEコマンド・ブロック内の属性(EXCLUDE(@ATTRIBUTE(Can))など)を指定します。 FIX(Can)はサポートされていません。

  • EXCLUDEコマンド・ブロック内で計算するディメンションのサブセットである場合は、ディメンションに対してEXCLUDEを使用できません。 たとえば、コマンド・ブロック内のすべてのMarketを計算する場合、EXCLUDE文でMarket "New Mkt"を使用することはできません。

  • EXCLUDE文では、「動的計算」メンバーは無視されます。 EXCLUDE文のメンバーが「動的計算」メンバーのみの場合は、EXCLUDE文に「動的計算」メンバーを含めることができないことを示すエラー・メッセージが表示されます。

  • EXCLUDEコマンドが計算スクリプトから発行され、空のセットが生成された場合、計算のその部分は無視され、次の文に進みます。 計算のアプリケーション・ログ・エントリは、EXCLUDE文が空のセットに評価されたことを示しています(固定メンバー[]を使用した[…]の計算)。

    たとえば、Sample Basic計算スクリプトの次の文を考えてみます:

        EXCLUDE (@children(Jan))
    CALC DIM (Accounts, Product, Market)
    ENDEXCLUDE

    @children(Jan)は空であるため(Janはレベル0のメンバーです)、EXCLUDEパラメータは無視され、計算はデータベース全体で実行されます。

    同様に、パーティションまたはセキュリティ・フィルタを定義するリージョンが空のセットと評価された場合、Essbaseは、リージョン定義またはセキュリティ・フィルタが存在しないかのように動作します。

  • 計算関数@RANGEおよびディメンション間演算子(->)は、EXCLUDE Mbrsパラメータ内では使用できません。

例

次の例では、Qtr4の子の計算を除外して、Yearディメンションの他の四半期の計算を可能にします。

EXCLUDE (@CHILDREN(Qtr4))
CALC DIM (Year)
ENDEXCLUDE
FIX…ENDFIX
LOOP...ENDLOOP