実装ガイド › アダプタ設定の指定 › CA Business Service Insight Interface セクション

CA Business Service Insight Interface セクション

CA Business Service Insight Interface セクションの各属性では、CA Business Service Insight への接続を指定します。 オンラインとオフラインの 2 とおりのモードがあります。 オンライン モードでは、アダプタは CA Business Service Insight に接続した後、CA Business Service Insight から変換テーブルと制御コマンドを取得し、イベント、ステータス、および変換リクエストを CA Business Service Insight に送信します。 オフライン モードでは、アダプタはローカル変換テーブル ファイルを使用し、出力ファイルにイベントを書き込みます。

オンライン モードの XML 構造：

<OblicoreInterface
	Mode="online">
	<OnlineInterface
		Port="3006"
		ConnectionInitiator="server"
		Address="localhost"
		SecurityLevel="high"
		SecurityKey="12345678901234567890123456789012"
		UseAcknowledgeProtocol="yes"
		PacketSize="50"	
		PacketDeadline="60"
		PacketResendTimeout="60"
		WindowSize="10"
      />
</OblicoreInterface>

• Port - CA Business Service Insight サーバと通信するためにアダプタが使用する TCP/IP ポート番号
• ConnectionInitiator - （オプション）

  有効な値 - server/adapter デフォルト値 - server

  CA Business Service Insight 側で接続イニシエータ、アダプタ側、またはアダプタ リスナを定義します。

  イニシエータがスレーブ（クライアント）の役割になり、もう一方がマスタ（サーバ）の役割になります。

• Address - サーバのネットワーク アドレス。イニシエータがアダプタの場合に必要となります。
• SecurityLevel - アダプタと CA Business Service Insight サーバ間の認証のレベルを定義します（ハンド シェイク）。 レベルのオプション：
  • none - 認証が行われません。
  • high - 認証が行われます。 SecurityKey を指定する必要があります。
• SecurityKey - 32 桁の文字列。 CA Business Service Insight データベース内でアダプタに対して定義されている文字列と同じにする必要があります。

  「ハンドシェイク」プロセスの流れを以下に示します。

  • CA Business Service Insight サーバがアダプタに接続します。
  • アダプタから CA Business Service Insight サーバにランダムな文字列が送信されます。
  • CA Business Service Insight サーバは、事前に設定されたキーを含む文字列を暗号化してアダプタに返送します。
  • アダプタは SecurityKey 文字列を使用して、CA Business Service Insight サーバに送信された同じランダムな文字列を暗号化し、受信した文字列と比較します。
  • CA Business Service Insight サーバは、文字列をランダムに抽出してアダプタに送信します。
  • アダプタは、その文字列を暗号化して CA Business Service Insight サーバに返送します。
  • CA Business Service Insight サーバは同じ文字列を暗号化し、アダプタから受信した文字列と比較します。
  • 接続が確立されます。
  • 上記のいずれかの段階で誤りが検出された場合は、接続が確立されません。
• UseAcknowledgeProtocol - （オプション）

  有効な値 - yes/no、デフォルト値 - yes

  「yes」に設定すると、アダプタは確認プロトコルを使用します。 「no」に設定すると、アダプタは CA Business Service Insight からの確認応答を待たずにメッセージ/パケットを送信します。

  この属性を「no」に設定しないことをお勧めします。「no」に設定すると、イベントが失われる可能性があります。

• PacketSize - （オプション）

  有効な値 - 1 ～ 1000

  デフォルト値 - 50

  1 つのパケットに含まれるイベントの最大数

• PacketDeadline - （オプション）

  有効な値 - 1 ～ 3600

  デフォルト値 - 60

  不完全なパケットが送信されるまでの秒数

• PacketResendTimeout - （オプション）

  有効な値 - 1 ～ 3600

  デフォルト値 - 60

  パケットが再送信されるまで確認応答メッセージを待機する時間（秒単位）。 この属性は、UseAcknowledgeProtocol 属性が「yes」に設定されている場合にのみ適用されます。

• WindowSize - （オプション）

  有効な値 - 1 ～ 100

  デフォルト値 - 10

  ウィンドウ内のパケットの数。 この属性は、UseAcknowledgeProtocol 属性が「yes」に設定されている場合にのみ適用されます。

オフライン モードの XML 構造：

<OblicoreInterface
	Mode="offline">
	<OfflineInterface
		OutputFileName="outputEvents.txt"
		OutputFileType="tsv"
		OutputTimeFormat="%Y/%m/%d %H:%M:%S"
		OutputDecimalSymbol="."
	/>
</OblicoreInterface>

• OutputFileName - （オプション）

  アダプタが出力イベントを書き込むファイルの名前。

  デフォルト値 - AdapterOutput.txt（他の値を指定しないと、この値がデフォルト値として使用されます。）

• OutputFileType - （オプション）

  有効な値 - csv/tsv/xml

  イベントの形式を定義します。

• OutputTimeFormat - 日付フィールドの形式を定義します。 General セクションで DefaultTimeFormat 属性が定義されている場合は、この属性を省略してもかまいません。
• OutputDecimalSymbol - （オプション）

  実数フィールドに使用される小数点記号を定義します。

  デフォルト値 - . （小数点）