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

Section InputFormatCollection

Cette section spécifie la structure de données récupérées à partir d'une source de données, la manière dont une ligne de données doit être découpée en champs et quels sont les formats et les types de champ. Le filtrage des données initiales et les manipulations de données peuvent être effectués dans cette section en utilisant les champs InputFormatSwitch et Compound respectivement.

Le flux de travaux général de cette section est le suivant :

• La ligne de données est comparée à une ou plusieurs spécifications InputFormats.
• Les données sont réparties dans des champs en fonction de la spécification InputFormat correspondante.
• Des valeurs sont assignées aux champs Compound en combinant et en scindant les champs de données.
• Les données traitées sont vérifiées par rapport aux conditions TranslatorSwitch.
• Les données traitées sont soit envoyées au convertisseur correspondant, soit ignorées.

Le noeud InputFormatCollection peut contenir un ou plusieurs noeuds InputFormat.

Structure XML :

<InputFormatCollection>
	<InputFormat InputFormatName="MyInputFormat">
	<InputFormatFields> 
		<InputFormatField Name="sid_id" Type="string"/>
		<InputFormatField Name="content" Type="string"/>
		<InputFormatField Name="date" Type="time" 
               TimeFormat="%d/%m/%Y %H:%M:%S"/>
		<InputFormatField Name="server" Type="string" 
               Source="compound">
		<Compound>
			<Segment SourceField="content" 
                     RegularExpression=".*Job server: ([^\n]+).*" />
		</Compound>
		</InputFormatField>
	</InputFormatFields>
<TranslatorSwitch DefaultTranslator="GeoTranslator">
	<TranslatorCase  TranslatorName="NonGeoTranslator" Break="yes">
		<Condition SourceField="routing_info" Operator="EQ"
             Value="cnano"/>
	</TranslatorCase>
</TranslatorSwitch>
</InputFormat>
</InputFormatCollection>

• InputFormat :
  • InputFormatName : nom attribué à ce format et utilisé par la section DataSourceInterface.
• RequiredFields (facultatif) : nombre minimum de champs censé se trouver dans une ligne de données. Une ligne contenant moins de champs est ignorée et une erreur est consignée.
• InputFormatFields : peut contenir un ou plusieurs noeuds de champs selon le nombre de champs d'entrée dans les sources de données.
  • InputFormatField : spécifie un champ de données de la ligne de données d'origine ou un champ composé.

    	<InputFormatField Name="timestamp" Type="time"
    	TimeFormat="%d/%m/%Y %H:%M:%S"/>
    

  • Name : nom attribué à ce champ et utilisé par d'autres éléments.
  • Type : type de données de champ, à savoir string/integer/real/time
  • Source (facultatif) : la valeur par défaut est event, avec les valeurs possibles suivantes :
  • event : valeur du champ de l'événement provenant de la source de données, les valeurs de champs suivent le même ordre que celui de la source de données.
  • compound : le champ est composé. Sa valeur lui est attribuée une fois que d'autres valeurs ou constantes de champs ont été manipulées d'une manière ou d'une autre.
  • title : la valeur du champ provient du nom de champ de titre. Le champ de référence doit déjà être défini.
  • filename : la valeur du champ provient du nom de fichier de la source de données, uniquement pour des adaptateurs de fichier texte.
  • constant : la valeur du champ est constant et elle provient de la propriété ConstantValue qui doit s'afficher à sa suite.
  • FieldTitleName : lorsque la source est title, spécifie le titre de champ à utiliser. Le champ source doit être défini à l'avance.
  • ConstantValue : quand la source est constant, spécifie la valeur à laquelle elle doit correspondre. Dans le cas d'un champ horaire, la valeur constant est formatée selon le format d'heure TimeFormat, Now ou NowUtc, Now correspondant à l'heure actuelle dans l'environnement linguistique de la source de données et NowUtc correspondant à l'heure en temps universel.
  • TimeFormat : format de date et d'heure pour lequel le champ est analysé. Les codes de caractère suivants peuvent être utilisés pour les formats de date et d'heure :

    

  • DecimalSymbol (facultatif) : symbole décimal des champs. Si ce n'est pas spécifié, le champ DefaultDecimalSymbol de la section General est utilisé.
  • DigitGroupingSymbol (facultatif) : symbole de groupement de chiffre par défaut pour les champs Integer et Real. Si ce n'est pas spécifié, le champ DefaultDigitGroupingSymbol de la section General est utilisé.
• Compound : obligatoire lorsque source=compound. Spécifie les manipulations de champ qui doivent être rassemblées dans un champ composé.
  • Segment : spécifie une manipulation de champ à ajouter au composé créé. Seul l'attribut SourceField est requis.
  • SourceField : champ utilisé en tant que source. Le champ de référence doit déjà être défini.
  • RegularExpression : expression régulière de manipulation.
  • MatchCase (facultatif) [yes/no] : définit si l'expression régulière respecte la casse.
  • SelectionStart : position de démarrage de l'extraction de texte, part de 0.
  • SelectionLength : taille de l'extraction de texte.
  • Prefix : chaîne devant recevoir un préfixe pour obtenir le résultat de la manipulation.
  • Suffix : chaîne devant recevoir un suffixe pour obtenir le résultat de la manipulation.
  • XpathExpression : expression xpath de manipulation.
• InputFormatSwitch : utilisé pour spécifier des critères de format, lorsque les lignes de données n'ont pas toutes le même format.

  Remarque : Lorsque vous utilisez InputFormatSwitch, l'ordre des noeuds InputFormat est important ; un champ de référence InputFormat doit déjà être défini.

  DefaultInputFormat : spécifie le nom InputFormat vers lequel il doit être dirigé, au cas où aucun critère ne soit satisfait.

• InputFormatCase : spécifie un critère à tester sur des lignes de données pour déterminer vers quel InputFormat il doit être dirigé.
• InputFormatName : le champ InputFormat à utiliser lorsque le critère correspond.
• LogicOperator : (facultatif) [and/or].
• and : toutes les conditions doivent être satisfaites. (valeur par défaut)
• or : au moins une condition doit être satisfaite
  • Condition : condition à tester sur une ligne de données pour déterminer son format.

    SourceField : champ à tester.

    Operator : type de test des options suivantes :

    • EQ : égal à
    • NE : pas égal à
    • GT : supérieur à
    • LT : inférieur à
    • GE : supérieur ou égal à
    • LE : inférieur ou égal à
    • MATCH : une expression régulière doit concorder
    • UNMATCH : une expression régulière ne doit pas concorder

    ValueType (facultatif) [constant/field/previousValue] :

    • constant : le contenu de l'attribut Value est constant indépendamment des données source
    • field : le contenu de l'attribut Value correspond au nom de champ du même enregistrement.
    • previousValue : le contenu de l'attribut Value correspond au nom de champ de l'enregistrement précédent dans la même requête avec le même format d'entrée.

    Value : valeur à faire concorder ou une expression régulière.

    MatchCase (facultatif) [yes/no] : définit si le test respecte la casse. Si défini sur yes, les deux valeurs sont converties en minuscules avant le test.

• TranslatorSwitch : détermine quel convertisseur doit être utilisé pour convertir la ligne de données en un événement unifié CA Business Service Insight.
  • DefaultTranslator : convertisseur à utiliser lorsqu'aucun critère n'est satisfait. Si la valeur est Ignore, aucun convertisseur n'est utilisé et la ligne est ignorée.
  • TranslatorCase : spécifie les critères à tester sur les données traitées afin de déterminer vers quel convertisseur il doit être dirigé.

    Break [yes|no]

    yes : (valeur par défaut) si les critères sont satisfaits, ne vérifiez pas les critères suivants.

    no : dans tous les cas, après avoir évalué les critères et fait fonctionner le convertisseur s'il concorde, passez au critère suivant.

    LogicOperator : (facultatif) [and/or].

    • and : toutes les conditions doivent être satisfaites. (valeur par défaut)
    • or : au moins une condition doit être satisfaite.

    TranslatorName : le convertisseur vers lequel se diriger si les conditions sont remplies.

    Condition : la condition à tester sur des données traitées afin de déterminer quel convertisseur pertinent doit être utilisé. Il s'agit de la même que la Condition de InputFormatSwitch.