コネクターの構成

コネクターの構成プロパティーには、標準構成プロパティーとアダプター固有の構成プロパティーという 2 つのタイプがあります。Connector Configurator Express (WebSphere Business Integration Server Express に付属のツール) を使用してアダプターを実行する前に、これらのプロパティーの値を設定する必要があります。コネクター構成プロパティーの値の指定が完了すると、それらの値は Connector Configurator Express によりリポジトリーに保管されます。これにより、アダプターの始動時にこれらのプロパティー値が使用可能になります。

Connector Configurator Express を使用してコネクター・プロパティーを構成します。

標準構成プロパティー

標準構成プロパティーにより、すべてのアダプターによって使用される情報が提供されます。これらのプロパティーの資料については 付録A. コネクターの標準構成プロパティーを参照してください。

コネクターは、始動時に構成値を取得します。実行時セッション中に、1 つまたは複数のコネクター・プロパティーの値を変更することがあります。

プロパティーが動的であるか静的であるかを判別するには、Connector Configurator Express の「更新メソッド」欄を参照してください。

ロギング・パラメーターとトレース・パラメーターは標準構成プロパティーである点に注意してください。ロギングとトレースのセットアップ方法の詳細については、付録A. コネクターの標準構成プロパティーを参照してください。

アプリケーション固有の構成プロパティー

アプリケーション固有のコネクター構成プロパティーは、コネクターが実行時に必要とする情報を提供します。これらのプロパティーを使用すれば、再コーディングや再ビルドせずに、コネクター内の静的情報やロジックを変更できます。

これらのプロパティーを表示および構成するには、Connector Configurator Express の「アプリケーション構成プロパティー (Application Config Properties)」タブを選択し、構成プロパティーを追加または変更します。詳細については、付録B. Connector Configurator Expressを参照してください。

表 5 に、コネクターのアプリケーション固有構成プロパティーと、各プロパティーの説明および指定可能な値を示します。

表 5. Lotus Domino のアプリケーション固有の構成プロパティー
プロパティー 説明 デフォルト値
DominoServerName Lotus Domino Server のマシン名 String なし。
ApplicationUserName Lotus Domino ユーザーの名前このプロパティーは、双方向言語に構成できます。 String なし。このプロパティーは、双方向言語に構成できます。
ApplicationPassword Lotus Domino ユーザーのパスワード。このプロパティーは、双方向言語に構成できます。 String なし。
EventDBName Lotus Domino イベント・データベース名。 String BIALD_EventTable.nsf
DocumentBOName Lotus Domino のビジネス・オブジェクト名。 String DominoDocument
ForceSave アダプターが Create 要求または Update 要求を
処理するときに ForceSave が true であると、
アダプターによる要求の処理時に 文書が他のユーザーまたはコンポーネントにより 編集、保管されている場合でも、この文書は強制 的に保管され、前のバージョンの文書は破棄され ます。
ForceSave が false であり、アダプターによる
要求の処理時に他のユーザーまたはコンポーネ
ントがこの文書を編集している場合の処理結果は、
MakeResponse プロパティーによって決まります。
Boolean false
MakeResponse アダプターが Create 要求または Update 要求を
処理するときに、ForceSave が false であり
MakeResponse が true の場合には、現行の文書
が元の文書への返答になります。
MakeResponse が false の場合には、保管操作が
取り消されます。
ForceSave が true の場合には、MakeResponse
プロパティーの設定値は無効です。
Boolean true
ForceDelete アダプターが Delete 要求を処理するときに
ForceDelete が true であると、アダプターにより
開かれた文書を別のユーザーが変更している場合でも、
この文書が削除されます。
ForceDelete が false であり、アダプターにより
開かれた文書を別のユーザーが変更している場合には、
この文書は削除されません。
Boolean false
InDoubtEvents InProgress イベントのリカバリー・オプションです。指定できる値は Reprocess、FailOnStartup、
LogError、または Ignore です。
これらのオプションの詳細については、
表 6 を参照してください。
String Reprocess
DateFormats 着信するビジネス・オブジェクトの Created と LastModified の有効な日付形式です。
統合ブローカーからビジネス・オブジェクトを受信する場合には、 Lotus Domino アダプターによりこのオブジェクトの Created と LastModified の日付が、 Lotus Domino Server が認識できる Java 形式に変換されます。
複数の形式を指定できます。
複数の形式を指定するときには、セミコロン (;) で各形式を区切ります。
アダプターにより、指定の形式の着信日付がリストの順序に従って比較されます。
日付形式が指定されていない場合には、アダプターのホスト・システムの日付形式が使用されます。
日付形式は、Java 2 Platform, Standard Edition (J2SE) v1.3.1 の java.text.SimpleDateFormat API で要求される日付形式と一致していなければなりません。
String MM/dd/yy hh:mm aaa; MM/dd/yy

DominoServerName、ApplicationUserName、および ApplicationPassword を構成する必要があります。統合ブローカーから受信されるビジネス・オブジェクトでサーバー名、ユーザー名、およびパスワードが定義されている場合には、Lotus Domino Server とアダプターのセッションを確立するときにこれらの情報が使用されます。ビジネス・オブジェクトにこれらの情報が含まれていない場合には、アダプターでは構成ファイルでこれらの項目に定義されている値が使用されます。

InDoubtEvents に指定できる値については、表 6 を参照してください。未確定イベントとは、イベントの送信が成功または失敗したかどうかを示すイベント状況を更新する前にアダプターが終了した場合に、アダプターの終了時に処理中であったイベントです。アダプターを再始動すると、アダプターは処理中だったイベントをイベント表で確認し、InDoubtEvents プロパティーに設定されているオプションに基づいて処理を行います。

表 6. InDoubtEvents プロパティーに指定できる値
InDoubtEvents の値 説明
Reprocess 後続のポーリング呼び出しでイベントが再実行依頼されます。
: この値を指定すると、イベントが重複して作成される可能性があります。イベントの重複を防ぐには、別のオプションを使用します。
FailOnStartup 致命的エラーをログに記録してアダプターをシャットダウンします。
LogError エラーをログに記録しますが、アダプターをシャットダウンしません。
Ignore イベント表の進行中イベント・レコードを無視します。

Copyright IBM Corp. 2004, 2005