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

Sección DataSourceInterface

La sección DataSourceInterface está formada por atributos que especifican la conexión y el tipo de conexión entre el adaptador y el origen de datos (herramienta de medida, CRM, registro del sistema, etc.) y está dividido en dos tipos principales: interfaz de archivo e interfaz SQL.

Interfaz de archivo

El adaptador de archivos se puede usar para recuperar datos de archivos de registro, informes programados o cualquier otro texto basado en archivos, y DataSourceInterface define las reglas para analizar la información del origen de datos del archivo y extraerla en campos.

La sección DataSourceInterface también define cómo gestiona el adaptador el archivo de origen (si suprime el archivo original si sólo lo creó el adaptador o si deja los datos por si hacen falta para otros usos, etc.).

Estructura XML:

<DataSourceInterface WorkFileName="MyWorkingFile.txt" >
   <Files>
	<File
            IsActive="yes"	
		InputFormat="events"
		Path="D:\adapters\sample_data\"
		NamePattern="adapterXXX*.log"
		DeleteFileAfterProcessing="no"
		Delimiters=","
		IgnoreRedundantDelimiters ="no"
		TitleExists="no"
		SleepTime="10">
	</File>	
   </Files>
</DataSourceInterface>

• WorkFileName: (opcional). Cuando se fija DeleteFileAfterProcessing como "no", el archivo se copia a este nombre; cuando se establece como "yes", se cambia el nombre del archivo a este nombre. Si no se especifica, se tomará el valor predeterminado ('WorkFile.txt').
  • Files: recopilación de los elementos de archivo (se puede definir más de un archivo en un adaptador).
  • File: especifica los atributos de archivo.
    • IsActive: (opcional) [yes/no]. Define si este archivo está activo (cuando se establece como "no" este archivo no se leerá).
    • InputFormat: el InputFormat asociado con este archivo. El adaptador utiliza el valor de InputFormat para extraer los datos del origen de datos.
    • Path: la ruta de la ubicación de los archivos de datos de origen.
    • NamePattern: especifica el nombre de archivo del origen de datos. Se pueden utilizar caracteres comodín si más de un archivo utiliza el mismo formato de entrada.
    • DeleteFileAfterProcessing [yes|no]: la forma en la que el adaptador maneja el archivo de origen. Cuando el archivo se creó sólo para el adaptador y pueda suprimirse después del procesamiento, hay que establecerlo como "yes". Se cambia el nombre al archivo, se procesa y, a continuación, se suprime. Cuando se establece como "no" el archivo se copia y el procesamiento tiene lugar en el archivo copiado. Si se añaden nuevos registros al final de este archivo, el adaptador copia estos nuevos registros al archivo de trabajo durante el ciclo siguiente. Si no se añaden registros nuevos al archivo, el adaptador busca el primer archivo con el mismo patrón y nombre (en orden lexicográfico) que el archivo actual. Si el adaptador encuentra dicho archivo, empieza a funcionar con este. El adaptador no vuelve al archivo anterior, ni siquiera si se añaden nuevos registros a este archivo. Defínalo en "no" cuando sea necesario mantener la integridad del archivo de origen.
    • InitialFileName: el primer nombre de archivo desde el que el adaptador empezará a buscar el archivo con el patrón determinado. Utilice este atributo cuando el campo NamePattern contiene caracteres comodín y no desea que el adaptador lea archivos antiguos.
• Delimiters: (opcional). Uno o más caracteres que sirven de delimitadores, según los cuales las filas datos sin procesar se analizarán en campos; si no se especifica, el valor predeterminado es "\t".
• IgnoreRedundantDelimiters: (opcional) [yes/no]. Cuando se establece como "yes" los delimitadores consecutivos se tratarán como uno, y se creará un campo vacío entre los delimitadores.
• RegExForParser: (opcional). Una expresión regular que se utiliza para extraer campos del origen de datos que sustituye a los valores de Delimiters especificados anteriormente. Por ejemplo:

  <File
      ….
      RegExForParser="^(.{8}) (.{6}) (?:[ ])*([0-9]+) "
  />
  

  Consulte la documentación de las expresiones regulares para obtener más información.

• TitleExists: (opcional) [yes/no] especifica si la primera línea del archivo de origen de datos que no esté en blanco es una línea de título. El adaptador puede utilizar el título al analizar los datos.
• SleepTime: especifique el intervalo de datos de recuperación (en segundos); es decir, el número del intervalo en segundos entre la extracción de datos del adaptador desde el archivo de datos de origen.
• LogicLineDefinition: (opcional)

  <File
      ….
      <LogicLineDefinition
                      FirstLine="Job server:.*"
                      NumberOfLines="5"
      />
  />
  

  Si el conjunto de datos se construye a partir del número de líneas y no por una línea, los atributos siguientes definen el punto de partida y punto final de la extracción y el número de líneas que componen los datos:

  • AllFile: (opcional) [yes/no]. Cuando se establece como "yes" todo el archivo se considera como un registro, una línea lógica.
  • FirstLine: (opcional). Expresión regular que define la primera línea de la línea lógica. Puede especificarse con o sin LastLine o NumberOfLines.
  • LastLine: (opcional). Expresión regular que define la última línea de la línea lógica. Se puede especificar con o sin FirstLine o NumberOfLines.
  • NumberOfLines: (opcional). Número de líneas en una línea lógica. Se puede especificar con o sin FirstLine o LastLine.
  • MatchCase: (opcional) [yes/no]. Define si la expresión regular distingue entre mayúsculas y minúsculas.