コネクター固有のプロパティー・テンプレートの作成
コネクターの構成ファイルを作成するには、コネクター固有プロパティーのテンプレートとシステム提供の標準プロパティーが必要です。
コネクター固有プロパティーのテンプレートを新規に作成するか、または既存のコネクター定義をテンプレートとして使用します。
- テンプレートの新規作成については、新規テンプレートの作成を参照してください。
- 既存のファイルを使用する場合には、既存のテンプレートを変更し、新しい名前でこのテンプレートを保管します。既存のテンプレートは ¥WebSphereAdapters¥bin¥Data¥App ディレクトリーにあります。
新規テンプレートの作成
このセクションでは、テンプレートでプロパティーを作成し、プロパティーの一般特性および値を定義し、プロパティー間の依存関係を指定する方法について説明します。次にそのテンプレートを保管し、新規コネクター構成ファイルを作成するためのベースとして使用します。
Connector Configurator でテンプレートを作成するには、以下のステップを実行します。
- 「ファイル」>「新規」>「コネクター固有プロパティー・テンプレート (Connector-Specific Property
Template)」とクリックします。
- 「コネクター固有プロパティー・テンプレート」 ダイアログ・ボックスが表示されます。
- 「新規テンプレート名を入力してください」の下の「名前」フィールドに、新規テンプレートの名前を入力します。テンプレートから新規構成ファイルを作成するためのダイアログ・ボックスを開くと、この名前が再度表示されます。
- テンプレートに含まれているコネクター固有のプロパティー定義を調べるには、「テンプレート名」表示でそのテンプレートの名前を選択します。そのテンプレートに含まれているプロパティー定義のリストが「テンプレートのプレビュー」表示に表示されます。
- テンプレートを
作成するときには、コネクターに必要なプロパティー定義に類似したプロパティー定義
が含まれている既存のテンプレートを使用できます。ご使用のコネクターで使用するコネクター固有のプロパティーが表示される
テンプレートが見つからない場合は、自分で作成する必要があります。
- 既存のテンプレートを変更する場合には、「変更する既存のテンプレートを選択してください: 検索テンプレート」の下の「テンプレート名」テーブルのリストから、テンプレート名を選択します。
- このテーブルには、現在使用可能なすべてのテンプレートの名前が表示されます。
テンプレートを検索することもできます。
一般特性の指定
「次へ」をクリックしてテンプレートを選択すると、「プロパティー: コネクター固有プロパティー・テンプレート」ダイアログ・ボックスが表示されます。このダイアログ・ボックスには、定義済みプロパティーの「一般」特性のタブと「値」の制限のタブがあります。「一般」表示には以下のフィールドがあります。
- 一般:
プロパティー・タイプ
プロパティー・サブタイプ (Property Subtype)
更新されたメソッド
説明
- フラグ
標準のフラグ
- カスタム・フラグ
フラグ
「プロパティー・タイプ」 が String である場合に、「プロパティー・サブタイプ (Property Subtype)」を選択できます。構成ファイルの保管時に構文検査機能を提供するオプションの値です。デフォルトはブランク・スペースで、プロパティーのサブタイプが指定されていないことを意味します。
プロパティーの一般特性の選択を終えたら、「値」タブをクリックします。
値の指定
「値」タブを使用すると、プロパティーの最大長、最大複数値、デフォルト値、または値の範囲を設定できます。また、編集可能な値も設定できます。これを行うには、以下のステップを実行します。
- 「値」タブをクリックします。「一般」のパネルに代わって「値」の表示パネルが表示されます。
- 「プロパティーを編集」表示でプロパティーの名前を選択します。
- 「最大長」および「最大複数値」のフィールドに値を入力します。
新規プロパティー値を作成するには、以下のステップを実行します。
- 「値」列見出しの左側の正方形をクリックします。
- ポップアップ・メニューから「追加」を選択して、「プロパティー値」ダイアログ・ボックスを表示します。プロパティー・タイプに応じて、ダイアログ・ボックスでは、値を入力するか、または値と範囲の両方を入力できます。
- 新規プロパティー値を入力し、「OK」をクリックします。右側の「値」パネルに値が表示されます。
「値」パネルには、3 つの列からなるテーブルが表示されます。
「値」の列には、「プロパティー値」ダイアログ・ボックスで入力した値と、作成した以前の値が表示されます。
「デフォルト値」の列では、値のいずれかをデフォルトとして指定することができます。
「値の範囲」の列には、「プロパティー値」ダイアログ・ボックスで入力した範囲が表示されます。
値が作成されて、グリッドに表示されると、そのテーブルの表示内から編集できるようになります。
テーブルにある既存の値の変更を行うには、その行の行番号をクリックして行全体を選択します。次に「値」フィールドを
右クリックし、「値の編集 (Edit Value)」をクリックします。
依存関係の設定
「一般」タブと「値」タブ
で変更を行ったら、「次へ」をクリックします。「依存関係: コネクター固有プロパティー・テンプレート」ダイアログ・ボックスが表示されます。
依存プロパティーは、別のプロパティーの値が特定の条件に合致する場合にのみ、テンプレートに組み込まれて、構成ファイルで使用されるプロパティーです。例えば、テンプレートに PollQuantity が表示されるのは、トランスポート機構
が JMS であり、DuplicateEventElimination が True に設定
されている場合のみです。
プロパティーを依存プロパティーとして指定し、依存する条件を設定するには、以下のステップを実行します。
- 「使用可能なプロパティー」表示で、依存プロパティーとして指定するプロパティーを選択します。
- 「プロパティーを選択」フィールドで、ドロップダウン・メニューを使用して、条件値を持たせるプロパティーを選択します。
- 「条件演算子」フィールドで以下のいずれかを選択します。
== (等しい)
!= (等しくない)
> (より大)
< (より小)
>= (より大か等しい)
<= (より小か等しい)
- 「条件値」フィールドで、依存プロパティーをテンプレートに組み込むために必要な値を入力します。
- 「使用可能なプロパティー」表示で強調表示された依存プロパティーで、矢印をクリックし、「依存プロパティー」表示に移動させます。
- 「完了 (Finish)」をクリックします。Connector Configurator により、XML 文書として入力した情報が、Connector Configurator がインストールされている ¥bin ディレクトリーの ¥data¥app の下に保管されます。
パス名の設定
パス名の設定の一般的な規則のいくつかを以下に示します。
- Windows および UNIX でのファイル名の最大長は、255 文字です。
- Windows では、絶対パス名は [Drive:][Directory]¥filename という形式に従う必要があります。
例えば、C:¥WebSphereAdapters¥bin¥Data¥Std¥StdConnProps.xml とします。
UNIX では、最初の文字は / でなければなりません。
- キュー名の先頭または途中にスペースを使用することはできません。
