CallForecastEngine マクロ

CallForecastEngine マクロは指定した予測エンジンをコールし、選択した品目および場所についての予測を作成します。

これにより、選択された品目/場所の基本レベルでの予測を作成できます。または出力がシナリオ値を保存する適切なレベルに対して比例配分され、選択内容についてのグループ化された予測を作成できます。このマクロはシナリオレベルで実行されます。

次の表に、マクロで使用するパラメーターを示します。
パラメーター名 説明
エンジン名 コールする予測エンジンの名前。エンジンはエンジンのタイプおよびデフォルト設定を決定します。
注: 現在のサイクルおよびモジュールで、このパラメータを定義する必要があります。
アルゴリズム 予測作成プロセスで使用されるアルゴリズム。次のような値があります。
  • BATS
  • BEST
  • Crostons
  • EVENTSONLY
  • EXPONENTIALMOVINGAVERAGE
  • HOLTWINTERS
  • LEASTSQUARES
  • MOVINGAVERAGE
  • MULTIPLEREGRESSION
注: 
  • 未定義の場合、指定されたエンジンのデフォルトのアルゴリズムが使用されます。
  • エンジン設定でデフォルトのアルゴリズムが定義されていない場合、BEST が使用されます。
品目階層レベル 予測エンジンが予測を作成する (品目階層の) レベル。
注: 指定されていない場合、予測エンジン設定のデフォルト値が使用されます。
品目階層の選択 品目の選択を決定する品目階層レベルの基本要素。値はノードとして渡されます。たとえば、「Brand A」などです。
注: 
  • 未定義の場合、有効な品目はすべて処理されます。
  • 品目を選択するさいに、ユーザーのデータセキュリティルールに従う必要があります。
場所階層レベル 予測エンジンが予測を作成する (場所階層の) レベル。
注:  指定されていない場合、予測エンジン設定のデフォルト値が使用されます。
場所階層の選択 場所の選択を決定する場所階層レベルの基本要素。値はノードとして渡されます。たとえば、「EMEA」などです。
注: 
  • 未定義の場合、有効な品目はすべて処理されます。
  • 品目を選択するさいに、ユーザーのデータセキュリティルールに従う必要があります。
最適化 予測エンジンの最適化プロセスを示します。次のような値があります。
  • オン: エンジンは、予測を計算する前に、渡されたデータセットに基づいてパラメータを最適化する必要があります。
  • オフ: 渡されたパラメーターとデフォルト値が予測計算に使用されます。
注: 
  • 指定されていない場合、予測エンジン設定のデフォルト値が使用されます。
  • このフィールドは、BEST または Holt-Winter アルゴリズムにのみ適用されます。
フィルター 指定した品目と場所階層レベルで、選択した品目および場所に適用可能なフィルター基準。
注: 
  • 指定された期間ラベルについて基準を渡す場所の品目が予測作成で使用されます。
  • 指定されていない場合は、フィルタ基準は適用されません。
マクロを実行するには、[コマンド] フィールドの値を次の形式で指定する必要があります。エンジン名、[アルゴリズム]、[拡散メジャーコード]、[品目階層レベル]、[品目階層の選択]、[場所階層レベル]、[場所階層の選択]、[SMP メジャー]、[最適化]、[フィルター]
注: オプションパラメーターは [ ]で指定します。

マクロ実行時に状況が「実行中」に変更され、マクロが処理中であることを示します。処理が完了すると、状況が「完了」に変更されます。

BEST アルゴリズムを使用する際、マクロは fitModelPickingAlgorithm() で予測エンジンをコールし、最も低い決定基準でアルゴリズムを使用して適合します。選択したアルゴリズムは出力として返されます。

BEST 以外のアルゴリズムでは、予測エンジンのコールに fitModelGivenAlgorithm() が使用されます。

表 1. 例
要件 パラメーター
「テストエンジン」をコールして、すべてのデフォルトのエンジン設定を渡すとともに、すべての品目および場所の計算を行います。結果はデフォルトの拡散メジャーを使用して拡散されます。 CallForecastEngine("Test Engine")
デフォルトのエンジンアルゴリズムを使用して、品目階層のブランド A ノードの有効な SKU レベル、場所階層の US ノードの顧客ベルの場所について、「BATS エンジン」をコールします。指定されたレベルがシナリオ値を保存するレベルと等しいため、拡散は必要ありません。 CallForecastEngine("BATS engine","","","SKU","Brand A","Customer","US")
デフォルトのエンジンアルゴリズムを使用して「BATS エンジン」を呼び出し、品目階層のブランド A を集計し、場所階層の地域ノード US を集計します。エンジン (TUPLE_EXISTS) に定義された拡散メジャーを使用して、結果を基本品目および場所 Cycle.level に拡散し、シナリオ値を保存する必要があります。 CallForecastEngine("BATS Engine","","","Brand","Brand A","Region","US")
「新規エンジン」をコールし、LEASTSQUARES アルゴリズムを渡し、TUPLE_EXISTS メジャーを介して結果を基本品目と場所に拡散し (予測エンジンで定義されたとおり)、すべての製品グループおよびすべての地域を月単位のカレンダーレベルで計算します (エンジンの期間レベルで指定されたおり)。 CallForecastEngine("New Engine","LeastSquares","","Product Groups","","Regions","","","")
「ベストフィット」をコールし、Best (Picking) アルゴリズムを渡し、エンジンで定義されている拡散メジャーを通して拡散し、すべての製品グループおよびすべての地域を計算します。パラメーター最適化は、アルゴリズムを選択して予測を生成する前に行われます。 CallForecastEngine("Best Fit","BEST","","Product Groups","","Regions","","","TRUE")

マクロの実行時に検証が実行されます。いずれかの検証に失敗した場合、マクロは中止され、関連するエラーメッセージが表示されます。

次の表に、シナリオマクロコマンドと、対応するサイクル期間/シナリオの状況および検証メッセージを示します。
サイクル期間の状況 シナリオの状況 実行可 検証メッセージ
保留中 N/A いいえ サイクル期間の状況が「保留中」であるため、マクロ {0} を実行できません。
実行中 WIP はい N/A
実行中 確認、拒否、停止、承認済、公開済 いいえ シナリオの状況が {1} であるため、マクロ {0} を実行できません。
一時停止 任意 いいえ サイクル期間が「実行中」でないため、マクロ {0} を実行できません。
完了済 任意 いいえ サイクル期間の状況が「完了」であるため、マクロ {0} を実行できません。
中止済 停止済 いいえ サイクル期間の状況が「中止済」であるため、マクロ {0} を実行できません。
アーカイブ済 任意 いいえ サイクル期間の状況が「アーカイブ済」であるため、マクロ {0} を実行できません。
次の表に、マクロの実行中に表示されるエラーメッセージを示します。
検証条件 エラーメッセージ
予測エンジン名が存在することを確認します。 予測エンジン {0} が見つかりません。
指定されている場合、または予測エンジン設定で定義されているデフォルトを使用して、メジャーがこの cycle.Module に対して有効であることを確認し (パラメーターマッピングと拡散メジャー)、有効にします。 メジャー"{0}"が見つかりません。
指定されている場合、または予測エンジン設定で定義されているデフォルトを使用して、品目レベルを確認します。 品目階層レベル {0} が見つかりません。
指定されている場合、または予測エンジン設定で定義されているデフォルトを使用して、場所レベルが有効であることを確認します。 場所階層レベル {0} が見つかりません。
指定されている場合、または予測エンジン設定で定義されているデフォルトを使用して、期間レベルが有効であることを確認します。BATS タイプのエンジンでは、指定されたカレンダーレベルは月でなければなりません。

期間レベル {0} が見つかりません。

期間レベル {0} はエンジンタイプ = BATS の月またはカレンダー月でなければなりません。
指定されている場合、品目および場所ノードが有効であることを確認します。 品目 {0} が見つかりません。

場所 {0} が見つかりません。
指定されている場合、アルゴリズムが有効であることを確認します。 指定されたアルゴリズム {0} はサポートされていません。有効なエントリ: (Best、BATS、Crostons、EventsOnly、ExponentialMovingAverage、HoltWinters、LeastSquares、MovingAverage および MultipleRegression)
指定されている場合、または予測エンジン設定で定義されているデフォルトを使用して、メジャーがマーケットインテリジェンスタイプのメジャー (パラメーターマッピング) として定義されていないことを確認します。 メジャー {0} は、タイプ「マーケットインテリジェンス」にすることはできません。
指定されている場合、または予測エンジン設定で定義されているデフォルトを使用して、メジャーがトランザクションデータタイプのメジャー (パラメーターマッピング) として定義されていないことを確認します。 メジャー {0} は、タイプ「トランザクションデータ」にすることはできません。
指定されている場合、または予測エンジン設定で定義されているデフォルトを使用して、メジャーがオーダータイプメジャー (パラメーターマッピング) として定義されていないことを確認します。 メジャー {0} はオーダータイプにできません。
ユーザーは予測エンジンを実行するアクセス許可を持っている必要があります。 モジュール "{0}" での予測生成は、ユーザー "{1}" に対して許可されていません。