ProductInstallation は、サービス管理や顧客サービスと言われるより大きなビジネス・プロセスの一部として、InstalledProductSync コラボレーション・テンプレートとともに使用します。このビジネス・プロセスは、顧客サイトに設置された商品へのアフター・サービスを提供する設置ベースを企業が管理するために使用します。
ProductInstallation によって、企業が設置ベースを使用して、フロント・オフィスおよびバック・オフィスのアプリケーションのユーザーが顧客サイトに設置されている商品を把握できるようになります。 IBM では、ProductInstallation を使用する企業が以下のようにフロント・オフィスおよびバック・オフィスのアプリケーションを使用すると想定しています。
バック・オフィス・アプリケーションが、設置ベースの一部として管理されている商品を配送する場合、イベントは汎用 InstallShipment ビジネス・オブジェクトを送信します。InstallShipment は ProductInstallation を起動し、ProductInstallation はフロント・オフィス・アプリケーションに設置済み商品オブジェクトを作成します。 次に、フロント・オフィス・アプリケーションはその設置済み商品の任意のケース、契約、および送り状を処理します。
ProductInstallation がサブスクライブする汎用 InstallShipment ビジネス・オブジェクトには配送情報しか含まれませんが、InstallShipment は InstalledProduct ビジネス・オブジェクトを作成するために ProductInstallation の情報が十分に含まれるよう設計されています。 ProductInstallation は、宛先アプリケーションに InstalledProduct ビジネス・オブジェクトを送信します。
注: InstalledProducts の修正や削除を許可したり、参照先ビジネス・オブジェクト (Contacts、Customers、CustomerPartners、Items、および Sites) の検証や同期を許可するには、ProductInstallation の Send ポートを InstalledProductSync にバインドします。詳しくは、『ポート情報』を参照してください。
この節では、ポート・バインディングについて説明し、ProductInstallation に基づくコラボレーション・オブジェクトをセットアップするために必要なステップを説明します。コラボレーション・テンプレートの標準の機能、ポート、および構成プロパティーについて、およびコラボレーション・オブジェクト作成に関する一般情報については、『Required Documents for Creating Collaboration Objects』にリストされている文書を参照してください。
図 1 に、System Manager で表示される ProductInstallation のポートを示します。 各ポートについての情報は、図 1 の後にある表に示します。
図 1. ProductInstallation コラボレーションのポート
注: コラボレーション・オブジェクトでポートを使用しないようにするには、そのポートをポート・コネクターにバインドしてください。これにより、コラボレーション・オブジェクトが追加機能を提供せずに、そのポートは未使用として示されます。
ビジネス・オブジェクト | バインド先 | 機能 | 使用される動詞 |
---|---|---|---|
なし | ポート・コネクター | ProductInstallation はこのポートを使用しません。 ProductInstallation は宛先からビジネス・オブジェクトを検索しないので、USE_RETRIEVE プロパティーのデフォルト値「false」を保持する必要があります。 | なし |
ビジネス・オブジェクト | バインド先 | 機能 | 使用される動詞 |
---|---|---|---|
InstallShipment | ソース・アプリケーションのコネクター、または呼び出し側コラボレーション | トリガー・ビジネス・オブジェクトを受け取ります。 |
Create Retrieve Update Delete |
ビジネス・オブジェクト | バインド先 | 機能 | 使用される動詞 |
---|---|---|---|
InstalledProduct |
宛先アプリケーションのコネクター (InstalledProduct を作成する場合のみ) InstalledProductSync の From ポート (InstalledProduct の変更と削除、および参照される Contact、Customer、CustomerPartner、Item、Site の検証または同期を可能にします) |
InstallShipment の InstallShipmentLine ビジネス・オブジェクト配列に含まれるビジネス・オブジェクトごとに、1 つの InstalledProduct ビジネス・オブジェクトをコラボレーションの外部に送信します。 |
Create |
バック・オフィス・アプリケーションが注文配送業務のみを処理するので、トリガー・デリバリー・オブジェクトで参照される Contact、Customer、CustomerPartner、Item、Site を検証または同期する必要がない場合、ProductInstallation をスタンドアロンとして使用します。 ProductInstallation をスタンドアロンのコラボレーションとして作成する手順は、以下のとおりです。
ProductInstallation プロセスの一環として、関連する Contact、Customer、CustomerPartner、(特定タイプの) Item、Site を検証または同期するには、以下のコラボレーション・オブジェクト・グループの任意の組み合わせを作成します。
検証 同期 必要なコラボレーション Contact ProductInstallation、InstalledProductSync、ContactWrapper Contact ProductInstallation、InstalledProductSync、ContactWrapper、ContactSync Customer ProductInstallation、CustomerWrapper Customer ProductInstallation、InstalledProductSync、CustomerWrapper、CustomerSync CustomerPartner ProductInstallation、InstalledProductSync、CustomerPartnerWrapper CustomerPartner ProductInstallation、InstalledProductSync、CustomerPartnerWrapper、CustomerPartnerSync Item ProductInstallation、InstalledProductSync、ItemWrapper Item ProductInstallation、InstalledProductSync、ItemWrapper、ItemSync Site ProductInstallation、InstalledProductSync、SiteWrapper Site ProductInstallation、InstalledProductSync、SiteWrapper, SiteSync InstalledProduct(Create のほかに Update および Delete) ProductInstallation、InstalledProductSync
以下の手順は、ProductInstallation をコラボレーション・グループの一部としてセットアップするためのステップを示しています。
この節では、このコラボレーション・テンプレートのプロセス・ロジックについて説明します。
主なビジネス・プロセスには、InstalledProduct ビジネス・オブジェクトの階層の同期があります。 図 2 は、ProductInstallation の主なビジネス・プロセスを示しています。
図 2. ProductInstallation コラボレーションの主なビジネス・プロセス
ProductInstallation は InstallShipment によって起動されます。InstallShipment には、複数のカーディナリティーを持つ InstallShipmentLine という子ビジネス・オブジェクトあります。 それぞれの InstallShipmentLine 子ビジネス・オブジェクトにおいて、ProductInstallation は対応する InstalledProduct を Create 動詞とともに To ポートを介して送信します。 ProductInstallation は、最初に最上位の親 InstalledProduct ビジネス・オブジェクト (つまり親を持たない親) を送信します。 次に、コラボレーションはそのビジネス・オブジェクトの直接の子を送信します。 含まれる InstallShipmentLine ごとに 1 つの InstalledProduct が完全に送信されるまで、次の直接の子を送信します。
注: ProductInstallation が親ビジネス・オブジェクトを正しい順序で送信するように、InstallShipmentLine ビジネス・オブジェクトの配列は、最上位に親を置き、それに直接の子が続くように並べる必要があります。各子ビジネス・オブジェクトには、自身の直接の子が続く必要があります。 配列の最後のビジネス・オブジェクトは、自身の子を持たない子である必要があります。
コラボレーションのプロセスを理解するため、InstallShipmentLine に 3 つのビジネス・オブジェクトが含まれているとします。 この場合、ProductInstallation は以下の手順を行います。
このコラボレーション・テンプレートでは、以下の標準コラボレーション・ビジネス・プロセスが使用されます。
これらのビジネス・プロセスについては、『Required Documents for Creating Collaboration Objects』を参照してください。
InterChange Server は、トランザクション・コラボレーションのいずれかのステップで失敗が発生した場合、トランザクションをロールバックできます。例えば、ProductInstallation がトランザクションのコラボレーションに参加するコラボレーション・オブジェクト・グループのメンバーである場合、ProductInstallation のアクションは、より大きなトランザクションの 1 つのサブトランザクション・ステップとなります。 コラボレーション・オブジェクト・グループのビジネス・プロセスでいずれかのステップが失敗すると、トランザクション・コラボレーションは InterChange Server がグループ内のコラボレーションの処理をどのようにロールバックすればよいか明示します。
ProductInstallation コラボレーション・オブジェクトをほかのコラボレーション・オブジェクトと無関係に使用する場合、または From ポートを別のコラボレーションではなくソース・アプリケーションにバインドする場合、そのプロセスを構成するトランザクション・ステップは 1 つのみになります。このような場合には、ロールバックを実行する必要はありません。
1 つのコラボレーション・オブジェクト、またはコラボレーション・オブジェクト・グループにロールバックを実行させるには、コラボレーション・テンプレートを変更する必要があります。WebSphere Business Integration システムにおけるトランザクション処理を理解するためには、「テクニカル入門 (IBM WebSphere InterChange Server)」を参照してください。コラボレーション・テンプレートへのトランザクション処理の追加については、『Required Documents for Creating Collaboration Objects』を参照してください。
トランザクション処理を実行できるようにコラボレーション・オブジェクトを拡張するには、以下の手順を完了します。
ProductInstallation コラボレーション・テンプレートは、標準コラボレーション・プロパティーのみを使用します。 自身の処理に固有のプロパティーを持たないだけでなく、標準プロパティーもすべてを使用するわけではありません。 例えば、ProductInstallation は Create 操作のみを実行し、トリガーとなる InstallShipment ビジネス・オブジェクトを宛先アプリケーションから検索することはないので、CONVERT_CREATE、CONVERT_UPDATE、ADDITIONAL_RETRIEVE、および USE_RETRIEVE プロパティーのデフォルト構成を変更する必要はありません。
このコラボレーション・テンプレートでは、以下のコラボレーション・テンプレートの標準構成プロパティーを使用します。
これらの構成プロパティーについては、『Required Documents for Creating Collaboration Objects』を参照してください。
残りの標準構成プロパティーについては、『Required Documents for Creating Collaboration Objects』を参照してください。
このコラボレーション・テンプレートのメッセージの説明を表示するには、Log Viewer を起動し、コラボレーション・テンプレートのメッセージ・ファイルを開いてください。Log Viewer を起動してコラボレーション・テンプレートのメッセージ・ファイルを開くには、以下の手順に従います。
このコラボレーション・テンプレートのより新しいバージョンにアップグレードするには、以下の手順を行います。