サイクル期間レベルの RunInterfaceService (エクスポート)

RunInterfaceService (エクスポート) マクロは、サイクル期間のコンテキストでカレンダーデータをエクスポートするインターフェースサービスを実行するために使用されます。このマクロはサイクル期間レベルで実行されます。
次の表に、RunInterfaceService (エクスポート) マクロの実行に使用するパラメーターを示します。
パラメーター 説明
インターフェースサービス名 実行されるインターフェースサービスの名前。
方向 データフローの方向。
注: この値は、マクロ作成時には「エクスポート」に設定されます。
カレンダータイプ データのエクスポート対象期間。次のような値があります。
  • バケット: 「期間ラベル」で指定されている期間であり、[期間ラベル]、[期間数]、および [期間レベル] パラメーターを使用します。
  • 現在のバケット: 現在の計画期間。[期間数] および [期間レベル] のみを使用します。
  • 開始バケット: サイクル期間範囲の最初 (最も古い) 期間でも、すべてのバケットを検索するために使用できます。[期間数] および [期間レベル] が使用されます。
注: 値が指定されていない場合、開始バケット期間が考慮されます。
期間ラベル データのエクスポート開始期間。これはローリング期間ノードをサポートしています。
注: 
  • このフィールドは、カレンダータイプがバケットに設定されている場合にのみ適用されます。
  • 値が指定されない場合は、現在の計画期間が考慮されます。
期間数 エクスポートする期間レベルの期間の数。期間レベルが計画を保存するカレンダーレベルと等しくない場合、または [テレスコープ] オプションが有効になっている場合は、選択された期間の指定範囲内の基本バケットがすべてエクスポートされます。次のような値があります。
  • Null: サイクル期間範囲の最後までのすべての基本期間がエクスポートされます。
  • 0: カレンダータイプが「バケット」に設定されている場合、期間ラベルで指定されている期間に属するすべての基本バケットがエクスポートされます。
  • >=1: 指定した開始期間から開始する、期間レベルバケットの [期間数] に属するすべての基本期間がエクスポートされます。
期間レベル エクスポートで [期間数] が使用するカレンダー期間レベル。
注: この値が指定されていない場合、期間数はシナリオ値を保存するカレンダーレベルに基づきます。
コマンド フィールドの値を次の形式で指定する必要があります。RunInterfaceService (インターフェースサービス名、方向、[カレンダータイプ]、[期間ラベル]、[期間数]、[期間レベル])
注: オプションパラメーターは [ ] で指定します。
表 1. 例
要件 パラメーター
シナリオ値を保存するために、現在の計画期間からサイクル期間範囲までの基本カレンダー期間をカレンダーレベルでエクスポートします (テレスコープ期間は定義されていません)。 RunInterfaceService("My AP Calendar","Export","Current Bucket","")
シナリオ値を保存するために、現在の計画期間から 6 バケットの基本カレンダー期間をカレンダーレベルでエクスポートします。 RunInterfaceService("My AP Calendar","Export","Current Bucket","6")
シナリオ値を保存するために、期間 FY14 M12 から 10 期間の基本カレンダー期間をカレンダーレベルでエクスポートします。 RunInterfaceService("My AP Calendar","Export","Bucket","FY14 M12","10")
FY14 M12 の期間から 10 か月のベースカレンダー期間をエクスポートします。 RunInterfaceService("My AP Calendar","Export","Bucket","FY14 M12","10", "Months")

テレスコープの 1 か月、カレンダーデータの基本バケットを現在の計画期間からエクスポートします。たとえば、サイクルで [テレスコープ] オプションが有効になっている場合、「FY14 M12」などです。計画を保存するサイクルカレンダーレベル = 週、サイクルのテレスコープ期間 = 7 日、将来の期間 = 8 週間とします。

結果は 1 か月のテレスコープ、基本バケット、つまり 7 日バケット、3 週単位のバケットです。

 RunInterfaceService("Export Scenario file","Export","Current Bucket","1","Months")

検証およびエラーメッセージ

次の表に、サイクル期間の状況および関連する検証メッセージを示します。
サイクル期間の状況 シナリオの状況 実行可 検証メッセージ
保留中 N/A いいえ サイクル期間の状況が「保留中」であるため、マクロ {0} を実行できません。
実行中 任意 はい N/A
完了済 任意 はい N/A
中止済 任意 はい N/A
一時停止 任意 はい N/A
アーカイブ済 任意 いいえ サイクル期間の状況が「アーカイブ済」であるため、マクロ {0} を実行できません。
指定されたサイクル期間のコンテキストで、マクロの検証と実行に成功したカレンダーデータがエクスポートされます。検証に失敗した場合、マクロは中止され、関連するエラーメッセージが表示されます。次の表は、さまざまな検証エラーで表示されるエラーメッセージを示しています。
検証条件/ルール エラーメッセージ
渡されたインターフェースサービスが有効であることを確認します。 インターフェースサービス "{0}" が見つかりません。
方向が選択したインターフェースサービスのインターフェース方向と一致しない場合、マクロは実行されません。 方向パラメーター {0} が、選択したインターフェースサービス {1} の方向と一致しません。
カレンダーレベルがシナリオ値を保存するカレンダーレベル以上でない場合、警告メッセージが表示され、インポート処理は中止されます。 カレンダーレベル {0} がシナリオ値を保存するカレンダーレベル {1} を下回っています。
サイクル期間コンテキストの RunInterfaceService は、実行中、一時停止、完了済、中止済の状況にあるサイクル期間から実行する必要があります。 RunInterfaceService を状況 {0} のサイクル期間に対して実行できません。
選択したインターフェースサービスデータエンティティが現在のマクロコンテキストに適用されない場合、マクロは実行されません。つまり、RunInterfaceService は、サイクル期間コンテキスト内で、データエンティティ = カレンダーのインターフェースのみ実行できます。 インターフェースサービス {0} は、サイクル期間マクロに必要なデータエンティティに一致しません。
サイクル期間コンテキストで RunInterfaceService を実行するとき、選択したインターフェースサービスが、現在のサイクル期間のカレンダーに一致するカレンダーを参照している必要があります。そうでない場合、マクロは実行されません。 インターフェースサービス {0} で参照されるカレンダーは、現在のサイクル期間のカレンダーと一致しません。
エクスポートのために RunInterfaceService を実行するとき、期間レベル (指定されている場合) が有効であることを確認します。 期間レベル {0} が見つかりません。
エクスポートのために RunInterfaceService を実行するとき、期間レベル (指定されている場合) が、計画を保存するカレンダーレベル以上であることを確認します ([テレスコープ] オプションが有効になっていない場合)。 期間レベル {0} が、シナリオ値を保存するためのカレンダーレベル {1} を下回っています。