Guía de implementación › Implementación › Recolección de datos (experto en el origen de datos) › Cómo configurar adaptadores y traducciones › Caso práctico de adaptador de archivos › Sección TranslatorCollection del archivo de configuración

Sección TranslatorCollection del archivo de configuración

La sección TranslatorCollection define cómo se traducirán a eventos de CA Business Service Insight los registros de orígenes de datos analizados y manipulados que se han extraído en las secciones anteriores.

Esta sección también define cómo gestionar los eventos duplicados y cómo utilizar el mecanismo de singularidad de eventos (para ver más información, consulte Singularidad del evento).

Cuando el modo de interfaz se ha establecido como en línea ("online"), el evento de CA Business Service Insight tiene una estructura unificada que contiene los campos siguientes:

• Timestamp: hora en la que se produjo el evento.
• ResourceId: ID de recurso asociado al evento (el recurso que se midió dentro de ese evento).
• EventTypeId: el tipo de evento asociado al evento. Describe el tipo de evento (tipo de medición del recurso, tipo de acción de ticket, etc.).
• DataSourceId (opcional): cualquier valor. Proporciona criterios de filtrado adicionales para eventos de datos sin procesar.
• Value (varios): valores del evento (resultado de medición, número de ticket, etc.). Este campo a menudo aparece más de una vez.

La estructura del traductor se corresponde con la estructura del tipo de evento dentro de CA Business Service Insight, y también con la tabla de base de datos T_RAW_DATA que almacena el evento, tal y como muestra la ilustración siguiente:

• Translator: describe cómo traducir el conjunto de campos recibidos en el evento de salida.
• TranslatorName: nombre utilizado por InputFormat para enviar conjuntos de campos a este traductor. Este ejemplo utiliza el nombre "Translator1". Consulte la ilustración anterior para ver los valores que se podrían utilizar para este escenario.
• TranslatorFields: contiene una lista de elementos TranslatorField, cada uno de los cuales contiene los atributos siguientes:
  • Name: nombre del campo. En la interfaz en línea debe ser Timestamp, ResourceId, EventTypeId, ResourceId o Value.
  • SourceType: especifica el origen del valor del campo. Puede ser uno de estos valores:
    • Field: el valor de este campo se toma del campo en el formato de entrada. El atributo SourceName contiene el nombre del campo InputFormat.
    • Table: el valor del campo se toma de la tabla de traducción. El atributo SourceName contiene el nombre de la tabla de traducción que hace referencia a un nombre que se define en la sección siguiente de TranslationTableCollection. Este tipo se utiliza para los valores que se traducirán a recursos y tipos de eventos en el evento.
    • Lookup: el valor de este campo se toma de la tabla de traducción. El atributo SourceName contiene el nombre de tabla. El valor que se tiene que traducir del atributo LookupValue y no del formato de entrada. Se utiliza habitualmente cuando se requiere un valor constante para realizar traducciones.
    • Constant: el valor del campo es constante, y su valor está en el atributo ConstantValue. Al utilizar un valor constante, es necesario especificar el tipo de campo mediante el atributo Type.
  • SourceName: contiene el nombre del campo o el nombre de la tabla de traducción.
  • LookupValue: contiene el valor de búsqueda cuando SourceType=lookup.
  • ConstantValue: contiene el valor constante cuando SourceType=constant. Cuando el tipo de campo es de tiempo, el valor constante es una cadena con formato según TimeFormat (establecido en la sección General del adaptador) o "Now" o "NowUtc", donde "Now" es la hora en curso en la configuración regional del origen de datos y "NowUtc" es la hora en curso en UTC.

Esta sección también contiene las tablas de asignación que definen la asignación de valores del origen de datos a campos evento de CA Business Service Insight, y guarda la definición de la tabla con el valor del origen de datos al que se hace referencia y debe traducirse.

• LoadingMode: el valor predeterminado para la interfaz en línea es "remote", y para la interfaz sin conexión es "standalone".

  El método de carga de las tablas de traducción se especifica como sigue:

  • Standalone: el adaptador carga las tablas de traducción localmente. No hay conexión al servidor de CA Business Service Insight para la traducción. Los cambios en las tablas de traducción se almacenan solamente en el archivo local.
  • Remote: el adaptador envía una solicitud para cargar todas las tablas desde el servidor de CA Business Service Insight. Los cambios realizados en las tablas de traducción se almacenan también localmente.
• TranslationTable: vincula el valor del evento con la tabla de asignación.
  • Name: nombre de tabla de traducción utilizada a la que hace referencia el traductor.
  • DestinationType: [resource, event_type, contract_party, service, time_zone, value]. Guarda el tipo de la tabla de traducción. En este ejemplo, la columna Servers en el archivo del origen de datos se traduce en un recurso de CA Business Service Insight. Por lo tanto, el tipo de tabla de traducción es un recurso que guarda traducciones de valores para los ID de recurso en CA Business Service Insight.
  • TranslationField: nombre del campo de donde traducir y que se toma de los campos de formato de entrada. Puede contener un máximo de cinco campos.

Cada tabla de traducción definida en el archivo de configuración debe tener una definición correspondiente en la interfaz de usuario de CA Business Service Insight.

La representación XML de un archivo de configuración de muestra es la siguiente:

<?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:\Archivos de programa\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>