ContactSync コラボレーションは、特定の顧客連絡先に関するデータをソース・アプリケーションと宛先アプリケーションの間で同期します。このコラボレーションは、各顧客サイトでユーザーの組織との連絡を担当する人物に関する情報を含む汎用 Contact ビジネス・オブジェクトを使用します。連絡先情報の同期化により、企業でデータが追加、変更、または削除されても、個々のアプリケーションで矛盾なく情報を共有できます。ContactSync が同期するのは Contact のみですが、適切なコラボレーションを呼び出して次の関連ビジネス・オブジェクトを検証または同期するよう構成できます。
ビジネス・オブジェクト | 関連するコラボレーション・プロパティー | 呼び出し先コラボレーション |
---|---|---|
Customer | VERIFY_SYNC_CUSTOMERS | CustomerSync CustomerWrapper |
VERIFY_SYNC_CUSTOMERPARTNERS | CustomerPartnerWrapper CustomerPartnerSync |
この文書では、コラボレーション・テンプレートの作成および構成方法とそのビジネス・プロセスについて説明します。
この節では、ポート・バインディングについて説明し、ContactSync に基づくコラボレーション・オブジェクトをセットアップするために必要なステップを説明します。コラボレーション・テンプレートの標準の機能、ポート、および構成プロパティーについて、およびコラボレーション・オブジェクト作成に関する一般情報については、『Required Documents for Creating Collaboration Objects』にリストされている文書を参照してください。
図 1 に、System Manager で表示される ContactSync のポートを示します。各ポートについての情報は、図の後にある表に示します。
図 1. ContactSync コラボレーションのポート
注: コラボレーション・オブジェクトでポートを使用しないようにするには、そのポートをポート・コネクターにバインドしてください。これにより、コラボレーション・オブジェクトが追加機能を提供せずに、そのポートは未使用として示されます。
ビジネス・オブジェクト | バインド先 | 機能 | 使用される動詞 |
---|---|---|---|
Contact | 宛先アプリケーションのコネクター | 参照値のビジネス・オブジェクトを送信して、完全な値のビジネス・オブジェクトを検索します。この結果、Contactを同期するときに使用される動詞が決まります。 |
Retrieve |
ビジネス・オブジェクト | バインド先 | 機能 | 使用される動詞 |
---|---|---|---|
Contact | ソース・アプリケーションのコネクター、または呼び出し側コラボレーション | トリガー・ビジネス・オブジェクトを受け取ります。コラボレーションが正常に終了した場合、このポートは、同期呼び出しの最後に、トリガー・ビジネス・オブジェクトをソース・アプリケーションに戻します。 |
Create Retrieve Update Delete |
ビジネス・オブジェクト | バインド先 | 機能 | 使用される動詞 |
---|---|---|---|
Contact | 宛先アプリケーションのコネクター |
トリガー・ビジネス・オブジェクトをコラボレーションから送信します。 |
Create Update Delete |
ビジネス・オブジェクト | バインド先 | 機能 | 使用される動詞 |
---|---|---|---|
Customer |
|
検証または同期のために参照値 Customer ビジネス・オブジェクトを送信します。 |
Sync Exists |
ビジネス・オブジェクト | バインド先 | 機能 | 使用される動詞 |
---|---|---|---|
CustomerPartner |
|
検証または同期のために参照値 CustomerPartner ビジネス・オブジェクトを送信します。 |
Sync Exists |
ContactSync をスタンドアロンのコラボレーション・オブジェクトとしてセットアップするには、次の手順を実行します。
ContactSync プロセスの一部として関連の Customer および CustomerPartner を検証または同期するには、以下のコラボレーション・オブジェクト・グループのいずれかの組み合わせを作成します。
検証 同期 必要なコラボレーション Customer ContactSync、CustomerWrapper Customer ContactSync、CustomerWrapper、CustomerSync CustomerPartner ContactSync、CustomerPartnerWrapper CustomerPartner ContactSync、CustomerPartnerWrapper、CustomerPartnerSync
以下に、ContactSync をコラボレーション・オブジェクト・グループの一部として設定する手順を示します。以下の手順では、Contact をその参照 CustomerPartner ではなく参照 SoldTo Customerと同期するものとします。
この節では、このコラボレーション・テンプレートのプロセス・ロジックについて説明します。
図 2 に、ContactSync のプロセス・ロジックを示します。
図 2. ContactSync コラボレーションのプロセス・ロジック
注: アプリケーションによっては、レコードが物理的に削除されません。ソース・アプリケーションは、連絡先のステータスを削除する代わりに非アクティブにすることもあります。この場合、コラボレーションは Contact ビジネス・オブジェクトを動詞 Update とともに受信します。特定のアプリケーション・プロセスによる削除方法については、コネクター文書を参照してください。
このコラボレーション・テンプレートでは、以下の標準コラボレーション・ビジネス・プロセスが使用されます。
これらのビジネス・プロセスについては、『Required Documents for Creating Collaboration Objects』を参照してください。
図 3 に、Customer と CustomerPartner の検証および同期に関する ContactSync のプロセスを示します。
注: 各 Contact ビジネス・オブジェクトには、ContactCustomer ビジネス・オブジェクトが単一のカーディナリティーとともに含まれています。ContactCustomer の RoleName 属性が「Customer」である場合、ContactSync は Customer ビジネス・オブジェクトを作成し、CustomerWrapper へ送信します。RoleName が「CustomerPartner」である場合、ContactSync は CustomerPartner ビジネス・オブジェクトを作成し、CustomerPartnerWrapper へ送信します。
図 3: Customer と CustomerPartner の検証または同期
InterChange Server は、トランザクション・コラボレーションのいずれかのステップで失敗が発生した場合、トランザクションをロールバックできます。例えば、ContactSync がトランザクションのコラボレーションに参加するコラボレーション・オブジェクト・グループのメンバーである場合、ContactSync のアクションは、より大きなトランザクションの 1 つのサブトランザクション・ステップとなります。コラボレーション・オブジェクト・グループのビジネス・プロセスでいずれかのステップが失敗すると、トランザクション・コラボレーションは InterChange Server がグループ内のコラボレーションの処理をどのようにロールバックすればよいか明示します。
ContactSync コラボレーション・オブジェクトをほかのコラボレーション・オブジェクトと無関係に使用する場合、または From ポートを別のコラボレーションではなくソース・アプリケーションにバインドする場合、そのプロセスを構成するトランザクション・ステップは 1 つのみになります。このような場合には、ロールバックを実行する必要はありません。
1 つのコラボレーション・オブジェクト、またはコラボレーション・オブジェクト・グループにロールバックを実行させるには、コラボレーション・テンプレートを変更する必要があります。WebSphere Business Integration システムにおけるトランザクション処理を理解するためには、「テクニカル入門 (IBM WebSphere InterChange Server)」を参照してください。コラボレーション・テンプレートへのトランザクション処理の追加については、『Required Documents for Creating Collaboration Objects』を参照してください。
トランザクション処理を実行できるようにコラボレーション・オブジェクトを拡張するには、以下の手順を完了します。
この節では、このコラボレーション・テンプレートの標準プロパティーおよび固有のプロパティーについて説明します。
このコラボレーション・テンプレートでは、以下のコラボレーション・テンプレートの標準構成プロパティーを使用します。
これらの構成プロパティーについては、『Required Documents for Creating Collaboration Objects』を参照してください。
このコラボレーション・テンプレートには、標準構成プロパティーに加えて、以下に示す構成プロパティーがあります。
プロパティー名とその説明 | 可能な値 | デフォルト値 |
---|---|---|
VERIFY_SYNC_CUSTOMERS 「sync」に設定すると、このコラボレーションは、宛先アプリケーション内の関連する SoldTo Customer を同期します。コラボレーションは、以下のステップを実行します。
「verify」に設定すると、このコラボレーションは、宛先アプリケーション内の関連する Customer を検証します。コラボレーションは、以下のステップを実行します。
「neither」に指定すると、このコラボレーションがトリガー・ビジネス・オブジェクトを同期するときに、宛先アプリケーション内の関連する Customer を最初に同期することはありません。VERIFY_SYNC_CUSTOMERPARTNERS |
verify、sync、neither | neither |
VERIFY_SYNC_CUSTOMERPARTNERS 「sync」に設定すると、このコラボレーションが、SoldTo Customer に関連付けて保管している補助的な顧客情報 (BillTo データや ShipTo データ) を同期します。コラボレーションは、以下のステップを実行します。
「verify」に設定すると、このコラボレーションは、宛先アプリケーション内で関連する CustomerPartner を検証します。コラボレーションは、以下のステップを実行します。
「neither」に指定すると、このコラボレーションがトリガー・ビジネス・オブジェクトを同期するときに、宛先アプリケーション内の関連 CustomerPartner を最初に同期することはありません。 |
sync、verify、neither |
neither |
このコラボレーション・テンプレートのメッセージの説明を表示するには、Log Viewer を起動し、コラボレーション・テンプレートのメッセージ・ファイルを開いてください。Log Viewer を起動してコラボレーション・テンプレートのメッセージ・ファイルを開くには、以下の手順に従います。
このコラボレーション・テンプレートのより新しいバージョンにアップグレードするには、以下の手順を行います。