ATPToSalesOrder コラボレーション・テンプレート

ATPToSalesOrder コラボレーション・テンプレートは、ATP チェックが Sales Order の作成および更新プロセスに依存するときに使用されます。ATPToSalesOrder は、汎用 Order ビジネス・オブジェクトをサブスクライブし、販売注文の製品の利用可能在庫データを更新します。

問題と前提事項

コラボレーション・オブジェクトのセットアップ

この節では、ポート・バインディングについて説明し、ATPToSalesOrder に基づくコラボレーション・オブジェクトをセットアップするために必要なステップを説明します。コラボレーション・テンプレートの標準の機能、ポート、および構成プロパティーについて、およびコラボレーション・オブジェクト作成に関する一般情報については、『Required Documents for Creating Collaboration Objects』にリストされている文書を参照してください。

ポート情報

図 1 に、System Manager で表示される ATPToSalesOrder コラボレーションのポートを示します。

図 1. ATPToSalesOrder コラボレーションのポート

注: コラボレーション・オブジェクトでポートを使用しないようにするには、そのポートをポート・コネクターにバインドしてください。これにより、コラボレーション・オブジェクトが追加機能を提供せずに、そのポートは未使用として示されます。

ポート名: From
ビジネス・オブジェクト バインド先 機能 使用される動詞
Order ソース (バイヤー側) アプリケーションのコネクター トリガー・ビジネス・オブジェクトを受け取ります。コラボレーションが正常に終了した場合、このポートは、同期呼び出しの最後に、トリガー・ビジネス・オブジェクトをソース・アプリケーションに戻します。

Create

Update

Delete


ポート名: ToATP
ビジネス・オブジェクト バインド先 機能 使用される動詞
ATP ATP コラボレーション 送信されるオブジェクト。 Retrieve

ポート名: ToSOP
ビジネス・オブジェクト バインド先 機能 使用される動詞
Order SalesOrderProcessing コラボレーション SalesOrderProcessing コラボレーションに送信されるオブジェクト。

Create

Update

Delete


ポート名: ToSource
ビジネス・オブジェクト バインド先 機能 使用される動詞
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)」を参照してください。コラボレーション・テンプレートへのトランザクション処理の追加については、「コラボレーション開発ガイド」を参照してください。

トランザクション処理を実行できるようにコラボレーション・オブジェクトを拡張するには、以下の手順を完了します。

  1. この機能を、そのコラボレーション・テンプレートと、コラボレーション・オブジェクト・グループ内の他のすべてのコラボレーション・テンプレートに追加します。
  2. コラボレーション・オブジェクト、およびコラボレーション・オブジェクト・グループのすべてのメンバーの最小トランザクション・レベルを、None より大きい値に設定します。「最小限の努力」以上に設定した場合、いずれかのサブトランザクション・ステップで失敗が発生すると、このコラボレーション・オブジェクトおよびグループ内のほかのコラボレーション・オブジェクトは、すべてのビジネス・オブジェクトに対して実行された Create、Update、および Delete 操作に対して差し戻しを実行します。
  3. コラボレーション・オブジェクト、およびコラボレーション・オブジェクト・グループの他のすべてのメンバーの USE_RETRIEVE プロパティーを「true」に設定します。コラボレーション・オブジェクトに対して、値を変更する前に検索するように強制すると、コラボレーション・オブジェクトは Update または Delete プロセスの際に元の値を復元できるようになります。

構成プロパティー

この節では、このコラボレーション・テンプレートの標準プロパティーおよび固有のプロパティーについて説明します。

標準プロパティー

このコラボレーション・テンプレートでは、以下のコラボレーション・テンプレートの標準構成プロパティーを使用します。

これらの構成プロパティーについては、『Required Documents for Creating Collaboration Objects』を参照してください。

このコラボレーション・テンプレート固有のプロパティー

このコラボレーション・テンプレートには、標準構成プロパティーに加えて、以下に示す構成プロパティーがあります。

ATPToSalesOrder コラボレーション・テンプレート固有の構成プロパティー

プロパティー名とその説明 可能な値 デフォルト値

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 を起動してコラボレーション・テンプレートのメッセージ・ファイルを開くには、以下の手順に従います。

  1. 「スタート」メニューで、「プログラム」>「IBM WebSphere InterChange Server」>「IBM WebSphere Business Integration Toolset」>「Administrative」>「Log Viewer」の順にクリックします。
  2. 「ファイル」メニューで、「開く」をクリックします。
  3. 「Look In」フィールドを使用して、現在のフォルダーを WebSphere_ICS_root_dir \collaborations \messages に変更し、このコラボレーション・テンプレートのメッセージ・ファイルを選択します。

Copyright IBM Corp. 1997, 2003