Manuel d'implémentation › Spécifications de la configuration d'adaptateur › Section d'interface de CA Business Service Insight

Section d'interface de CA Business Service Insight

La section d'interface de CA Business Service Insight consiste en attributs spécifiant la connexion à CA Business Service Insight. Il existe deux modes : en ligne et hors ligne. En mode en ligne, l'adaptateur se connecte à CA Business Service Insight, récupère les tables de conversion et la commande de contrôle à partir de CA Business Service Insight et envoie les événements, les statuts et les requêtes de conversion à CA Business Service Insight. En mode hors ligne, l'adaptateur fonctionne avec un fichier de tables de conversion local et écrit les événements dans un fichier de sortie.

Structure XML du mode en ligne :

<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 : numéro de port TCP/IP que l'adaptateur utilise pour communiquer avec le serveur CA Business Service Insight.
• ConnectionInitiator : (facultatif)

  Valeurs autorisées : server/adaptater. Valeur par défaut : server.

  Définit l'initiateur de connexion, l'adaptateur ou l'écouteur d’adaptateur sur CA Business Service Insight.

  L'initiateur joue le rôle d'esclave ou de client, tandis que l'autre est le maître ou joue le rôle de serveur.

• Adresse : adresse réseau du serveur ; obligatoire lorsque l'initiateur est l'adaptateur.
• SecurityLevel : définit le niveau d'authentification entre l'adaptateur et le serveur CA Business Service Insight (poignée de main). Options de niveaux :
  • none : aucune authentification n'est effectuée.
  • high : l'authentification est effectuée. La clé SecurityKey doit être fournie.
• SecurityKey : chaîne de 32 chiffres. Ce doit être la même chaîne que celle définie sur l'adaptateur dans la base de données CA Business Service Insight.

  Le flux du processus poignée de main est le suivant :

  • Le serveur CA Business Service Insight se connecte à l'adaptateur.
  • Une chaîne au hasard est envoyée de l'adaptateur au serveur CA Business Service Insight.
  • Le serveur CA Business Service Insight chiffre la chaîne avec une clé préconfigurée et renvoie le résultat à l'adaptateur.
  • L'adaptateur chiffre la même chaîne aléatoire qui a été envoyée au serveur CA Business Service Insight à l'aide de la chaîne SecurityKey et compare les résultats.
  • Le serveur CA Business Service Insight constitue une chaîne et envoie la chaîne à l'adaptateur.
  • L'adaptateur chiffre la chaîne et la renvoie au serveur CA Business Service Insight.
  • Le serveur CA Business Service Insight chiffre la même chaîne et compare les résultats à ceux reçus de l'adaptateur.
  • La connexion est établie.
  • Si une défaillance est détectée dans l'une des phases du flux, la connexion n'est pas établie.
• UseAcknowledgeProtocol : (facultatif)

  Valeurs autorisées : [yes/no] Valeur par défaut : yes

  Lorsque cet attribut est défini sur yes, l'adaptateur utilise le protocole d'acquittement. Lorsqu'il est défini sur non, l'adaptateur envoie les messages/paquets et n'attend pas le message d'acquittement de CA Business Service Insight.

  Il est déconseillé de définir cet attribut sur no, car vous pourriez perdre des données importantes.

• PacketSize : (facultatif)

  Valeurs autorisées : de 1 à 1000

  Valeur par défaut : 50

  Nombre maximal d'événements dans un paquet.

• PacketDeadline : (facultatif)

  Valeurs autorisées : de 1 à 3600

  Valeur par défaut : 60

  Nombre de secondes écoulées avant l'envoi d'un paquet qui n'est pas complet.

• PacketResendTimeout : (facultatif)

  Valeurs autorisées : de 1 à 3600

  Valeur par défaut : 60

  Délai d'attente (en secondes) d'un message d'acquittement avant renvoi du paquet. Cet attribut est applicable uniquement lorsque l'attribut UseAcknowledgeProtocol est défini sur yes.

• WindowSize (facultatif) :

  Valeurs autorisées : de 1 à 100

  Valeur par défaut : 10

  Nombre de paquets dans la fenêtre. Cet attribut est applicable uniquement lorsque l'attribut UseAcknowledgeProtocol est défini sur yes.

Structure XML pour le mode hors ligne :

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

• OutputFileName : (facultatif)

  Nom du fichier dans lequel l'adaptateur écrit les événements de sortie.

  Valeur par défaut : AdapterOutput.txt (sauf indication contraire, c'est la valeur par défaut qui est utilisée).

• OutputFileType : (facultatif)

  Valeurs autorisées : csv/tsv/xml

  Définit le format d'événement.

• OutputTimeFormat : définit le format des champs de date. Vous pouvez ignorer cet attribut si l'attribut DefaultTimeFormat, dans la section General, a été défini.
• OutputDecimalSymbol : (facultatif)

  Définit le symbole décimal pour des champs réels.

  Valeur par défaut : . (point)