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

PriceManager コラボレーションは、複数のアプリケーション間で価格表項目情報を同期します。 通常、このコラボレーションは、エンタープライズ・リソース・プランニング (ERP) アプリケーションを中心にして価格表項目を保持したり、発注に使用される営業支援システム (SFA) やフロント・オフィス・アプリケーションとその情報を同期したりするために使用します。

PriceManager は、PriceRecord ビジネス・オブジェクトおよびその子ビジネス・オブジェクトである PriceRecordPriceBreak を使用します。

関連するビジネス・オブジェクトの同期

PriceManager は価格表項目情報のみを同期しますが、適切なコラボレーションを呼び出して以下の関連するビジネス・オブジェクトを検証または同期するように構成することができます。

ビジネス・オブジェクト 関連するコラボレーション・プロパティー 呼び出し先コラボレーション

Item

ItemBasic

ItemOrder

ItemPlanning

ITEM_TYPE

VERIFY_SYNC_ITEM

ItemSync

ItemWrapper

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

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

ポート情報

図 1 は、System Manager に表示される PriceManager のポートを示しています。 各ポートについての情報は、図の後にある表に示します。

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

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

ポート名: DestinationAppRetrieve
ビジネス・オブジェクト バインド先 機能 使用される動詞
PriceRecord 宛先アプリケーションのコネクター 参照値のビジネス・オブジェクトを送信して、完全な値のビジネス・オブジェクトを検索します。この結果により、PriceRecord を同期するときに使用される動詞が決定します。

Retrieve


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

Create Retrieve Update Delete


ポート名: To
ビジネス・オブジェクト バインド先 機能 使用される動詞
PriceRecord 宛先アプリケーションのコネクター

トリガー・ビジネス・オブジェクトをコラボレーションから送信します。

Create Update Delete


ポート名: ToItemWrapper
ビジネス・オブジェクト バインド先 機能 使用される動詞
任意の汎用 item ビジネス・オブジェクト (Item、ItemBasic、ItemPlanning など)

ItemWrapper の From ポート (検証または同期の場合)

ポート・コネクター (検証または同期以外の場合)

検証または同期のために参照値 Item ビジネス・オブジェクトを送信します。

Sync Exists

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

PriceManager のスタンドアロンとしての使用

  1. PriceManager をスタンドアロンのコラボレーションとしてセットアップする手順は、以下のとおりです。
  2. PriceManager コラボレーション・オブジェクトを作成します。
  3. コラボレーション・オブジェクトの ToItemWrapper ポートを Port コネクターにバインドします。
  4. ポート情報』の説明に従って、残りのポートをバインドします。
  5. PriceManager コラボレーション・オブジェクトの VERIFY_SYNC_ITEM 構成プロパティーのデフォルト値「neither」をそのまま使用します。
  6. コラボレーションの残りのプロパティーを設定します。詳しくは、『構成プロパティー』を参照してください。

PriceManager のコラボレーション・オブジェクト・グループでの使用

PriceManager プロセスの一環として Item を検証または同期するには、以下のいずれかのコラボレーション・オブジェクト・グループをセットアップします。


検証 同期 必要なコラボレーション
Item   PriceManager、ItemWrapper
  Item PriceManager、ItemWrapper、ItemSync

以下に、PriceManager をコラボレーション・オブジェクト・グループの一部として設定する手順を示します。

  1. PriceManager、ItemWrapper、および ItemSync のテンプレートからコラボレーション・オブジェクトを作成します。
  2. PriceManager コラボレーション・オブジェクトを編集して、ToItemWrapper ポートをバインドします。 該当する宛先の『ポート情報』節を参照してください。
  3. PriceManager コラボレーション・オブジェクトの残りのポートをこの文書の『ポート情報』節の説明にしたがってバインドします。
  4. PriceManager コラボレーション・オブジェクトの VERIFY_SYNC_ITEM プロパティーを「sync」または「verify」に設定します。
  5. PriceManager コラボレーション・オブジェクトの ITEM_TYPE プロパティーを、検証または同期する Item タイプ (ItemBasic など) に設定します。
  6. ItemWrapper コラボレーション・オブジェクトを編集して、To ポートを ItemSync コラボレーション・オブジェクトの From ポートにバインドします。
  7. ItemWrapper コラボレーション・オブジェクトの残りのポートをバインドします。詳しくは、Wrapper コラボレーションの参照ページの『ポート情報』を参照してください。注: ItemWrapper コラボレーション・オブジェクトの From ポートは、System Manager によってすでに PriceManager コラボレーション・オブジェクトへバインドされていることがあります。
  8. ItemSync コラボレーション・オブジェクトを編集して、そのポートをバインドします。詳しくは、ItemSync コラボレーションの参照ページの『ポート情報』を参照してください。
  9. 各コラボレーションの構成プロパティーを設定します。詳しくは、以下を参照してください。

コラボレーション・テンプレートのプロセス

この節では、このコラボレーション・テンプレートのプロセス・ロジックについて説明します。

プロセス・ロジックの概要

図 2 は、PriceManager のプロセス・ロジックを示しています。

図 2. PriceManager コラボレーションのプロセス・ロジック

継承されたプロセス・ロジック

このコラボレーション・テンプレートでは、以下の標準コラボレーション・ビジネス・プロセスが使用されます。

これらのビジネス・プロセスについては、『Required Documents for Creating Collaboration Objects』を参照してください。

Item の検証または同期

図 3 は、VERIFY_SYNC_ITEM が「sync」または「verify」に設定されている場合に PriceManager が関連する Item を検証または同期するプロセスを示しています。VERIFY_SYNC_ITEM が「neither」に設定されている場合、PriceManager は以下に示すプロセスを実行せずにトリガー PriceRecord ビジネス・オブジェクトを同期します。

図 3. Item の検証または同期

注: プロセス ItemBasic、ItemOrder、および ItemPlanning へのコラボレーションを正常に行うためには、ご使用のシステムのリポジトリーに以下のビジネス・オブジェクトが存在する必要があります。

差し戻し処理

InterChange Server は、トランザクション・コラボレーションのいずれかのステップで失敗が発生した場合、トランザクションをロールバックできます。例えば、PriceManager がトランザクションのコラボレーションに参加するコラボレーション・オブジェクト・グループのメンバーである場合、PriceManager のアクションは、より大きなトランザクションの 1 つのサブトランザクション・ステップとなります。 コラボレーション・オブジェクト・グループのビジネス・プロセスでいずれかのステップが失敗すると、トランザクション・コラボレーションは InterChange Server がグループ内のコラボレーションの処理をどのようにロールバックすればよいか明示します。

PriceManager コラボレーション・オブジェクトをほかのコラボレーション・オブジェクトと無関係に使用する場合、または From ポートを別のコラボレーションではなくソース・アプリケーションにバインドする場合、そのプロセスを構成するトランザクション・ステップは 1 つのみになります。このような場合には、ロールバックを実行する必要はありません。

1 つのコラボレーション・オブジェクト、またはコラボレーション・オブジェクト・グループにロールバックを実行させるには、コラボレーション・テンプレートを変更する必要があります。WebSphere Business Integration システムにおけるトランザクション処理を理解するためには、「テクニカル入門 (IBM WebSphere InterChange Server)」を参照してください。コラボレーション・テンプレートへのトランザクション処理の追加については、『Required Documents for Creating Collaboration Objects』を参照してください。

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

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

構成プロパティー

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

標準プロパティー

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

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

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

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

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

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

ITEM_TYPE

コラボレーションが PriceRecord ビジネス・オブジェクトを同期する前に同期または検証する必要がある、汎用 Item のタイプを設定します。その VERIFY_SYNC_ITEM プロパティーが「sync」または「verify」と評価される場合、PriceManager はこのプロパティーの値を使用して、同期または検証する品目のタイプを判別します。

Item、ItemBasic、ItemOrder、または ItemPlanning Item

VERIFY_SYNC_ITEM

「sync」に設定すると、PriceManager が宛先アプリケーション内の関連する Item を同期します。PriceManager は PriceRecord ビジネス・オブジェクトから ItemId をコピーし、ITEM_TYPE プロパティーに指定されたタイプの汎用ビジネス・オブジェクトを作成します。PriceManager は、そのビジネス・オブジェクトを Sync 動詞とともに ItemWrapper に送信します。次に、ItemWrapper はすべての属性の値をソース・アプリケーションから検索し、ビジネス・オブジェクトを Create 動詞とともに ItemSync に送信します。ItemSync が関連する Item の作成に失敗した場合、PriceManager は INFORMATIONAL_EXCEPTIONS プロパティーに指定されたとおりにエラーを処理します。

「verify」に設定すると、PriceManager が宛先アプリケーション内の関連する Item を検証します。 PriceManager は PriceRecord ビジネス・オブジェクトから ItemId をコピーし、ITEM_TYPE プロパティーに指定されたタイプの汎用ビジネス・オブジェクトを作成します。PriceManager は、そのビジネス・オブジェクトを Exists 動詞とともに ItemWrapper に送信します。次に、ItemWrapper は宛先アプリケーションからビジネス・オブジェクトを検索します。ItemWrapper が関連する Item の検索に失敗した場合、PriceManager は INFORMATIONAL_EXCEPTIONS プロパティーに指定されたとおりにエラーを処理します。

「neither」に指定すると、PriceManager が自身をトリガーする PriceRecord ビジネス・オブジェクトを同期するときに、宛先アプリケーション内の関連する Item を最初に同期したり、既存の関連する Item を検証したりすることはありません。

neither、verify、sync

neither

コラボレーション・メッセージ

このコラボレーション・テンプレートのメッセージの説明を表示するには、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 に変更し、このコラボレーション・テンプレートのメッセージ・ファイルを選択します。

アップグレード情報

アップグレード処理

このコラボレーション・テンプレートのより新しいバージョンにアップグレードするには、以下の手順を行います。

  1. 現在の PriceManager コラボレーションを停止します。
  2. リポジトリーをバックアップします。詳しくは、「システム管理ガイド」を参照してください。
  3. コラボレーション・テンプレートをカスタマイズしている場合には、以下の手順を行います。
  4. 新規の PriceManager コラボレーション・テンプレートをインストールします。
  5. 新しいコラボレーション・テンプレートにカスタマイズを追加します。
  6. 新しいコラボレーション・オブジェクトを作成し、適切なコネクターにバインドします。 詳しくは、『コラボレーション・オブジェクトのセットアップ』を参照してください。
  7. 新しいコラボレーション・オブジェクトを実行してテストします。
  8. テスト中に見つかった問題点に基づいて、コラボレーション・オブジェクトを変更します。 

Copyright IBM Corp. 1997, 2003