新規のコネクター構成ファイルを作成して名前を付けると、または既存のコネクター構成ファイルを開くと、Connector Configurator Express に構成画面が表示されます。構成画面には、必要な構成値のカテゴリーに対応する複数のタブがあります。
Connector Configurator Express では、コネクターで以下のカテゴリーのプロパティーに値が設定されている必要があります。
InterChange Server Express で実行されているコネクターの場合、以下のプロパティーの値も設定されている必要があります。
標準プロパティーとコネクター固有プロパティーの違いは、以下のとおりです。
「標準プロパティー」と「コネクター固有プロパティー」のフィールドは、どのフィールドが構成可能であるかを示すために色分けされています。
標準のプロパティーの値を変更するには、以下の手順を実行します。
特定の標準プロパティーの詳細を参照するには、「標準のプロパティー」タブ付きシートで該当するプロパティーの「説明」列にある項目を左マウス・ボタンでクリックします。全般ヘルプがインストールされている場合は、右側に矢印ボタンが表示されます。ボタンをクリックすると、「ヘルプ」ウィンドウが開き、標準プロパティーの詳細が表示されます。
インストールされている場合、全般ヘルプ・ファイルは <ProductDir>¥bin¥Data¥Std¥Help¥<RegionalSetting>¥ にあります。
コネクター固有の構成プロパティーの場合、プロパティー名の追加または変更、値の構成、プロパティーの削除、およびプロパティーの暗号化が可能です。プロパティーのデフォルトの長さは 255 文字です。
全般ヘルプ・ファイルがインストールされており、AdapterHelpName プロパティーがブランクの場合、Connector Configurator Express は <ProductDir>¥bin¥Data¥App¥Help¥<RegionalSetting>¥ に配置されているアダプター固有の全般ヘルプ・ファイルを指します。それ以外の場合、Connector Configurator Express は、<ProductDir>¥bin¥Data¥App¥Help¥<AdapterHelpName>¥<RegionalSetting>¥ に配置されているアダプター固有の全般ヘルプ・ファイルを指します。標準プロパティーの付録にある AdapterHelpName プロパティーの説明を参照してください。
各プロパティーごとに表示される「更新メソッド」は、変更された値をアクティブにするためにコンポーネント またはエージェントの再始動が必要かどうかを示します。
コネクター固有の構成プロパティーには、コネクターが実行時に必要とする情報が用意されています。また、このプロパティーには、コネクター内の静的情報やロジックを、コネクターの再コーディングや再ビルドなしに変更する方法が指定されます。
表 6 に、コネクターのコネクター固有の構成プロパティーを示します。プロパティーの説明については、以下の各セクションを参照してください。
名前 | 指定可能な値 | デフォルト値 | 必須 |
---|---|---|---|
ArchivingEnabled | true または false |
true |
Yes |
EventLog | ファイル名とファイルの場所 |
event.log |
No |
EventRecovery | abort または retry |
retry |
Yes |
FTPPollFrequency | ポーリング・サイクル数 |
No |
|
GenerateTemplate | BOName |
No |
|
OutputLog | 要求の処理中に、着信ビジネス・オブジェクトごとの次のシーケンス番号を登録するファイル |
Output.Log |
No |
PollQuantity | 各ポーリング時に処理されるイベントの数
|
25 |
No |
SortFilesOnTimestamp | true または false | False | No |
NoPoll | true または false | False | No |
アーカイブをオンにします。このプロパティーを true に設定した場合、イベント・ファイルがアーカイブ・ディレクトリーに指定の拡張子でアーカイブされます。このプロパティーを false に設定した場合は、イベント・ファイルはアーカイブされません。この場合、コネクターがすべてのイベントを統合ブローカーに送信した後、このファイルを削除します。詳細については、イベント・アーカイブの指定を参照してください。
デフォルト値は true です。
コネクターによって生成されたイベントのファイルの保管場所を示します。このファイルは、この製品がインストールされている connectors ディレクトリーの JText サブディレクトリーの中にあります。
デフォルト値は event.log です。
リカバリー動作を指定します。このプロパティーを retry に設定した場合、コネクターは event.log ファイルを使用して失敗したイベントをリカバリーします。このプロパティーを abort に設定した場合、コネクターは失敗したイベントを検出すると終了します。詳細については、イベント・ログ・ファイルを参照してください。
デフォルト値は retry です。
標準のポーリング・サイクル数を基準として、コネクターによる FTP サーバーのポーリング回数を決定します。例えば PollFrequency 標準構成プロパティーが 10000 に設定され、FTPPollFrequency が 6 に設定されている場合、コネクターはローカル・イベント・ディレクトリーに 10 秒ごとにポーリングし、リモート・ディレクトリーに 60 秒ごとにポーリングします。コネクターが FTP ポーリングを 実行するのは、このプロパティーに値を指定した場合のみです。FTPPollFrequency に 0 またはブランクが設定された場合、コネクターは FTP ポーリングを実行しません。デフォルトでは、ポーリングを実行しません。
このプロパティーのデフォルト値はありません。
コネクターの始動後に、コネクターがサポートされる各ビジネス・オブジェクト用のテンプレートを生成できるようにします。このプロパティーの構文は BOName;BOName になります。BOName には、特定のビジネス・オブジェクトの名前が入ります。例えば、Customer ビジネス・オブジェクトと Item ビジネス・オブジェクトの 2 つのテンプレートを生成する場合、Customer;Item と指定します。詳細については、テスト用サンプル・ビジネス・オブジェクトの生成を参照してください。
このプロパティーのデフォルト値はありません。
要求の処理中に、コネクターがビジネス・オブジェクトのタイプごとの固有の出力ファイルの作成時に使用するシーケンス番号を格納するファイルの名前を指定します。ファイルのフォーマットは以下のようになります。
BusinessObjectName = NextSequenceNumber
ここで、BusinessObjectName は要求ビジネス・オブジェクトの名前で、NextSequenceNumber は最近受け取ったビジネス・オブジェクトのシーケンス番号に 1 を加えた値を表します。例えば、コネクターが Customer と Item というビジネス・オブジェクトを処理している場合に、出力ログ・ファイルに以下の項目が入っているとします。
Customer = 12 Item = 2
このファイルは、コネクターがすでに 11 の Customer と 1 つの Item を処理済みであることを示しています。次の Customer と Item のビジネス・オブジェクトはそれぞれ、Customer_12.out ファイルと Item_2.out ファイルに書き込まれます。コネクターが、要求 Order ビジネス・オブジェクトを受け取ると、出力ログ・ファイルに新しい行を追加して、このビジネス・オブジェクトを Order_1.out ファイルに書き込みます。
FileSeqEnabled メタオブジェクトが true に設定されている場合、コネクターはこのシーケンス番号を使用して、各ビジネス・オブジェクト用に作成する出力ファイルに一意の名前を付けます。コネクターが各出力ファイルに名前を付けるとき、ビジネス・オブジェクトの名前、または OutputFileName メタオブジェクト属性に名前が指定されているファイルに下線 (_) とシーケンス番号を付加します。出力ログはユーザーが読み取り可能なフォーマットで格納されるため、標準のテキスト・エディターを使用してこのファイルを読んだり、値をリセットしたりすることができます。
OutputFileName 属性の詳細については、出力ファイル名の指定を参照してください。出力ログの詳細については、要求処理の指定を参照してください。生成されたファイルの名前を元に戻す方法については、ファイル名の戻りを参照してください。
デフォルトは Output.Log です。
ポーリングごとに処理するイベントの数を指定します。コネクターのポーリング・メソッドにより、指定の数のイベント・レコードを検索し、検索されたイベント・レコードを 1 回のポーリングで処理します。1 回のポーリングで複数のイベントを処理することで、アプリケーションが多数のイベントを生成するときのパフォーマンスを向上させることができます。ただし、ポーリング・メソッドによるイベントの処理中には統合ブローカーの要求がブロックされるため、イベント数にあまり大きい数を設定しないでください。各ポーリング呼び出しに時間がかかると、統合ブローカーの要求処理が遅れます。詳細については、JText コネクターのパフォーマンス調整を参照してください。
デフォルト値は 25 です。
アダプターは、タイム・スタンプに基づいてイベント・ファイルを選択できます。このプロパティーは、ポーリング時にアダプターによって少数の巨大なイベント・ファイルだけが選択された場合に、true に設定するのが最善です。小さなイベント・ファイルが数多く存在する場合は、各ポーリングでファイルをソートするためにかかる時間が超過しないようにするため、この値を false に設定します。
デフォルト値は False です。
このプロパティーが true に設定されている場合、アダプターはイベント処理を実行しません。アダプターは、要求処理の場合にのみ使用できます。
デフォルト値は False です。
「コネクター固有プロパティー」ウィンドウの「暗号化」チェック・ボックスにチェックマークを付けると、アプリケーション固有のプロパティーを暗号化することができます。値の暗号化を解除するには、「暗号化」チェック・ボックスをクリックしてチェックマークを外し、「検証」ダイアログ・ボックスに正しい値を入力し、「OK」をクリックします。入力された値が正しい場合は、暗号化解除された値が表示されます。
各プロパティーとそのデフォルト値のリストおよび説明は、各コネクターのアダプター・ユーザーズ・ガイドにあります。
プロパティーに複数の値がある場合には、プロパティーの最初の値に「暗号化」チェック・ボックスが表示されます。「暗号化」を選択すると、そのプロパティーのすべての値が暗号化されます。プロパティーの複数の値を 暗号化解除するには、そのプロパティーの最初の値の「暗号化」チェック・ボックスを クリックしてチェックマークを外してから、「検証」ダイアログ・ボックス で新規の値を入力します。 入力値が一致すれば、すべての複数値が暗号化解除されます。
標準のプロパティーの付録にある更新メソッドの説明を参照してください。
コネクターで使用するビジネス・オブジェクトを指定するには、Connector Configurator Express の「サポートされているビジネス・オブジェクト」タブを使用します。汎用ビジネス・オブジェクトと、アプリケーション固有のビジネス・オブジェクトの両方を指定する必要があり、またそれらのビジネス・オブジェクト間のマップの関連を指定することが必要です。
ビジネス・オブジェクト定義がコネクターでサポートされることを指定する場合や、既存のビジネス・オブジェクト定義のサポート設定を変更する場合は、「サポートされているビジネス・オブジェクト」タブをクリックし、以下のフィールドを使用してください。
ビジネス・オブジェクト定義がコネクターによってサポートされる ことを指定するには、System Manager を実行し、以下の手順を実行します。
サポートされるリストからビジネス・オブジェクトを削除する場合は、以下の手順を実行します。
サポートされるリストからビジネス・オブジェクトを削除すると、コネクター定義が 変更され、削除されたビジネス・オブジェクトはコネクターのこのインプリメンテーションで 使用不可になります。コネクターのコードに影響したり、そのビジネス・オブジェクト定義 そのものが System Manager から削除されることはありません。
ビジネス・オブジェクトがエージェント・サポートを備えている場合、システムはコネクター・エージェントを介してアプリケーションにデータを配布する際に そのビジネス・オブジェクトの使用を試みます。
一般に、コネクターのアプリケーション固有ビジネス・オブジェクトは、そのコネクターのエージェントによってサポートされますが、汎用ビジネス・オブジェクトはサポートされません。
ビジネス・オブジェクトがコネクター・エージェントによってサポートされるよう 指定するには、「エージェント・サポート」ボックスに チェックマークを付けます。「Connector Configurator Express」ウィンドウでは、「エージェント・サポート」を選択しても問題ないかどうかの検証は行われません。
コネクターの最大トランザクション・レベルは、そのコネクターがサポートする 最大のトランザクション・レベルです。
ほとんどのコネクターの場合、選択可能な項目は「最大限の努力」のみです。
トランザクション・レベルの変更を有効にするには、サーバーを再始動する必要があります。
各コネクターは、ビジネス・オブジェクト定義とそれらに関連付けられたマップのうち現在 InterChange Server Express でアクティブであるものを示すリストをサポートします。このリストは、「関連付けられたマップ」タブを選択すると表示されます。
ビジネス・オブジェクトのリストには、エージェントでサポートされるアプリケーション固有のビジネス・オブジェクトと、コントローラーがサブスクライブ・コラボレーションに送信する、対応する汎用オブジェクトが含まれます。マップの関連によって、アプリケーション固有のビジネス・オブジェクトを汎用ビジネス・オブジェクトに変換したり、汎用ビジネス・オブジェクトをアプリケーション固有のビジネス・オブジェクトに変換したりするときに、どのマップを使用するかが決定されます。
特定のソースおよび宛先ビジネス・オブジェクトについて一意的に定義されたマップを使用する場合、表示を開くと、マップは常にそれらの該当するビジネス・オブジェクトに関連付けられます。ユーザーがそれらを変更する必要はありません (変更できません)。
サポートされるビジネス・オブジェクトで使用可能なマップが複数ある場合は、そのビジネス・オブジェクトを、使用する必要のあるマップに明示的にバインドすることが必要になります。
「関連付けられたマップ」タブには以下のフィールドが表示されます。
これらは、「サポートされているビジネス・オブジェクト」タブで指定した、このコネクターでサポートされる ビジネス・オブジェクトです。「サポートされているビジネス・オブジェクト」タブでビジネス・オブジェクトを追加指定した場合、その内容は、「Connector Configurator Express」ウィンドウの「ファイル」メニューから「プロジェクトに保管」を選択して変更を保管した後に、このリストに反映されます。
この表示には、コネクターの、サポートされるビジネス・オブジェクトでの使用のためにシステムにインストールされたすべてのマップが示されます。各マップのソース・ビジネス・オブジェクトは、「ビジネス・オブジェクト名」表示でマップ名の左側に表示されます。
場合によっては、関連マップを明示的にバインドすることが必要になります。
明示的バインディングが必要なのは、特定のサポートされるビジネス・オブジェクトに複数のマップが存在する場合のみです。InterChange Server Express は、ブート時、各コネクターのサポートされるビジネス・オブジェクトのそれぞれにマップを自動的にバインドしようとします。複数のマップでその入力データとして同一のビジネス・オブジェクトが使用されている場合、サーバーは、他のマップのスーパーセットである 1 つのマップを見付けて、バインドしようとします。
他のマップのスーパーセットであるマップがないと、サーバーは、ビジネス・オブジェクトを単一のマップにバインドすることができないため、バインディングを明示的に設定することが必要になります。
以下の手順を実行して、マップを明示的にバインドします。
Connector Configurator Express の「セキュリティー」タブを使用して、メッセージに対してさまざまなプライバシー・レベルを設定できます。この機能は、DeliveryTransport プロパティーが JMS に設定されている場合にのみ使用できます。
デフォルトでは、プライバシーはオフになっています。使用可能にするには、「プライバシー」ボックスにチェック・マークを付けます。
「鍵ストア・ターゲット・システムの絶対パス名」は次のとおりです。
このパスとファイルは、コネクターを開始する予定のシステム、つまりターゲット・システム上に存在していなければなりません。
右側の「参照」ボタンは、ターゲット・システムが現在稼働中のシステムである場合にのみ使用できます。「プライバシー」が使用可能で、メニュー・バーの「ターゲット・システム」が「Windows」に設定されていなければ、これはグレー表示になります。
「メッセージのプライバシー・レベル」は、3 種類のメッセージ・カテゴリー (「全メッセージ」、「全管理メッセージ」、および「全ビジネス・オブジェクト・メッセージ」) ごとに次のように設定されます。
「鍵の保守」機能により、サーバーおよびアダプターの公開鍵を生成、インポート、およびエクスポートできます。
証明書をアダプターの鍵ストアにインポートできるようにするには、まずサーバーの鍵ストアから証明書をエクスポートする必要があります。「アダプター公開鍵のエクスポート」を選択すると、「アダプター公開鍵のエクスポート」ダイアログ・ボックスが表示されます。
「サーバー公開鍵のインポート」を選択すると、「サーバー公開鍵のインポート」ダイアログ・ボックスが表示されます。
アダプター・アクセス制御機能は、DeliveryTransport の値が IDL になっている場合にのみ使用可能になります。デフォルトでは、アダプターはゲスト ID を使用してログインします。「ゲスト ID の使用」ボックスにチェック・マークが付いていない場合は、「アダプター ID」フィールドと「アダプター・パスワード」フィールドが使用可能になります。
コネクター構成ファイルまたはコネクター定義ファイルを開くと、Connector Configurator Express は、そのファイルに含まれるロギングとトレースに関する値をデフォルト値として使用します。これらの値は、Connector Configurator Express 内で変更できます。
ログとトレースの値を変更するには、以下の手順を実行します。
データ・ハンドラー・セクションの構成が使用可能となるのは、DeliveryTransport の値に JMS を、また ContainerManagedEvents の値に JMS を指定した場合のみです。すべてのアダプターでデータ・ハンドラーを使用できるわけではありません。
これらのプロパティーに使用する値については、付録 A『コネクターの標準構成プロパティー』にある ContainerManagedEvents の下の説明を参照してください。