实施指南 › 适配器配置规范 › CA Business Service Insight Interface 部分

CA Business Service Insight Interface 部分

CA Business Service Insight Interface 部分包括指定到 CA Business Service Insight 的连接的属性。 有两种模式；联机和脱机。 在联机模式下，适配器连接到 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”，否则可能会丢失一些事件。

• PacketSize -（可选）

  合法值 - 1 到 1000

  默认值 - 50

  一个数据包中的事件的最大数目。

• 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 -（可选）

  定义读取字段的十进制符号。

  默认值 - . （点）