Guida all'implementazione › Specifiche di configurazione dell'adapter › Sezione Interface CA Business Service Insight

Sezione Interface CA Business Service Insight

La sezione Interface CA Business Service Insight è costituita da attributi che specificano la connessione a CA Business Service Insight. Sono presenti due modalità, in linea e non in linea. In modalità in linea, l'adapter si connette a CA Business Service Insight, riceve le tabelle di conversione e i comandi di controllo da CA Business Service Insight e invia eventi, stati e richieste di conversione a CA Business Service Insight. In modalità non in linea, l'adapter utilizza il file delle tabelle di conversione locale e scrive gli eventi in un file di output.

Struttura XML per la modalità in linea:

<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: numero di porta TCP/IP che l'adapter utilizza per comunicare con il server CA Business Service Insight.
• ConnectionInitiator: (facoltativo)

  Valori validi: server/adapter. Valore predefinito: server.

  Definisce l'iniziatore della connessione, l'adapter o il listener dell'adapter su CA Business Service Insight.

  L'iniziatore svolge il ruolo slave o client, mentre l'altro svolge il ruolo master o server.

• Address: indirizzo di rete del server obbligatorio quando l'iniziatore è l'adapter.
• SecurityLevel: definisce il livello di autenticazione tra l'adapter e il server CA Business Service Insight (handshake). Opzioni di livello:
  • none: non viene eseguita alcuna autenticazione.
  • high: autenticazione eseguita. SecurityKey deve essere specificato.
• Securitykey: stringa di 32 cifre. Deve essere la stessa stringa definita per l'adapter nel database CA Business Service Insight.

  Il flusso del processo di handshake è il seguente:

  • Il server CA Business Service Insight si connette all'adapter.
  • Una stringa casuale viene inviata dall'adapter al server CA Business Service Insight.
  • Il server CA Business Service Insight crittografa la stringa con una chiave preconfigurata e rinvia il risultato all'adapter.
  • L'adapter crittografa la stessa stringa casuale inviata al server CA Business Service Insight utilizzando la stringa SecurityKey e confronta i risultati.
  • Il server CA Business Service Insight compone una stringa in modo casuale e invia la stringa all'adapter.
  • L'adapter crittografa la stringa e la rinvia al server CA Business Service Insight.
  • Il server CA Business Service Insight crittografa la stessa stringa e confronta i risultati con i dati ricevuti dall'adapter.
  • La connessione è stabilita.
  • Se viene rilevato un errore in una delle fasi nel flusso, la connessione non viene stabilita.
• UseAcknowledgeProtocol: (facoltativo)

  Valori validi: [sì/no] Valore predefinito: "yes" (sì)

  Se impostato su "yes" (sì), l'adapter utilizza il protocollo di riconoscimento. Se impostato su "no", l'adapter invia i messaggi/pacchetti e non attende che la conferma di ricezione da CA Business Service Insight.

  Non è consigliato impostare l'attributo su "no", perché si potrebbero perdere eventi.

• PacketSize: (facoltativo)

  Valori validi: da 1 a 1000

  Valore predefinito: 50

  Numero massimo di eventi in un pacchetto.

• PacketDeadline: (facoltativo)

  Valori validi: da 1 a 3600

  Valore predefinito: 60

  Numero di secondi prima dell'invio di un pacchetto che non è pieno.

• PacketResendTimeout: (facoltativo)

  Valori validi: da 1 a 3600

  Valore predefinito: 60

  Quantità di tempo, in secondi, di attesa per il messaggio di conferma di ricezione prima del nuovo invio del pacchetto. Questo attributo è applicabile solo se l'attributo UseAcknowledgeProtocol è impostato su "yes" (sì).

• WindowSize: (facoltativo)

  Valori validi: da 1 a 100

  Valore predefinito: 10

  Numero di pacchetti nella finestra. Questo attributo è applicabile solo se l'attributo UseAcknowledgeProtocol è impostato su "yes" (sì).

Struttura XML per la modalità non in linea:

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

• OutputFileName: (facoltativo)

  Nome del file in cui l'adapter scrive gli eventi di output.

  Valore predefinito: AdapterOutput.txt (se non altrimenti specificato, viene utilizzato il valore predefinito).

• OutputFileType: (facoltativo)

  Valori validi: csv/tsv/xml

  Definisce il formato dell'evento.

• OutputTimeFormat: definisce il formato dei campi di data. Questo attributo può essere omesso se nella sezione General è stato definito l'attributo DefaultTimeFormat.
• OutputDecimalSymbol: (facoltativo)

  Definisce il simbolo decimale per i campi di tipo reale.

  Valore predefinito: . (punto)