シナリオレベルの RunInterfaceService (エクスポート)
RunInterfaceService (エクスポート) マクロは、現在のシナリオの計画データをエクスポートするインターフェースサービスを実行するために使用されます。このマクロはシナリオレベルで実行されます。
次の表に、RunInterfaceService (エクスポート) マクロの実行に使用するパラメーターを示します。
パラメーター | 説明 |
---|---|
インターフェースサービス名 | 実行されるインターフェースサービスの名前。 |
方向 | データフローの方向。値は「エクスポート」に設定する必要があります。 |
品目階層ノード | エクスポートする品目。 注: 値が指定されていない場合、すべての品目がエクスポートされます。
|
場所階層ノード | エクスポートする品目の場所。 注: 値が指定されていない場合、すべての場所がエクスポートされます。
|
カレンダータイプ | データのエクスポート対象期間。次のような値があります。
注: 値が指定されていない場合、開始バケット期間が考慮されます。
|
期間ラベル | エクスポートするサイクル期間。これはローリング期間ノードをサポートしています。 注:
|
期間数 | エクスポートする期間レベルの期間数。期間レベルがシナリオ値を保存するカレンダーレベルと等しくない場合、または [テレスコープ] オプションが有効になっている場合、選択した期間内のすべての基本バケットがエクスポートされます。次のような値があります。
|
期間レベル | エクスポートに [期間数] が使用するカレンダー期間レベル。 注: 値が指定されていない場合、期間数はシナリオ値を保存するカレンダーレベルに基づきます。
|
フィルター | 品目および場所の選択を決定するために使用するフィルター。指定の基準に一致する選択された品目と場所に関連するデータのみがエクスポートされます。 |
[コマンド] フィールドの値を次の形式で指定する必要があります。RunInterfaceService (インターフェースサービス名、方向、[品目階層ノード]、[場所階層ノード]、[カレンダータイプ]、[期間ラベル]、[期間数]、[期間レベル]、[フィルター])
注: オプションパラメーターは [ ] で指定します。
要件 | パラメーター |
---|---|
サイクル期間範囲の現在の計画期間から、すべての場所のすべての品目をエクスポートする。 | RunInterfaceService("Export Scenario file","Export","","","Current Bucket","") |
シナリオ値を保存するために、カレンダーバケット「現在の年」の間の場所の GOO 品目をカレンダーレベルでエクスポートします (テレスコープバケットは定義されていません)。 | RunInterfaceService("Export Scenario file","Export","GOO","","Bucket","Current Year","0") |
現在の計画期間のすべての場所の GOO 品目をエクスポートします。たとえば、1 か月の「FY10 M03」 (シナリオ値を保存するサイクルカレンダーレベル = 月) などです。 | RunInterfaceService("Export Scenario file","Export","GOO","","Current Bucket","1") |
現在のサイクル期間の 52 週間について、場所が US のすべての品目をエクスポートします (シナリオ値を保存するサイクルカレンダーレベルが週の場合)。 | RunInterfaceService("Export Scenario file","Export","","US","Current Bucket","52") |
9 か月間のカレンダーバケット「FY10 M03」のすべての場所のすべての品目をエクスポートします (シナリオ値を保存するサイクルカレンダーレベルが月の場合)。 | RunInterfaceService("Export Scenario file","Export","","","Bucket","FY10 M03","9") |
サイクル期間範囲のすべての期間、すべての場所のすべての品目をエクスポートします。最初の (最も古い) 履歴期間から開始します。 | RunInterfaceService("Export Scenario file","Export","","","","") |
シナリオ値を保存するカレンダーレベルで、7 期のすべての場所のすべての品目をエクスポートします。サイクル期間範囲の最初 (最も古い) 期間から開始します。サイクル期間が履歴として指定される場合 = 6、将来 = 6結果として、6 つの履歴期間および 1 つの将来の期間がエクスポート処理されます (テレスコープバケットは定義されません)。 | RunInterfaceService("Export Scenario file","Export","","","Start Bucket","7") |
pconst が 0 < [DPLS_FUNITS] であるすべての場所の GOO 品目をエクスポートします。たとえば、1 か月間の「FY10 M03」があります (シナリオ値を保存するサイクルカレンダーレベル = 月、テレスコープバケットが定義されていない場合)。 | RunInterfaceService("Export Scenario file","Export","GOO","","Current Bucket","1","", "0 < [DPLS_FUNITS]"). |
3 か月のカレンダーバケット「FY10 M03」の週の期間から、すべての場所のすべての品目をエクスポートします (シナリオ値を保存するサイクルカレンダーレベルが週の場合)。 | RunInterfaceService("Export Scenario file","Export","","","Bucket","FY10 M03","3", "Months") |
現在の計画期間のすべての場所の GOO 品目をエクスポートします。たとえば、週単位の 1 か月の「FY10 M03」などです (シナリオ値を保存するサイクルカレンダーレベル = 週、テレスコープバケットは定義されていません)。 | RunInterfaceService("Export Scenario file","Export","GOO","","Current Bucket","1","Months") |
現在の計画期間のすべての場所の GOO 品目をエクスポートします。たとえば、1 か月のサイクルでテレスコープが有効になっている場合の「FY10 M03」などです。シナリオ値を保存するサイクルカレンダーレベル = 週、サイクルのテレスコープ期間 = 7 日、将来の期間 = 8 週間とします。結果はテレスコープの 1 か月、基本バケット、つまり 7 日バケット、3 週単位のバケットです。 | RunInterfaceService("Export Scenario file","Export","GOO","","Current Bucket","1","Months") |
検証およびエラーメッセージ
次の表に、サイクル期間の状況および関連する検証メッセージを示します。
サイクル期間の状況 | シナリオの状況 | 実行可 | 検証メッセージ |
---|---|---|---|
保留中 | N/A | いいえ | サイクル期間の状況が「保留中」であるため、マクロ {0} を実行できません。 |
実行中 | 任意 | はい | N/A |
完了済 | 任意 | はい | N/A |
中止済 | 任意 | はい | N/A |
一時停止 | 任意 | はい | N/A |
アーカイブ済 | 任意 | いいえ | サイクル期間の状況が「アーカイブ済」であるため、マクロ {0} を実行できません。 |
マクロの検証と実行に成功すると、現在のシナリオの計画データがエクスポートされます。検証に失敗した場合、マクロは中止され、関連するエラーメッセージが表示されます。次の表は、さまざまな検証エラーで表示されるエラーメッセージを示しています。
検証条件/ルール | エラーメッセージ |
---|---|
渡されたインターフェースサービスが有効であることを確認します。 | インターフェースサービス "{0}" が見つかりません。 |
選択したインターフェースサービスデータエンティティが現在のマクロコンテキストに適用されない場合、マクロは実行されません。つまり、 RunInterfaceService は、データエンティティ = シナリオ値のインターフェースのみ実行できます。 | インターフェースサービス {0} は、シナリオマクロに必要なデータエンティティに一致しません。 |
方向が選択したインターフェースサービスのインターフェース方向と一致しない場合、マクロは実行されません。 | 方向パラメーター {0} が、選択したインターフェースサービス {1} の方向と一致しません。 |
カレンダーレベルがシナリオ値を保存するカレンダーレベル以上でない場合、警告メッセージが表示され、インポート処理は中止されます。 | カレンダーレベル {0} がシナリオ値を保存するカレンダーレベル {1} を下回っています。 |
サイクル期間コンテキストの RunInterfaceService は、実行中、一時停止、完了済、中止済の状況にあるサイクル期間に属している必要があります。 | RunInterfaceService を状況 {0} のサイクル期間に対して実行できません。 |
サイクル期間コンテキストで RunInterfaceService を実行するとき、選択したインターフェースサービスが、現在のサイクル期間のカレンダーに一致するカレンダーを参照している必要があります。そうでない場合、マクロは実行されません。 | インターフェースサービス {0} で参照されるカレンダーは、現在のサイクル期間のカレンダーと一致しません。 |
エクスポートのために RunInterfaceService を実行するとき、期間レベル (指定されている場合) が有効であることを確認します。 | 期間レベル {0} が見つかりません。 |
エクスポートのために RunInterfaceService を実行するとき、期間レベル (指定されている場合) がシナリオ値を保存するためにカレンダーレベル以上であることを確認します ([テレスコープ] オプションが有効になっていない場合)。 | 期間レベル {0} が、シナリオ値を保存するカレンダーレベル {1} を下回っています。 |