Guia de Implementação › Especificações de configuração do conector › Seção Interface do CA Business Service Insight

Seção Interface do CA Business Service Insight

A seção Interface do CA Business Service Insight consiste em atributos especificando a conexão com o CA Business Service Insight. Há dois modos: online e offline. No modo online, o conector se conecta ao CA Business Service Insight, obtém as tabelas de conversão e o comando de controle do CA Business Service Insight, e envia eventos, status e solicitações de conversão ao CA Business Service Insight. No modo offline, o conector usa um arquivo de tabelas de conversões local e grava os eventos no arquivo de saída.

Estrutura do XML para o modo online:

<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 - o número da porta TCP/IP que o conector usa para se comunicar com o servidor do CA Business Service Insight.
• ConnectionInitiator (opcional)

  Valores válidos: "server" e "adapter" - valor padrão: "server"

  Define o iniciador da conexão, da parte do conector ou o listener de conectores da parte do CA Business Service Insight.

  O iniciador atua como 'subordinado' ou cliente, enquanto que o outro atua como o 'mestre' ou servidor.

• Address - o endereço de rede do servidor é obrigatório quando o iniciador é o conector.
• SecurityLevel - define o nível de autenticação entre o conector e o servidor do CA Business Service Insight ("Hand Shake"). Opções de nível:
  • none - nenhuma autenticação é realizada.
  • high - a autenticação é realizada. A SecurityKey deve ser fornecida.
• SecurityKey - texto de 32 dígitos. É preciso que seja o mesmo texto que o definido para o conector no banco de dados do CA Business Service Insight.

  O fluxo do processo de "handshake" é o seguinte:

  • O servidor do CA Business Service Insight estabelece conexão com o conector.
  • Um texto aleatório é enviado do conector ao servidor do CA Business Service Insight.
  • O servidor do CA Business Service Insight criptografa o texto com uma chave pré-configurada e envia o resultado de volta ao conector.
  • O conector criptografa o mesmo texto aleatório enviado ao servidor do CA Business Service Insight usando o texto da SecurityKey e compara os resultados.
  • O servidor do CA Business Service Insight torna um texto aleatório e envia o texto ao conector.
  • O conector criptografa o texto e o envia de volta ao servidor do CA Business Service Insight.
  • O servidor do CA Business Service Insight criptografa o mesmo texto e compara os resultados com o que foi recebido do conector.
  • A conexão é estabelecida.
  • Se algum erro for detectado em alguma fase do fluxo, a conexão não foi estabelecida.
• UseAcknowledgeProtocol (opcional)

  Valores válidos: "yes" e "no" - valor padrão: "yes"

  Quando definido como yes, o conector usa o protocolo de reconhecimento. Quando definido como no, o conector envia as mensagens e os pacotes, sem aguardar o reconhecimento do CA Business Service Insight.

  Não é recomendado definir este atributo como "no" para evitar a perda de eventos importantes.

• PacketSize (opcional)

  Valores válidos: de 1 a 1000

  Valor padrão: 50

  Número máximo de eventos em um pacote.

• PacketDeadline (opcional)

  Valores válidos: de 1 a 3600

  Valor padrão: 60

  Número de segundos antes de enviar um pacote que não esteja completo.

• PacketResendTimeout (opcional)

  Valores válidos: de 1 a 3600

  Valor padrão: 60

  Quantidade de tempo em segundos a aguardar pela mensagem de reconhecimento antes de enviar o pacote novamente. Este atributo aplica-se apenas quando o atributo UseAcknowledgeProtocol é definido como yes.

• WindowSize (opcional)

  Valores válidos: de 1 a 100

  Valor padrão: 10

  Número de pacotes na janela. Este atributo aplica-se apenas quando o atributo UseAcknowledgeProtocol é definido como yes.

Estrutura do XML para o modo offline:

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

• OutputFileName (opcional) -

  Nome do arquivo em que o conector grava os eventos de saída.

  Valor padrão: AdapterOutput.txt (se não for especificado, é usado o valor padrão).

• OutputFileType (opcional)

  Valores válidos: "csv", "tsv" e "xml"

  Define o formato do evento.

• OutputTimeFormat - define o formato dos campos de data. Este atributo pode ser omitido se o atributo DefaultTimeFormat, na seção General, tiver sido definido.
• OutputDecimalSymbol (opcional) -

  Define o símbolo decimal para ler os campos.

  Valor padrão: . (ponto)