Manuel d'implémentation › Implémentation › Collecte de données (expert en sources de données) › Configuration des adaptateurs et des conversions › Etude de cas d'un adaptateur de fichier › Section TranslatorCollection du fichier de configuration

Section TranslatorCollection du fichier de configuration

La section Translator Collection définit comment l'enregistrement de source de données analysé et manipulé extrait des sections précédentes sera converti en un événement CA Business Service Insight.

Cette section définit également comment traiter des événements dupliqués et comment utiliser le mécanisme de singularité d'événement (pour plus de détails, voir Singularité d'événement).

Lorsque le mode d'interface est défini comme en ligne, l'événement CA Business Service Insight a une structure unifiée qui contient les champs suivants :

• Timestamp : Moment d'occurrence de l'événement.
• ResourceId :ID de ressource associée à l'événement (la ressource mesurée dans cet événement).
• EventTypeId : Type d'événement associé à l'événement ; décrit le type d'événement (type de dimension de la ressource, type de l'action de ticket, etc.).
• DataSourceId (facultatif) : Toute valeur. Fournit des critères supplémentaires de filtrage pour les événements de données brutes.
• Value (multiple) : Valeur(s) de l'événement (résultat de dimension, numéro de ticket, etc.). Ce champ s'affiche souvent plusieurs fois.

La structure du convertisseur correspond à la structure du type d'événement dans CA Business Service Insight, et également à la table de base de données T_RAW_DATA qui contient l'événement, comme illustré ci-dessous :

• Translator : décrit la méthode de conversion de l'ensemble de champs qu'il reçoit dans un événement de sortie.
• TranslatorName : Nom utilisé par InputFormat pour envoyer les définitions de champ à ce convertisseur. Cet exemple utilise le nom « Translator1 ». L'illustration précédente contient des valeurs utilisables pour ce scénario.
• TranslatorFields : Contient une liste d'éléments TranslatorField, dont chacun contient les attributs suivants :
  • Name : Nom de champ. Dans l'interface en ligne ce nom doit être Horodatage, ResourceId, EventTypeId, ResourceId ou Valeur.
  • SourceType : Spécifie la source de la valeur du champ. Elle peut être l'un des éléments suivants :
    • Field : La valeur de ce champ provient du champ au format d'entrée. L'attribut SourceName contient le nom de champ d'InputFormat.
    • Table : La valeur de ce champ provient de la table de conversion. L'attribut SourceName contient le nom de la table de conversion qui référence un nom défini dans la section suivante de TranslationTableCollection. Ce type est utilisé pour les valeurs qui sont choisies pour être converties en ressources et types d'événement dans l'événement.
    • Lookup : La valeur de ce champ provient de la table de conversion. L'attribut SourceName contient le nom de la table. Valeur à convertir de l'attribut LookupValue et non du format d'entrée. Elle est couramment utilisée lorsqu'une valeur constante est nécessaire pour les conversions.
    • Constant : La valeur de ce champ est une constante provenant de l'attribut ConstantValue. Lorsqu'une valeur constante est utilisée, il est nécessaire de spécifier le type de champ à l'aide de l'attribut Type.
  • SourceName : Contient le nom du champ ou de la table de conversion.
  • LookupValue : Contient la valeur de l'élément de recherche lorsque SourceType="lookup".
  • ConstantValue : Contient la valeur constante lorsque SourceType=constant. Dans le cas d'un champ horaire, la valeur constante est formatée selon le format de temps TimeFormat (défini dans la section Général de l'adaptateur) ou « Now » ou « NowUtc », où « Now » correspond à l'heure actuelle dans le paramétrage régional de la source de données et « NowUtc » correspond à l'heure en temps universel.

Cette section contient également les tables de mappage définissant le mappage des valeurs de source de données en champs événements de CA Business Service Insight et contient la définition de table avec la valeur de source de données référencée à convertir.

• LoadingMode : La valeur par défaut est « distante » pour l'interface en ligne et « autonome » pour l'interface hors ligne.

  La méthode de chargement des tables de conversion doit être spécifiée comme suit :

  • Standalone : L'adaptateur charge les tables de conversion localement. Il n'y a aucune connexion au serveur CA Business Service Insight pour la conversion. Les changements dans les tables de conversion sont stockés uniquement dans le fichier local.
  • Remote : L'adaptateur envoie une demande pour charger toutes les tables du serveur CA Business Service Insight. Les changements apportés dans les tables de conversion sont également stockés localement.
• TranslationTable : Lie la valeur d'événement à la table de mappage.
  • Name : Nom de la table de conversion utilisée et référencée par le convertisseur.
  • DestinationType : [ressource, event_type, contract_party, service, time_zone, value]. Contient le type de table de conversion. Dans cet exemple, la colonne Serveurs du fichier de source de données est convertie en ressource CA Business Service Insight. Par conséquent, le type de la table de conversion est Ressource, et elle contient les conversions des valeurs des ID Ressource dans CA Business Service Insight.
  • TranslationField : Nom du champ à convertir, provenant des champs de format d'entrée. Peut contenir un maximum de cinq champs.

Chaque table de conversion définie dans le fichier de configuration doit correspondre à une définition dans l'interface utilisateur de CA Business Service Insight.

La représentation XMLE d'un fichier de configuration échantillon est comme suit :

<?xml version="1.0" encoding="utf-8"?>
<AdapterConfiguration>
     <General MajorVersion="4" MinorVersion="0" RunOnce="yes" LogDebugMode="yes"
ConsoleDebugMode="yes" WorkingDirectoryName="output" RejectedEventsUpperLimit="10000">
     <DataSourceDifferenceFromUTC DefaultOffset="0" TimeFormat="%d/%m/%Y %H:%M">
          <DaylightSaving From="20/04/2001 00:00" To="15/10/2001 00:00" Shift="1"/>
     </DataSourceDifferenceFromUTC>
</General>
     <OblicoreInterface Mode="online">
          <OnlineInterface Port="5555" SecurityLevel="none"/>
     </OblicoreInterface>
     <DataSourceInterface>
          <Files>
               <File DeleteFileAfterProcessing="no" InputFormat="InputFormat1" NamePattern="servers*.csv" Path=" C:\Program Files\Oblicore\Adapters\ServersAdapter\data\" TitleExists="yes" SleepTime="60" Delimiters=","/>
      </Files>
</DataSourceInterface>
<InputFormatCollection>
     <InputFormat InputFormatName="InputFormat1">
          <InputFormatFields>
               <InputFormatField Name="resource" Type="string"/>
                    <InputFormatField Name="timestamp" Type="time" TimeFormat="%d.%m.%Y %H:%M"/>
                        <InputFormatField Name="memory_util" Type="real"/>
                        <InputFormatField Name="cpu_util" Type="real"/>
                </InputFormatFields>
     <TranslatorSwitch DefaultTranslator="Translator1"/>
     </InputFormat>
</InputFormatCollection>
<TranslatorCollection>
<Translator TranslatorName="Translator">
         <TranslatorFields>
            <TranslatorField Name="ResourceId" SourceType="table" SourceName="ResourceTable"/>
            <TranslatorField Name="EventTypeId" SourceType="lookup" SourceName="EventTable" LookupValue="PerformanceEvent"/>
            <TranslatorField Name="Timestamp" SourceType="field" SourceName="timestamp"/>
            <TranslatorField Name="Value" SourceType="field" SourceName="memory_util"/>
            <TranslatorField Name="Value" SourceType="field" SourceName="cpu_util"/>
         </TranslatorFields>
      </Translator>
   </TranslatorCollection>
   <TranslationTableCollection LoadingMode="remote">
      <TranslationTable Name="ResourceTable" DestinationType="resource">
         <TranslationField>resource</TranslationField>
      </TranslationTable>
      <TranslationTable Name="EventTable" DestinationType="event_type">
         <TranslationField>resource</TranslationField>
      </TranslationTable>
   </TranslationTableCollection>
</AdapterConfiguration>