パラメーター変数の代入
パラメーター変数は、実行時に置き換えられる特定のコンテキストまたは要素を、現在のコンテキストと設定に固有の値で表すために、コマンドで使用されます。パラメーター変数は実行時に検証されるため、マクロ、インターフェースサービス、計算ルール、またはワークシートパラメーターの作成時にはすべての変数が許可されます。計算ルールについては、初回作成時に Infor BI OLAP でこれらのルール (サイクル期間用) を作成する前に、または [
] オプションを使用してルールを再開するときに、変数に代入されます。注:
- 変数は大文字と小文字を区別しません。
- マクロ機能で使用する場合、各パラメーターに指定できる変数は 1 つだけです。
- アプリケーション変数に使用される形式は、app_var_VarName です。
- アプリケーション変数はシステムレベルで宣言され、サイクルレベルで上書きできます。
- アプリケーション変数はランタイム変数で、現在のサイクルのバージョンで置換できます。
パラメーターの詳細については、「パラメーター変数」を参照してください。
マクロコマンドでマッピングされている場合、コンテキストパラメーター (%itemcontext%、%locationcontext%、%periodcontext%) には次のプロパティがあります。
- この変数は、ワークシートからマクロを実行するときに、現在のコンテキスト値を選択します。注:
- メインワークシートのツールバーの [ ] オプションを使用してマクロを実行する場合、現在のモジュールのデータコンテキストが使用されます。
- 現在のワークシートの [ ] オプションを使用してマクロを実行する場合、そのディメンションに対する現在のワークシートのデータコンテキストが使用されます。
- ワークシート以外からマクロを実行する場合 (サイクル期間の詳細やシナリオの詳細ページなど)、値は代入されず、マクロの実行は失敗します。
マクロコマンドでマッピングされている場合、コンテキストパラメーター (%measurecontext%) には次のプロパティがあります。
- この変数は、ワークシートからマクロを実行するときに、現在のコンテキスト値を取得します。注:
- メインワークシートのツールバーの [ ] オプションを使用してマクロを実行する場合、またはワークシートにメジャーコンテキストが渡されていない場合、値は代入されず、マクロの実行は失敗します。
- マルチパネルワークシートのターゲットパネルで [ ] オプションを使用してマクロを実行する場合、現在のワークシートのメジャーコンテキストが使用されます。
- ワークシート以外からマクロを実行する場合 (サイクル期間の詳細やシナリオの詳細ページなど)、値は代入されず、マクロの実行は失敗します。
コンテキストパラメーター (%cyclecontext%、%cycleperiodcontext%、%scenariocontext% および %modelcontext%) がマクロコンテキストからキャストされる場合、次のようになります。
- CyclePeriod マクロには、サイクルコンテキスト (cyclecontext) およびサイクル期間コンテキスト (cycleperiodcontext) があります。
- コマンド RunScenarioMacro を含むサイクル期間マクロは、ワークシートからの実行時にシナリオコンテキスト (scenariocontext) を使用できます。注:
- メインワークシートのツールバーの [ ] オプションを使用してマクロを実行する場合、現在の有効なモジュールのデータコンテキストが使用されます。
- 現在のワークシートで [ ] オプションを使用してマクロを実行する場合、現在の有効なワークシートのデータコンテキスト (%scenariocontext%) が使用されます。たとえば、パネルリンク (該当する場合) またはモジュールのデータコンテキストからコンテキストが渡されます。
- シナリオマクロには、サイクルコンテキスト(cyclecontext)、サイクル期間コンテキスト (cycleperiodcontext)、およびシナリオコンテキスト (scenariocontext) があります。シナリオコンテキストは、次のようにマクロ開始プロセスに依存します。
- サイクル期間の詳細またはシナリオの詳細ページからシナリオマクロが実行される場合、現在のシナリオコンテキストが使用されます。
- メインワークシートのツールバーの [ ] オプションからマクロが実行される場合、現在のモジュールのデータコンテキストが使用されます。
- 現在のワークシートの [ ] オプションからマクロが実行される場合、現在のワークシートのコンテキスト (%scenariocontext%) が使用されます。
- コマンド RunCyclePeriodMacro を含むシステムマクロは、ワークシートからの実行時に、サイクルコンテキスト、サイクル期間コンテキストを使用できます。
- コマンド RunScenarioMacro を含むシステムマクロは、ワークシートからの実行時に、サイクルコンテキスト、サイクル期間コンテキスト、シナリオコンテキストを使用できます。
- 現在のワークシートの [ ] オプションからマクロが実行される場合、現在のワークシートのコンテキスト (%scenariocontext%) が使用されます。たとえば、パネルリンクから渡されたコンテキスト (該当する場合)、またはモジュールのデータコンテキストです。
- RunASMacro コマンドを含むシステムマクロは、Advanced Scheduling モデルの詳細からの実行時に、モデルコンテキストを使用できます。
- その他のシステムマクロコマンドには、コンテキストが含まれていません。したがって、値は代入されず、マクロの実行は失敗します。
%previouscycleperiod-Startdate% パラメーターおよび %previouscycleperiod-Enddate% パラメーターには、前のサイクル期間がない場合、%horizon-start% (最初の使用可能な期間) が使用されます。
実行されている関数に対してパラメーターが無効である場合、プログラムは終了し、エラーメッセージが表示されます。