Implementierungshandbuch › Eigenschaften der Adapterkonfiguration › CA Business Service Insight-Schnittstellenabschnitt

CA Business Service Insight-Schnittstellenabschnitt

Der CA Business Service Insight-Schnittstellenabschnitt besteht aus Attributen, die die Verbindung mit CA Business Service Insight angeben. Es gibt zwei Modi: online und offline. Im Onlinemodus stellt der Adapter eine Verbindung mit CA Business Service Insight her, ruft die Übersetzungstabellen und den Steuerbefehl von CA Business Service Insight ab und sendet Events, Statusmeldungen und Übersetzungsanfragen an CA Business Service Insight. Im Offlinemodus arbeitet der Adapter mit einer lokalen Übersetzungstabellendatei und schreibt die Events in eine Ausgabedatei.

XML-Struktur für Onlinemodus:

<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: TCP/IP-Portnummer, die der Adapter verwendet, um mit dem CA Business Service Insight-Server zu kommunizieren.
• ConnectionInitiator: optional

  Erlaubte Werte = server/adapter Standardwert = server

  Definiert den Verbindungsinitiator, die Adapterseite oder den Adapter-Listener auf CA Business Service Insight-Seite.

  Der Initiator fungiert als "Slave" oder Client, die andere Seite als "Master" oder "Server".

• Adresse: Netzwerkadresse des Servers; obligatorisch, wenn der Initiator der Adapter ist.
• SecurityLevel: Definiert die Authentifizierungsstufe zwischen dem Adapter und dem CA Business Service Insight-Server ("Handshake"). Optionen:
  • none: Keine Authentifizierung.
  • high: Authentifizierung. SecurityKey muss bereitgestellt werden.
• SecurityKey: String aus 32 Zeichen. Der String muss dem für den Adapter in der CA Business Service Insight-Datenbank definierten String entsprechen.

  Der "Handshake"-Prozess umfasst Folgendes:

  • Der CA Business Service Insight-Server stellt eine Verbindung mit dem Adapter her.
  • Ein Zufalls-String wird vom Adapter an den CA Business Service Insight-Server gesendet.
  • Der CA Business Service Insight-Server verschlüsselt den String mit einem vorkonfigurierten Schlüssel und sendet das Ergebnis zurück an den Adapter.
  • Der Adapter verschlüsselt denselben Zufalls-String, der an den CA Business Service Insight-Server gesendet wurde, mit dem SecurityKey-String und vergleicht die Ergebnisse.
  • Der CA Business Service Insight-Server wählt willkürlich einen String aus und sendet den String an den Adapter.
  • Der Adapter verschlüsselt den String und sendet ihn zurück an den CA Business Service Insight-Server.
  • Der CA Business Service Insight-Server verschlüsselt denselben String und vergleicht die Ergebnisse mit den Ergebnissen des Adapters.
  • Die Verbindung wird hergestellt.
  • Wenn ein Fehler auftritt, wird keine Verbindung hergestellt.
• UseAcknowledgeProtocol: optional

  Erlaubte Werte = [yes/no], Standardwert = yes

  "yes": Der Adapter verwendet das Quittierungsprotokoll. "no": Der Adapter sendet die Meldungen/Pakete und wartet nicht auf die Bestätigung durch CA Business Service Insight.

  Es wird nicht empfohlen, für dieses Attribut "no" zu wählen, da Events verloren gehen können.

• PacketSize: optional

  Erlaubte Werte = 1 bis 1 000

  Standardwert = 50

  Maximale Anzahl von Events in einem Paket

• PacketDeadline: optional

  Erlaubte Werte = 1 bis 3 600

  Standardwert = 60

  Anzahl der Sekunden, bevor nicht volle Pakete gesendet werden.

• PacketResendTimeout: optional

  Erlaubte Werte = 1 bis 3 600

  Standardwert = 60

  Zeit in Sekunden, die auf eine Bestätigungsmeldung gewartet werden soll, bevor das Paket erneut gesendet wird. Dieses Attribut ist nur anwendbar, wenn Sie für das Attribut "UseAcknowledgeProtocol" die Option "yes" wählen.

• WindowSize: optional

  Erlaubte Werte = 1 bis 100

  Standardwert = 10

  Anzahl von Paketen im Fenster Dieses Attribut ist nur anwendbar, wenn Sie für das Attribut "UseAcknowledgeProtocol" die Option "yes" wählen.

XML-Struktur für Offlinemodus:

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

• OutputFileName: optional

  Name der Datei, in der der Adapter die Ausgabe-Events speichert

  Standardwert = AdapterOutput.txt. (Wenn nicht anders angegeben, wird der Standardwert verwendet.)

• OutputFileType: optional

  Erlaubte Werte =csv/tsv/xml

  Definiert das Event-Format

• OutputTimeFormat: Definiert das Format der Datumsfelder Dieses Attribut kann ignoriert werden, wenn das Attribut "DefaultTimeFormat" im Abschnitt "General" angegeben wurde.
• OutputDecimalSymbol: optional

  Definiert das Dezimaltrennzeichen für Lesefelder

  Standardwert = . (Punkt)