Guía de implementación › Especificaciones de configuración del adaptador › Sección TranslatorCollection

Sección TranslatorCollection

La sección TranslatorCollection describe cómo traducir el registro del origen de datos analizado y manipulado extraído en la sección anterior a un evento de CA Business Service Insight.

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: el ID de recurso de CA Business Service Insight asociado al evento (el recurso que se midió, etc.).
• EventTypeId: el tipo de evento de CA Business Service Insight asociado al evento y que describe el tipo de evento (tipo de medición del recurso, tipo de acción de ticket, etc.).
• DataSourceId: (opcional). El nombre del origen de datos de entrada (nombre de archivo / nombre de tabla...).
• Value: el valor del evento (resultado de medida, número de ticket, etc.). Este campo puede aparecer más que una vez.

Cuando el modo de interfaz es "offline", no hay limitaciones en el número de los campos o en su nombre.

Estructura XML:

<TranslatorCollection>
   <Translator TranslatorName="events" OnDuplication = "ignore">
	<TranslatorFields>
		<TranslatorField Name="ResourceId" SourceType="table"
		    SourceName="ResourcesTranslateTable" Iskey="yes"/>
		<TranslatorField Name="EventTypeId"	SourceType="constant"
		    ConstantValue="1002" Iskey="yes"/>
		<TranslatorField Name="Timestamp"  	SourceType="field"
                SourceName="timestamp" Iskey="yes"/>
		<TranslatorField Name="Value" 	SourceType="table"
                SourceName="valueUpDownTranslateTable" Iskey="yes"/>
		< TranslatorField Name="Value"  SourceType ="field"
                SourceName ="nodeName" Iskey="yes"/>
		< TranslatorField Name="Value"  SourceType ="constant"
                Type="integer" ConstantValue="1000" Iskey="yes"/>
		< TranslatorField Name="Value"  SourceType ="field"
                SourceName ="timestamp" TimeShift="-3600"
                TimeShiftFieldName="createDate"	Iskey="yes"/>
		< TranslatorField Name="Value"  SourceType ="lookup"
                SourceName ="ServiceTable" LookupValue="word"
                Iskey="yes"/>
      </TranslatorFields>
   </Translator>
</TranslatorCollection>

• 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.
  • OnDuplication: miembro que guarda el valor "ignore", "add", "update" o "updateAlways" para determinar lo que hacer con el evento de duplicación (consulte Singularidad del evento).
  • 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,Value o DataSourceId.
  • SourceType:

    field: el valor de este campo se toma del campo en el formato de entrada. El atributo SourceName contiene el nombre del campo.

    table: el valor del campo se toma de la tabla de traducción. El atributo SourceName contiene el nombre de tabla.

    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 se toma del atributo LookupValue y no del formato de entrada.

    constant: el valor del campo es constante, y su valor está en el atributo ConstantValue.

  • SourceName: contiene el nombre del campo o el nombre de la tabla de traducción.
  • Type: [integer/real/string/time]. Necesario solamente cuando el tipo del campo no se ha definido previamente (por nombre de campo o por tipo de origen). En la interfaz en línea se requiere solamente para el campo Value con SourceType=constant. En la interfaz sin conexión se requiere para cada campo con SourceType=constant.
  • IsKey: representa la clave única del evento. Esta clave se construye a partir de los campos marcados como TranslatorFields?IsKey = "yes".

    (Consulte Singularidad del evento).

  • 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 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.
  • TimeFormat: contiene el formato de hora, necesario solamente para campos con SourceType=constant y Type=time.
  • TimeShift: define la variación de tiempo en segundos, solamente para campos de hora.
  • TimeShiftFieldName: (opcional). Contiene el nombre del campo, del formato de entrada, que contiene la variación de la hora en segundos. Los atributos TimeShift y TimeShiftFieldName pueden ir juntos.