インストールしたら、始動する前に、以下のようにして、アダプター・コンポーネントを構成します。
JPO トリガーが動作するには、前もって特定の構成プロパティーが設定されている 必要があります。これらの構成プロパティーを設定するには、各 JPO のソース・コードを編集する必要があります。
Adapter for eMatrix と一緒にインストールされる JPO は、WBIEventLogger および InstallEventTables です。それらをインストールしたら、eMatrix Business Modeler でそれぞれの JPO を探し、ソース・コードを編集する必要があります。
編集する必要があるフィールドは、以下の 表 2 にリストされています。
プロパティー名 | 説明 | デフォルト値 |
---|---|---|
wbiPrefix | eMatrix 内で、すべての WebSphere Business Integration eMatrix メタエンティティー (タイプ、属性、ポリシー) にそれら独自のネーム・スペースを提供するために使用されるプレフィックス。コネクター構成プロパティーの wbiPrefix に指定された値は、InstallEventTables ファイルおよび WBIEventLogger.java ファイルで宣言された wbiPrefix と一致する必要があります。 | wbi_ |
vault | 新規イベントが作成される eMatrix ボールトの名前。
EventVault コネクター構成プロパティーに指定された値に一致する 必要があります。 |
WBI_Events |
adapterUser | eMatrix システムで要求を行うときにアダプターが使用する ID。
ApplicationUserName コネクター構成プロパティーに指定された値に一致する必要があります。 「ピンポン」作用を防止するのに重要です (下記参照)。 |
adapter |
トリガーが割り当てられている eMatrix システム内のオブジェクト をアダプターが変更すると、そのトリガーが新しいイベントを生成し、それがブローカーに戻されてパブリッシュされる場合があります。次の仕組みによって、このことが起こらないようにできます。
JPO は、呼び出されると、特にそれを呼び出したユーザーに関連付けられたユーザー ID を含む、コンテキスト・オブジェクトを受け取ります。このユーザー ID は、JPO プロパティーの adapterUser で設定されます。WBIEventLogger JPO は、起動されると、eMatrix コンテキスト・オブジェクトから受け取ったユーザー ID を検査します。
ユーザーが Adapter for eMatrix の場合、JPO の adapterUser プロパティーの値は、コネクターの ApplicationUserName プロパティーの値に一致します。この場合、JPO はそのイベントを無視し、イベントはログに記録されません。ユーザー ID が一致しない場合、JPO は新しいイベントを作成します。
アダプターのコネクター・コンポーネントには、2 種類の構成プロパティーがあります。1 つは標準の構成プロパティーで、ほとんどのアダプターに適用されます。もう 1 つはアプリケーション固有の構成プロパティーで、ご使用のアダプターにのみ適用されます。コネクターを実行する前に、必ずこれらのプロパティーの値を設定してください。
標準コネクター構成プロパティーを構成するには、Connector Configurator Express ツールを使用します。 詳細については、付録B. Connector Configurator Expressに記載されています。このツールは、コネクターを構成するためのグラフィカル・ユーザー・インターフェースを提供します。「標準構成プロパティー (Standard Config Properties)」タブを選択し、構成プロパティーを追加または変更します。
コネクターの構成プロパティーの値の指定が終了すると、Connector Configurator Express が InterChange Server Express のアダプター・リポジトリーに値を保管します。
コネクターは、始動時に構成値を取得します。実行時のセッション中に、1 つ以上のコネクター・プロ パティーの値を変更できます。
プロパティーが動的と静的のいずれであるかを判別するには、Connector Configurator Express の 「更新メソッド」欄を参照してください。
アプリケーション固有のコネクター構成プロパティーは、アプリケーションに関連し、実行時にコネクターによって必要とされる情報を提供します。また、コネクター内の静的情報やロジックを、再コーディングや再ビルドを行わずに変更する方法も提供します。
これらのプロパティーを構成するには、Connector Configurator Express を使用し ます。 構成プロパティーを追加または変更するには、「アプリケーション構成プロパティー」タブを選択します。詳細については、付録B. Connector Configurator Expressを参照してください。
表 3 には、コネクターのアプリケー ション固有の構成プロパティーが、説明および指定可能な値とともにリストされてい ます。