同時実行プログラムに対する操作
Oracle E-Business Suite の同時実行プログラムは、Microsoft BizTalk Adapter for Oracle E-Business Suite の操作として表示されます。 Oracle E-Business アダプターは、Oracle アプリケーションに固有の同時実行プログラムと共に、Get_Status、Wait_For_Request、Submit_Requestの 3 つの標準操作も提供します。 これは、Oracle アプリケーションに 2 つの同時実行プログラムがある場合、5 つの操作 (同時実行プログラムごとに 1 つ、標準操作に 3 つ) が公開されることを意味します。
参照:
同時プログラムの参照と検索については、「 Oracle E-Business Operations のメタデータの参照、検索、および取得」を参照してください。
Oracle E-Business アダプターで同時実行プログラムを呼び出す方法については、「BizTalk Serverを使用して Oracle E-Business Suite で同時実行プログラムを呼び出す」を参照してください。
重要
同時実行プログラムに対して操作を実行する前に、Oracle E-Business アダプターで同時実行プログラムのアプリケーション コンテキストを設定する必要があります。 これは、アプリケーション コンテキストを設定すると、成果物のユーザー設定 (責任、organization、言語設定など) とアクセス制御を設定することで、Oracle E-Business Suite でのセキュリティで保護されたトランザクションが容易になるためです。 アプリケーション コンテキストとその設定方法については、「アプリケーション コンテキストの設定アプリケーションコンテキストの設定」を参照してください。
以降のセクションでは、同時実行プログラムに対して Oracle E-Business アダプターによって公開される操作について説明します。
<> Concurrent_Program_Name操作
前述のように、Oracle Aapplication の同時実行プログラムの数と同じ数 <のConcurrent_Program_Name> 操作が行われます。 Concurrent_Program_Name>操作では<、複合型の 3 つと単純型の 2 つの 5 つの標準パラメーターを受け取ります。
Note
メタデータを公開しない同時実行プログラムの場合、Oracle E-Business アダプターは、これらの同時実行プログラムごとに 100 個の省略可能なパラメーターを公開します。 これらの同時実行プログラムを正常に呼び出すには、Oracle E-Business Suite のドキュメントを参照して、値を必要とする同時実行プログラムのパラメーターを調べ、それらを指定する必要があります。 このような同時プログラムの例として、総勘定元帳アプリケーションの履歴インポート (実際の名前: GLLEZL) があります。
複合型パラメーター
SetOptions: 要求を送信する前に、同時実行プログラムのオプションを設定できます。 SetOptions は、次のオプションをパラメーターとして受け取ります。
暗黙的: Oracle E-Business Suite のユーザーの同時実行要求フォームに同時実行要求を表示するかどうかを示します。 次の 4 つの値のいずれかを指定できます: いいえ、 はい、 エラー または 警告です。 [いいえ] を指定すると、Oracle E-Business Suite のユーザーの同時要求フォームに要求が表示されます。 [はい] を指定すると、システム管理者の特権同時要求フォームからのみ要求を表示できます。 Error を指定すると、失敗した場合にのみ、ユーザーの同時要求フォームに要求が表示されます。 警告を指定すると、警告またはエラーがある場合にのみ、要求がユーザーの同時要求フォームに表示されます。
Protected: Oracle E-Business Suite の [同時実行要求] フォームを使用して行われた更新から同時実行要求を保護するかどうかを示します。 [ はい (保護)] または [ いいえ (保護されていない)] を指定できます。
言語: 各国語サポート (NLS) 言語を示します。 値が指定されていない場合は、既定で現在の言語になります。
Territory: 言語領域を示します。 値が指定されていない場合は、既定で現在の言語領域が使用されます。
ContinueOnFail: SetOptions が失敗した場合に、同時要求の送信を続行するか、例外をスローするかを示します。 True (続行) または False (例外をスロー) を指定できます。
SetPrintOptions: 要求を送信する前に、同時実行プログラムの印刷オプションを設定できます。 SetPrintOptions は、次のオプションをパラメーターとして受け取ります。
プリンター: 同時要求出力を送信するプリンター名を示します。 この印刷オプションが Oracle E-Business Suite の [同時実行プログラム] フォームに既に設定されている場合は、この印刷オプションをオーバーライドできません。
スタイル: 同時要求出力の印刷に使用される印刷スタイルを示します。 たとえば、向き (横 または 縦) を指定できます。 Oracle E-Business Suite の [同時実行プログラム] フォームで印刷スタイルが既に設定されていて、[スタイルが必要なチェック] ボックスが選択されている場合は、この印刷オプションをオーバーライドできません。
コピー: 同時要求出力の印刷する部数を示します。
SaveOutput: 出力ファイルを保存するかどうかを示します。 [はい] または [いいえ] を指定できます。
PrintTogether: サブ要求を含む要求にのみ適用されます。 サブ要求の出力の出力方法を示します。 Y を指定した場合、サブ要求の出力は、すべてのサブ要求が完了した後にのみ出力されます。 N を指定した場合、各サブ要求の出力は完了時に出力されます。
ContinueOnFail: SetPrintOptions が失敗した場合に、同時要求の送信を続行するか、例外をスローするかを示します。 True (続行) または False (例外をスロー) を指定できます。
SetRepeatOptions: 要求を送信する前に、同時実行プログラムの繰り返しオプションを設定できます。 SetRepeatOptions は、 次のオプションをパラメーターとして受け取ります。
RepeatTime: 同時実行要求を繰り返す時刻を示します。
RepeatInterval: このパラメーターは、 RepeatTime が NULL の場合にのみ適用されます。 要求の再送信間隔を示します。 このオプションを RepeatUnit と共に使用して、再送信の間隔を指定します。
RepeatUnit: このパラメーターは、 RepeatTime が NULL の場合にのみ適用されます。 要求の再送信の間隔を指定するために RepeatInterval と共に使用される時間の単位。 分、時間、日、または月を指定できます。
RepeatType: このパラメーターは、 RepeatTime が NULL の場合にのみ適用されます。 同時実行要求実行の "開始" の後、または同時要求実行の "終了" の後に繰り返し間隔を適用するかどうかを示します。
RepeatEndTime: 同時実行要求の再送信を停止する日時を示します。
ContinueOnFail: SetRepeatOptions の場合に、同時要求の送信を続行するか、例外をスローするかを示します。 True (続行) または False (例外をスロー) を指定できます。
単純型パラメーター
説明: 同時実行要求の説明。
StartTime: 同時実行要求の実行を開始する時刻を示します。
Get_Status操作
標準操作Get_Statusは、同時プログラムの要求フェーズ/状態と完了メッセージを返します。 この操作は、同時実行プログラム (RequestID) の要求 ID を入力として受け取り、次の情報を返します。
フェーズ: FND_LOOKUPSからのユーザー フレンドリな要求フェーズ。
状態: FND_LOOKUPSからのわかりやすい要求の状態。
DevPhase: プログラム ロジックの比較に使用できる文字列としての要求フェーズ。
DevStatus: プログラム ロジックの比較に使用できる文字列としての要求の状態。
メッセージ: 要求が完了した場合の完了メッセージ。
Wait_For_Request操作
標準操作Wait_For_Request、要求の完了を待機し、要求フェーズ/状態と完了メッセージを返します。 この操作は、同時実行プログラム (RequestID) の要求 ID、チェック (Interval)、および要求の完了 (MaxWait) を入力パラメーターとして待機する最大時間 (秒) の間に待機する秒数を受け取り、Get_Status操作と同じ情報を返します。
Submit_Request操作
標準操作Submit_Requestは、同時実行マネージャーによる同時処理要求を送信します。 要求が正常に完了すると、この操作は同時実行要求 ID を返します。 それ以外の場合は、"0" を返します。
Submit_Request操作では、6 つの標準パラメーター (複合型の単純型のそれぞれ 3 つ) を受け取ります。 これらのパラメーターとは別に、同時実行プログラムの引数も文字列の配列として受け取ります。
複合型パラメーター
Submit_Request操作は、 SetOptions、 SetPrintOptions、 および SetRepeatOptions を 入力パラメーターとして受け取ります。 これらのパラメーターの詳細については、このセクションの「Concurrent_Program_Name>操作」を参照してください<。
単純型パラメーター
プログラム: 要求を送信する同時実行プログラムの短い名前。
説明: 同時実行要求の説明。
StartTime: 同時実行要求の実行を開始する時刻。