ATPToSalesOrder コラボレーション・テンプレートは、ATP チェックが Sales Order の作成および更新プロセスに依存するときに使用されます。ATPToSalesOrder は、汎用 Order ビジネス・オブジェクトをサブスクライブし、販売注文の製品の利用可能在庫データを更新します。
この節では、ポート・バインディングについて説明し、ATPToSalesOrder に基づくコラボレーション・オブジェクトをセットアップするために必要なステップを説明します。コラボレーション・テンプレートの標準の機能、ポート、および構成プロパティーについて、およびコラボレーション・オブジェクト作成に関する一般情報については、『Required Documents for Creating Collaboration Objects』にリストされている文書を参照してください。
図 1 に、System Manager で表示される ATPToSalesOrder コラボレーションのポートを示します。
図 1. ATPToSalesOrder コラボレーションのポート
注: コラボレーション・オブジェクトでポートを使用しないようにするには、そのポートをポート・コネクターにバインドしてください。これにより、コラボレーション・オブジェクトが追加機能を提供せずに、そのポートは未使用として示されます。
ビジネス・オブジェクト | バインド先 | 機能 | 使用される動詞 |
---|---|---|---|
Order | ソース (バイヤー側) アプリケーションのコネクター | トリガー・ビジネス・オブジェクトを受け取ります。コラボレーションが正常に終了した場合、このポートは、同期呼び出しの最後に、トリガー・ビジネス・オブジェクトをソース・アプリケーションに戻します。 |
Create Update Delete |
ビジネス・オブジェクト | バインド先 | 機能 | 使用される動詞 |
---|---|---|---|
ATP | ATP コラボレーション | 送信されるオブジェクト。 | Retrieve |
ビジネス・オブジェクト | バインド先 | 機能 | 使用される動詞 |
---|---|---|---|
Order | SalesOrderProcessing コラボレーション | SalesOrderProcessing コラボレーションに送信されるオブジェクト。 |
Create Update Delete |
ビジネス・オブジェクト | バインド先 | 機能 | 使用される動詞 |
---|---|---|---|
Order | ソース (バイヤー側) アプリケーションのコネクター | このオブジェクトは、ATP および SalesOrderProcessing コラボレーションが正常に終了し、制御を ATPToSalesOrder コラボレーションに戻した後、ソース・アプリケーションに戻されます。 |
Update |
この節では、このコラボレーション・テンプレートのプロセス・ロジックについて説明します。
図 2 に、ATPToSalesOrder のプロセス・ロジックを示します。
図 2. ATPToSalesOrder コラボレーションのプロセス・ロジック
このコラボレーション・テンプレートでは、以下の標準コラボレーション・ビジネス・プロセスが使用されます。
これらのビジネス・プロセスについては、『Required Documents for Creating Collaboration Objects』を参照してください。
注: ATPToSalesOrder には、Retrieve シナリオは含まれません。ATPToSalesOrder のプロセス・ロジックには、汎用 Order オブジェクトを汎用 ATP オブジェクトにマッピングし、それを ATP コラボレーションに送信する ATP トランザクション・サブプロセスが含まれています。ATP コラボレーションは、応答 ATP ビジネス・オブジェクトを ATPToSalesOrder コラボレーションに戻し、それが Order ビジネス・オブジェクトに再びマッピングされ、SalesOrderProcessing コラボレーションに送信されます。ATP ビジネス・オブジェクトから Order ビジネス・オブジェクトへのマッピングは、次の 2 ステップで行われます。
注: ソース・オブジェクトと宛先オブジェクトが同じタイプである場合にマッピングを可能にするためにコードがコラボレーションに追加されています。例えば、Order ビジネス・オブジェクトを別の Order ビジネス・オブジェクトへマッピングする場合です。
図 3 に、ATPToSalesOrder のトランザクションプロセス・ロジックを示します。
図 3. ATPToSalesOrder コラボレーションのトランザクションプロセス・ロジック
InterChange Server は、トランザクション・コラボレーションのいずれかのステップで失敗が発生した場合、トランザクションをロールバックできます。例えば、ATPToSalesOrder がトランザクションのコラボレーションに参加するコラボレーション・オブジェクト・グループのメンバーである場合、ATPToSalesOrder のアクションは、より大きなトランザクションの 1 つのサブトランザクション・ステップとなります。コラボレーション・オブジェクト・グループのビジネス・プロセスでいずれかのステップが失敗すると、トランザクション・コラボレーションは InterChange Server がグループ内のコラボレーションの処理をどのようにロールバックすればよいか明示します。
ATPToSalesOrder コラボレーション・オブジェクトをほかのコラボレーション・オブジェクトと無関係に使用する場合、または From ポートを別のコラボレーションではなくソース・アプリケーションにバインドする場合、そのプロセスを構成するトランザクション・ステップは 1 つのみになります。このような場合には、ロールバックを実行する必要はありません。
1 つのコラボレーション・オブジェクト、またはコラボレーション・オブジェクト・グループにロールバックを実行させるには、コラボレーション・テンプレートを変更する必要があります。WebSphere Business Integration システムにおけるトランザクション処理を理解するためには、「テクニカル入門 (IBM WebSphere InterChange Server)」を参照してください。コラボレーション・テンプレートへのトランザクション処理の追加については、「コラボレーション開発ガイド」を参照してください。
トランザクション処理を実行できるようにコラボレーション・オブジェクトを拡張するには、以下の手順を完了します。
この節では、このコラボレーション・テンプレートの標準プロパティーおよび固有のプロパティーについて説明します。
このコラボレーション・テンプレートでは、以下のコラボレーション・テンプレートの標準構成プロパティーを使用します。
これらの構成プロパティーについては、『Required Documents for Creating Collaboration Objects』を参照してください。
このコラボレーション・テンプレートには、標準構成プロパティーに加えて、以下に示す構成プロパティーがあります。
プロパティー名とその説明 | 可能な値 | デフォルト値 |
---|---|---|
MAP_TO_ATP このプロパティーは、着信 Order ビジネス・オブジェクトを ATP ビジネス・オブジェクトへマッピングし、ATP コラボレーションへ送信するためにコラボレーションが呼び出すマップの名前です。 |
リポジトリのマップ名 | なし |
MAP_FROM_ATP このプロパティーは、ATP コラボレーションから受け取った ATP ビジネス・オブジェクトを Order ビジネス・オブジェクトへ送信し、SalesOrderProcessing コラボレーションへ送信するためにコラボレーションが呼び出すマップの名前です。 |
リポジトリのマップ名 | なし |
RETURN_TO_SOURCE このプロパティーの値により、宛先アプリケーションと同期した Order オブジェクトが「update」動詞とともにソースに戻されるどうかが決定されます。Order オブジェクトには ATPToSalesOrder プロセスで検索された ATP 日付が含まれているため、この情報の同期がソース・アプリケーションに関連する場合、このプロパティーを「true」に設定します。 |
true、false | なし |
このコラボレーション・テンプレートのメッセージの説明を表示するには、Log Viewer を起動し、コラボレーション・テンプレートのメッセージ・ファイルを開いてください。Log Viewer を起動してコラボレーション・テンプレートのメッセージ・ファイルを開くには、以下の手順に従います。