TradingPartnerOrderManagement コラボレーション・テンプレートは、提供業者の注文管理アプリケーションで販売注文を作成および更新するために使用します。このプロセスは、バイヤーの調達アプリケーションで購入注文が作成または変更されたときに開始されます。次のリストに、このコラボレーションのさまざまな機能の詳細な説明を示します。
TradingPartnerOrderManagement は、購入注文と販売注文のデータを同期するために、汎用 TradingPartnerOrder ビジネス・オブジェクトを使用します。
TradingPartnerOrderManagement は、TradingPartnerOrder ビジネス・オブジェクトのデータのみを同期しますが、適切なコラボレーションと組み合わせて実装することにより、以下の関連ビジネス・オブジェクトを使用して注文状況データを同期することができます。
ビジネス・オブジェクト | 関連するコラボレーション・プロパティー | 呼び出し先コラボレーション |
---|---|---|
OrderDeliveryStatus | FromTradingPartnerURL ToTradingPartnerURL | OrderDeliveryStatus |
この節では、ポート・バインディングについて説明し、TradingPartnerOrderManagement に基づくコラボレーション・オブジェクトをセットアップするために必要なステップを説明します。コラボレーション・テンプレートの標準の機能、ポート、および構成プロパティーについて、およびコラボレーション・オブジェクト作成に関する一般情報については、『Required Documents for Creating Collaboration Objects』にリストされている文書を参照してください。
図 1 に、System Manager で表示される TradingPartnerOrderManagement のポートを示します。
図 1. TradingPartnerOrderManagement コラボレーションのポート
注: コラボレーション・オブジェクトでポートを使用しないようにするには、そのポートをポート・コネクターにバインドしてください。これにより、コラボレーション・オブジェクトが追加機能を提供せずに、そのポートは未使用として示されます。
ビジネス・オブジェクト | バインド先 | 機能 | 使用される動詞 |
---|---|---|---|
TradingPartnerOrder | 宛先 (サプライヤー側) アプリケーションのコネクター | 参照値のビジネス・オブジェクトを送信して、完全な値のビジネス・オブジェクトを検索します。 |
Retrieve |
ビジネス・オブジェクト | バインド先 | 機能 | 使用される動詞 |
---|---|---|---|
TradingPartnerOrder | ソース (バイヤー側) アプリケーションのコネクター | トリガー・ビジネス・オブジェクトを受け取ります。コラボレーションが正常に終了した場合、このポートは、同期呼び出しの最後に、トリガー・ビジネス・オブジェクトをソース・アプリケーションに戻します。 |
Create Retrieve Update Delete |
ビジネス・オブジェクト | バインド先 | 機能 | 使用される動詞 |
---|---|---|---|
TradingPartnerOrder | 宛先 (提供業者の) アプリケーションのコネクター、カスタム・コラボレーション、または SalesOrderProcessingWrapper コラボレーション |
トリガー・ビジネス・オブジェクトをコラボレーションから送信します。通常は宛先アプリケーションにバインドされますが、ラッパー・コラボレーションにバインドされることもあります。 |
Create Update Delete |
ビジネス・オブジェクト | バインド先 | 機能 | 使用される動詞 |
---|---|---|---|
TradingPartnerOrder | ソース (バイヤーの) アプリケーションのコネクター | 宛先アプリケーションで販売注文の作成が失敗した場合は、オブジェクトをバイヤーのアプリケーションに戻します。 |
Update |
この節では、このコラボレーション・テンプレートのプロセス・ロジックについて説明します。
図 2 に、TradingPartnerOrderManagement のプロセス・ロジックを示します。
図 2. TradingPartnerOrderManagement コラボレーションのプロセス・ロジック
このコラボレーション・テンプレートでは、以下の標準コラボレーション・ビジネス・プロセスが使用されます。
これらのビジネス・プロセスについては、『Required Documents for Creating Collaboration Objects』を参照してください。
図 3 に、更新を実行するための TradingPartnerOrderManagement の追加処理を示します。
図 3. 更新のための追加処理
InterChange Server は、トランザクション・コラボレーションのいずれかのステップで失敗が発生した場合、トランザクションをロールバックできます。 例えば、TradingPartnerOrderManagement がトランザクションのコラボレーションに参加するコラボレーション・オブジェクト・グループのメンバーである場合、TradingPartnerOrderManagement のアクションは、より大きなトランザクションの 1 つのサブトランザクション・ステップとなります。コラボレーション・オブジェクト・グループのビジネス・プロセスでいずれかのステップが失敗すると、トランザクション・コラボレーションは InterChange Server がグループ内のコラボレーションの処理をどのようにロールバックすればよいか明示します。
TradingPartnerOrderManagement コラボレーション・オブジェクトをほかのコラボレーション・オブジェクトと無関係に使用する場合、または From ポートを別のコラボレーションではなくソース・アプリケーションにバインドする場合、そのプロセスを構成するトランザクション・ステップは 1 つのみになります。このような場合には、ロールバックを実行する必要はありません。
1 つのコラボレーション・オブジェクト、またはコラボレーション・オブジェクト・グループにロールバックを実行させるには、コラボレーション・テンプレートを変更する必要があります。WebSphere Business Integration システムにおけるトランザクション処理を理解するためには、「テクニカル入門 (IBM WebSphere InterChange Server)」を参照してください。コラボレーション・テンプレートへのトランザクション処理の追加については、『Required Documents for Creating Collaboration Objects』を参照してください。
トランザクション処理を実行できるようにコラボレーション・オブジェクトを拡張するには、以下の手順を完了します。
この節では、このコラボレーション・テンプレートの標準プロパティーおよび固有のプロパティーについて説明します。
このコラボレーション・テンプレートでは、以下のコラボレーション・テンプレートの標準構成プロパティーを使用します。
これらの構成プロパティーについては、『Required Documents for Creating Collaboration Objects』を参照してください。
このコラボレーション・テンプレートには、標準構成プロパティーに加えて、以下に示す構成プロパティーがあります。
プロパティー名とその説明 | 可能な値 | デフォルト値 |
---|---|---|
ALLOW_UPDATES 購入注文の更新をコラボレーションで処理するかどうかを指定します。 更新を許可するには、「true」に設定します。 |
true、false | true |
RETRIEVE_ORDER_STATUS このプロパティーは、ALLOW_UPDATES プロパティーが「true」に設定されている場合にのみ評価されます。 「true」に設定すると、コラボレーションは、TradingPartnerOrder.update イベントを受信した際に、宛先アプリケーションから完全なオブジェクトを検索し、ORD_STATUS_ERROR_ATTRIBUTE プロパティーの値を評価します。ORD_STATUS_ERROR_COND と評価された場合には、イベントは失敗し、バイヤー側アプリケーションの管理者に E メールが送信されます。 「false」に設定すると、コラボレーションが TradingPartnerOrder.update イベントを受信しても、検索は実行されません。 |
true、false | true |
RETURN_ERROR_OBJECT 「true」に設定すると、提供業者のアプリケーションで販売注文の作成または更新が失敗するか、あるいは ORD_STATUS_ERR_ATTRIBUTE プロパティーの値が ORD_STATUS_ERR_COND に評価された場合に、コラボレーションは ToFailure ポートを通じてバイヤーに TradingPartnerOrder 汎用ビジネス・オブジェクトを返信します。 「false」に設定すると、バイヤーにオブジェクトは返信されません。 この構成オプションは、SEND_EMAIL 構成には影響を与えません。 |
true、false | false |
ORD_STATUS_ERR_COND このプロパティーは、RETRIEVE_ORDER_STATUS が「true」と評価された場合にのみ評価されます。 トリガー・ビジネス・オブジェクトが同期しないようにするために、コラボレーションがフィルターとして使用する値を指定します。ORD_STATUS_ERR_ATTRIBUTE で指定した属性の値が、このプロパティーにリストされた値の 1 つと一致すると、コラボレーションはビジネス・オブジェクトを同期から除外します。 コラボレーションは、指定した値の大文字小文字の違いや、値のリスト内の余分なスペースは無視します。 |
カンマで区切った値のリスト | shipped |
ORD_STATUS_ERR_ATTRIBUTE コラボレーションは、ORD_STATUS_ERR_COND が「none」以外の値に評価された場合にのみ、このプロパティーを評価します。 コラボレーションが ORD_STATUS_ERR_COND プロパティー内の値を比較する際に使用するビジネス・オブジェクト属性を指定します。コラボレーションは、ビジネス・オブジェクトを特定の値と同期しないように、指定された属性の値を ORD_STATUS_ERR_COND プロパティーで除外に指定された値と比較します。例えば、BusObjA という名前のトップレベル・ビジネス・オブジェクトに、BusObjB という名前の子ビジネス・オブジェクトが含まれているとします。BusObjB ビジネス・オブジェクトの Type という属性に基づいてフィルター操作を行うには、ORD_STATUS_ERR_ATTRIBUTE の値を BusObjA.BusObjB.Type に設定します。 |
AttributeName | status |
このコラボレーション・テンプレートのメッセージの説明を表示するには、Log Viewer を起動し、コラボレーション・テンプレートのメッセージ・ファイルを開いてください。Log Viewer を起動してコラボレーション・テンプレートのメッセージ・ファイルを開くには、以下の手順に従います。