Section General

Manuel d'implémentation › Spécifications de la configuration d'adaptateur › Section General

Section General

La section General comporte des attributs et sous-noeuds comme suit :

Structure XML :

<General	
MajorVersion="2345"
MinorVersion="01245"
WorkingDirectoryName=" output"
DataSourceControlFileName="DatasourceControl.xml"
SendFileName="Send.txt"
SendControlFileName="SendControl.xml"
LogDebugMode="no"
ConsoleDebugMode="no"
RunOnce="yes"	
RepeatUntilDry="yes"
RuntimeErrorLimit="1"	
RetryRejectedEvents="yes"
RejectedEventsFileName="rejectedEvents.txt"
RejectedEventsUpperLimit="1000"
RegExUnlimitedSearch (V3.1 Patch)="no"
HoldRejectedEventsSpan="24"
GenerateStatistics="yes"
StatisticsFileName="MyStatistics.txt" >
KeepHistoricState="yes" >
DefaultTimeFormat="%Y/%m/%d-%H:%M:%S"
DefaultDecimalSymbol="."
DataSourceIdMaxLength="60"
DefaultDigitGroupingSymbol=","
SaveIllegalEvents ="no"
WriteEventErrorToLog ="yes"
IllegalEventsDirectoryName="xxxpath"
<DataSourceDifferenceFromUTC 
	DefaultOffset="2"
	TimeFormat="%Y/%m/%d-%H:%M:%S">
	<DayLightSaving 
		From="2001/04/09-12:00:00"
		To="2001/09/01-12:00:00"
		Shift="1"/>
</ DataSourceDifferenceFromUTC >
</General>

MajorVersion : spécifie le numéro de version majeure.
MinorVersion : spécifie le numéro de version mineure.
WorkingDirectoryName : (facultatif)
Spécifie le chemin d'accès par défaut des fichiers de sortie d'adaptateur (contrôle de source de données, conversion, envois).

Valeur par défaut : répertoire de sortie (dossier) du répertoire contenant le fichier de configuration.
DataSourceControlFileName : (facultatif)
Nom du fichier que l'adaptateur utilise pour suivre les derniers enregistrements de données récupérés à partir de la source de données.

Valeur par défaut : DataSourcecontrol.xml (sauf indication contraire, c'est la valeur par défaut qui est utilisée).
SendFileName : (facultatif)
Nom du fichier qui conserve les événements avant leur envoi à CA Business Service Insight.

Valeur par défaut : Send.txt (sauf indication contraire, c'est la valeur par défaut qui est utilisée).
SendControlFileName : (facultatif)
Nom du fichier que l'adaptateur utilise pour suivre le processus d'envoi.

Valeur par défaut : SendControl.xml (sauf indication contraire, c'est la valeur par défaut qui est utilisée).
DataSourceIdMaxLength :
Longueur maximale du champ DataSourceId de la table t_raw_data. Si l'utilisateur insère une chaîne dépassant cette longueur, une erreur se produit dans l'adaptateur.

Cette valeur doit être inférieure ou égale à la taille réelle de la table.

Valeur par défaut : 60
SaveIllegalEvents : s'il est sélectionné, cet attribut indique que les événements non autorisés doivent être écrits dans le fichier.
Valeur par défaut : no
WriteEventErrorToLog : permet de déterminer si les erreurs de données sont écrites dans la table T_Log.
Valeurs autorisées : [yes/no]

Valeur par défaut : yes
IllegalEventsDirectoryName (pas de valeur par défaut) :
SendFileName : (facultatif)
Nom du fichier qui conserve les enregistrements avant leur envoi à CA Business Service Insight.

Valeur par défaut : Send.txt (sauf indication contraire, c'est la valeur par défaut qui est utilisée).
§SendControlFileName : (facultatif)
Nom du fichier que l'adaptateur utilise pour suivre le processus d'envoi.

Valeur par défaut : SendControl.xml (sauf indication contraire, c'est la valeur par défaut qui est utilisée).
LogDebugMode : (facultatif)
Valeurs autorisées : [yes/no]

Lorsque cet attribut est défini sur yes, ce qui suit est envoyé dans le journal : ligne d'origine à partir de la source de données, résultats de l'analyse, Evénement unifié CA Business Service Insight.
ConsoleDebugMode : (facultatif)
Valeurs autorisées : [yes/no]

lorsque cet attribut est défini sur yes, les messages de débogage s'affichent sur la console.
- Indicateurs de lecture et de conversion des enregistrements :
  - . : pour un enregistrement lu et converti en un événement de sortie.
  - i : pour un enregistrement ignoré par l'analyseur d'expression régulière.
  - I : pour un enregistrement lu et ignoré par les tables de conversion.
  - R : pour un enregistrement lu, mais rejeté par la table de conversion (ne peut être converti par les tables de conversion).
  - X : pour un enregistrement ayant posé problème lors de son analyse syntaxique. Il sera ignoré et perdu ou enregistré dans le répertoire des événements non autorisés.
Remarque : Lorsque l'enregistrement lu passe par plus d'un convertisseur, l'indice d'enregistrement est mis entre parenthèses. Par exemple : [...] ou [RRI].
- Indicateurs de statut de l'adaptateur :
  - 0 : l'adaptateur est actif et ne lit pas d'enregistrement à la dernière seconde.
  - E : statut Erreur.
  - P : statut Pause.
  - S : commande d'arrêt reçue de CA Business Service Insight.
  - B : statut Bloqué, la table d'événements rejetés est saturée.
  - Indicateurs de tables de conversion :
  - L : attente des tables de conversion.
  - T : table de conversion envoyée par/reçue de CA Business Service Insight.
  - t : changements de la table de conversion envoyée par/reçue de CA Business Service Insight.
  - Indicateurs de connexion :
  - <Connecting CA Business Service Insight : tentative de connexion à CA Business Service Insight.
  - <Connecting CA Business Service Insight> : connexion établie.
  - <Connecting DataSource : tentative de connexion à la source de données.
  - <Connecting DataSource> : connexion établie.
RunOnce : (facultatif)
Valeurs autorisées : [yes/no]

lorsqu'il est défini sur no, l'adaptateur s'exécute continuellement.

Lorsqu'il est défini sur yes, l'adaptateur de fichier texte s'exécute, lit des enregistrements et s'arrête automatiquement. L'adaptateur de fichier lit des fichiers entiers, attend quelques secondes, essaie de lire de nouveaux enregistrements (selon la durée de mise en veille). S'il n'existe pas d'enregistrements de ce type, il s'arrête.

Un adaptateur SQL exécute chaque requête une seule fois. Si RepeatUntilDry est défini sur no, il s'arrête immédiatement. Si RepeatUntilDry est défini sur yes, il attend (selon la durée de mise en veille), essaie d'exécuter les requêtes à nouveau (selon la durée de mise en veille de la requête) et en l'absence de nouveaux enregistrements, il s'arrête.
RepeatUntilDry : (facultatif)
Valeurs autorisées : [yes/no] Valeur par défaut : yes

Voir l'attribut RunOnce ci-dessus.
RuntimeErrorsLimit : (facultatif)
Détermine la limite des erreurs (par exemple, pour des erreurs des événements d'entrée) avant le blocage de l'adaptateur. Lorsque sa valeur est égale à 0, l'adaptateur n'est pas bloqué.

Valeur par défaut : 1 (ce qui signifie que l'adaptateur est bloqué après la première erreur.)
RetryRejectedEvents : (facultatif)
Valeurs autorisées : [yes/no] Valeur par défaut : yes

Lorsque l'attribut est défini sur yes, les enregistrements qui doivent être convertis sont conservés dans le fichier d'événements rejetés, en attendant la conversion.

Il est déconseillé de définir cet attribut sur no, car vous pourriez perdre des données importantes.
RejectedEventsFileName : (facultatif)
Nom du fichier que l'adaptateur utilise pour suivre les enregistrements de données récupérées de la source de données et qui attendent la conversion.

Valeur par défaut : rejected.txt (sauf indication contraire, c'est la valeur par défaut qui est utilisée).
RejectedEventsUpperLimit : (facultatif)
Détermine la limite d'enregistrements rejetés conservés dans le fichier rejected.txt. Lorsque l'adaptateur atteint cette limite supérieure, il s'arrête et passe au statut bloqué jusqu'à ce que ces enregistrements soient convertis.

Valeur par défaut : 1000
RegExUnlimitedSearch : guide l'adaptateur dans la recherche complète conformément à l'expression régulière.
Valeurs autorisées : [yes/no]

Valeur par défaut : no
HoldRejectedEventsSpan : (facultatif)
Détermine le nombre d'heures pendant lesquelles il faut enregistrer le fichier d'événements rejetés. Si cet attribut n'est pas mentionné, l'adaptateur n'efface pas d'événement devant être géré avant le redémarrage de l'adaptateur.

Il est déconseillé d'utiliser cet attribut, car vous pourriez perdre des données importantes.
GenerateStatistics : (facultatif)
Valeurs autorisées : [yes/no] Valeur par défaut : yes

Lorsqu'il est défini sur yes, l'adaptateur crée un fichier de statistiques contenant des informations statistiques toutes les minutes.
StatisticsFileName : (facultatif)
Nom du fichier de statistiques.

Valeur par défaut : statistics.txt (sauf indication contraire, c'est la valeur par défaut qui est utilisée.)
KeepHistoricState : (facultatif)
Valeurs autorisées : [yes/no] Valeur par défaut : no

Lorsqu'il est défini sur yes, l'adaptateur enregistre tous les fichiers, sauf le fichier journal, dans un nouveau répertoire appelé Historic state jjmmaaaa-hhmmss, où jjmmaaaa et hhmmss représentent respectivement les formats de date et d'heure de création.
DefaultTimeFormat : (facultatif)
Format de date et d'heure par défaut. Si cet attribut est spécifié, il est utilisé comme format de date et d'heure à tout endroit où l'attribut TimeFormat est ignoré. S'il n'est pas spécifié, l'attribut TimeFormat dans les autres éléments est obligatoire.
DefaultDecimalSymbol : (facultatif)
Symbole décimal par défaut pour les champs réels.

Valeur par défaut : (sauf indication contraire, c'est la valeur par défaut qui est utilisée).
DefaultDigitGroupingSymbol : (facultatif)
Symbole de groupement par défaut des chiffres pour le nombre entier et les champs réels.

Valeur par défaut : (sauf indication contraire, c'est la valeur par défaut qui est utilisée).
DataSourceDifferenceFromUTC : indique le décalage horaire entre l'UTC et le fuseau horaire de la source de données de l'ordinateur.
- DefaultOffset : différence avec l'heure UTC lorsque la zone horaire n'est pas en heure d'été.
- TimeFormat : spécifie le format selon lequel les détails des heures d'été (décrits dans la suite du texte) doivent être analysés.
- DayLlightSaving : spécifie une période en heure d'été du fuseau horaire de la source de données. Cet élément est facultatif (ce qui signifie que s'il n'est pas sélectionné, il n'y a pas d'heures d'été indiquée) et il peut exister plus d'une fois. Lorsque certains éléments existent, ils doivent être ordonnés par heure et les périodes ne doivent pas empiéter les unes sur les autres.
  - From : date de début de la période.
  - To : date de fin de la période.
  - Shift : période horaire ajoutée à DefaultOffset pendant la période en heure d'été.