Create Macro
MaxL create macro文を使用すると、既存の計算関数またはマクロの組合せを選択して、独自のEssbase計算マクロを作成および登録するために役立ちます。この文により、Essbaseカスタム定義の関数およびマクロ・カタログに新しいマクロが登録されます。
最低限必要な権限は、ローカル(アプリケーション・レベルの)マクロを作成する場合はアプリケーション・マネージャ、グローバル(システム・レベルの)マクロを作成する場合はシステム管理者です。
キーワード
- create macro MACRO-NAME as MACRO-EXPANSION
-
既存の計算関数またはマクロの組合せを選択して、カスタム定義のマクロを作成して登録します。マクロは、Essbaseサーバー全体で使用可能なグローバル・マクロとして、またはアプリケーションで使用可能なローカル・マクロとして登録します。グローバル(サーバー全体の)マクロを登録するには、MACRO-NAMEの1つのトークンを使用します。ローカル(アプリケーション全体の)関数を登録するには、2つのトークンを使用します。
- create macro MACRO-NAME <macro-signature>...
-
マクロに、マクロ引数の構文ルールを定義する、オプションの署名を入力します。マクロの署名では、マクロに引数(または入力パラメータ)が渡されるスタイルが記述されます。マクロ署名の1つの例として(SINGLE, SINGLE, GROUP)があります。これは、マクロに、2つのカンマ区切り引数に続いて、引数のリストを渡す必要があることを示します。カスタム定義のマクロ入力パラメータを参照してください。
- create or replace macro MACRO-NAME ...
-
グローバルまたはローカルのカスタム定義マクロを登録します。カスタム定義の関数とマクロ・カタログに同じ名前のマクロがすでに存在する場合は、置き換えられます。
- create macro MACRO-NAME as MACRO-EXPANSION spec CALC-SPEC-STRING
-
オプションのspec句は、
@MYMACRO (mbrName, rangeList)の例のように、計算機構文指定文字列です。IEssCube.getCalcFunctions JavaメソッドまたはEssListCalcFunctions C API関数の出力文字列でマクロが返されるようにするには、指定の文字列を使用します。ノート:
計算の指定の文字列を指定しない場合は、コメントも指定できません。
- create macro MACRO-NAME as MACRO-EXPANSION spec CALC-SPEC-STRING comment COMMENT-STRING
-
オプションのcomment句を使用すると、マクロの説明を追加できます(オプション)。計算機構文の指定の文字列を作成するには、spec句も一緒に使用しないとコメントを作成できません。オプションの計算機構文の指定の文字列とコメントは、IEssCube.getCalcFunctions JavaメソッドまたはEssListCalcFunctions C API関数の出力文字列として使用されます。
ノート
-
グローバル(システム・レベルの)マクロを作成するには、MACRO-NAMEに単一の名前を使用します。たとえば、'@COVARIANCE'です。
-
ローカル(アプリケーション・レベルの)マクロを作成するには、MACRO-NAMEにMaxLの二重命名規則を使用します。たとえば、Sample.'@COVARIANCE'です。
例
create macro Sample.'@COVARIANCE'(single, single) as '@COUNT(SKIPMISSING,@RANGE(@@S))' spec '@COVARIANCE (expList1, expList2)' comment 'Computes covariance of two sequences given as expression lists';