Crear una fuente de archivo local en Jitterbit Design Studio

Introducción

Un archivo local en un agente privado puede ser utilizado como fuente en Jitterbit. Debe residir en la máquina donde está instalado el agente privado y no puede ser utilizado con agentes en la nube. (Consulta Fuente de Almacenamiento Temporal para un enfoque aplicable a agentes en la nube.)

Se puede utilizar cualquier tipo de archivo. Los tipos comúnmente utilizados para archivos locales son texto (.txt), CSV (.csv), XML (.xml) y JSON (.json).

Requisitos previos

Antes de poder usar una fuente de Archivo Local, debes haber habilitado la Ubicación de Archivo Local en tu agente privado de Jitterbit. Consulta Habilitar ubicación de archivo local para más detalles.

Crear una fuente de archivo local

Puedes optar por crear una nueva fuente de Archivo Local por su cuenta, o dentro de una operación existente. Para más información sobre cómo funcionan las fuentes dentro de las operaciones, consulta Crear una operación.

Crear una nueva fuente de archivo local como fuente independiente

Dentro de tu proyecto en Jitterbit Design Studio, puedes crear una nueva fuente de Archivo Local de cualquiera de las siguientes maneras:

• Ve a Archivo > Nuevo > Nueva Fuente; o

• En el árbol a la izquierda, haz clic derecho en Fuentes y selecciona Nueva Fuente; o

• En la barra de herramientas superior, haz clic en el ícono de fuente verde .

En el popup, selecciona Archivo Local como el tipo:

Tu nueva fuente aparecerá en su propia pestaña de Nueva Fuente en el panel derecho de la ventana.

Crear una nueva fuente de archivo local en una operación existente

Una fuente se crea generalmente por defecto cuando se crea una nueva operación. (La excepción es una operación que consiste solo en un script.) Con una operación existente, se puede especificar el tipo de su fuente de la siguiente manera:

• Haciendo doble clic en el ícono de la fuente; en el popup, seleccionar Crear Nueva Fuente; o

• Haciendo clic derecho en el ícono de la fuente y seleccionando Crear Nueva Fuente.

En la pantalla de configuración que aparece, utiliza el menú desplegable Tipo para seleccionar Archivo Local, como se muestra arriba.

Usar una fuente de archivo local existente en una operación existente

Para usar una fuente de Archivo Local existente en una operación existente con una fuente, se puede establecer de cualquiera de las siguientes maneras:

• Dentro de la operación, haciendo doble clic en el ícono de la fuente, y en el popup resultante, seleccionando la fuente de Archivo Local deseada de la lista; o

• Dentro de la operación, haciendo clic derecho en el ícono de la fuente, eligiendo Seleccionar Fuente Existente, y en el popup resultante, seleccionando la fuente de Archivo Local deseada de la lista; o

• Arrastrando la fuente de Archivo Local deseada desde el árbol a la izquierda y soltándola sobre el ícono de fuente existente de la operación.

Configurar una fuente de archivo local

Después de haber creado una fuente de Archivo Local, la pantalla de configuración se abrirá en la vista principal de Design Studio. Puedes regresar a la pantalla de configuración en cualquier momento haciendo doble clic en el ícono de la fuente en la operación, o haciendo doble clic en la fuente en el árbol a la izquierda.

Configuración básica

La pantalla de configuración aparecerá similar a este ejemplo:

• Nombre: Ingresa un nombre apropiado y único para la fuente.
• Tipo: Utiliza el menú desplegable para seleccionar Archivo Local, si no está especificado ya.

• Parámetros de Conexión: Especifica los detalles para tu conexión de Archivo Local:

  • Explorar: El botón Explorar, si está habilitado, se puede usar para ingresar rápidamente la ruta de la carpeta. Solo se puede usar si el agente de Jitterbit está instalado localmente en la misma máquina donde se está ejecutando Design Studio. Si esta opción está deshabilitada, es posible que necesite habilitar archivos locales como se describe en Habilitar ubicación de archivos locales. Si selecciona una carpeta o archivo usando Explorar, los campos Carpeta(s) (y posiblemente Obtener Archivos) se completarán automáticamente.

  • Carpeta(s): Ingrese una ruta local en la máquina donde está instalado el agente de Jitterbit que apunte a la carpeta donde residen los archivos deseados.

    • La ruta no puede contener ninguno de estos caracteres: \~ % $ ? " \< > :
    • Los separadores de ruta ('/'o '\') utilizados deben ser apropiados para el sistema operativo de la máquina donde está instalado el agente privado.
    • Solo se puede especificar una ruta.

  • Obtener Archivos: Ingrese el nombre del(los) archivo(s) fuente que desea leer dentro del directorio especificado en Carpeta(s). Este campo también puede incluir un asterisco * para usar como comodín (por ejemplo, *.txt o *.*) o un signo de interrogación ? para coincidir exactamente con un carácter (por ejemplo, archivo?.txt). También se pueden usar variables en este campo. Si se especifica un archivo comprimido (ZIP), consulte la sección "Compresión" de los parámetros de conexión adicionales en Opciones a continuación. El archivo comprimido puede descomprimirse y leerse automáticamente. (Requerido.)

  • Opciones de Filtro: Permite especificar si se debe ignorar el caso del nombre del archivo o si la información de Obtener Archivos debe tratarse como una expresión regular.

• Probar Conexión: Hacer clic en el botón probará la fuente de Archivo Local. Verificará que se pueda establecer una conexión con la carpeta especificada y devolverá una lista de archivos que se encuentren; fallará si la ruta no es una ruta válida que encuentre archivos en el sistema operativo donde se está ejecutando el agente de Jitterbit. Si recibe un error, asegúrese de haber habilitado archivos locales como se describe en Habilitar ubicación de archivos locales.

• Haga clic en el botón Guardar en la barra de herramientas principal o en la barra de herramientas de la fuente para guardar la configuración.

Opciones

Se pueden especificar parámetros de conexión adicionales haciendo clic en Opciones en la parte inferior de la sección Parámetros de Conexión:

• Codificación de Caracteres: Se utiliza para especificar una codificación de caracteres para el(los) archivo(s) fuente. Si se deja en blanco, Jitterbit intentará detectar la codificación. Para especificar una codificación diferente a la predeterminada, inserte una de las codificaciones admitidas descritas en Codificación de caracteres.

• Carpeta de Éxito/Error: Utilice esta sección para especificar si se utilizarán carpetas de éxito y/o error para archivar una copia de todos los archivos procesados.

  • Si se especifica una carpeta de éxito, al procesar exitosamente la fuente, se escribirá una copia del archivo en un archivo en esa carpeta.
  • El archivo tendrá el mismo nombre que el especificado en el campo Obtener Archivos anterior, pero con un guion bajo al final y una marca de tiempo añadida. Si ya hay un archivo con el mismo nombre en esa carpeta, se añadirá un guion bajo adicional y un contador.
  • Por ejemplo, si un archivo llamado data.csv se procesa exitosamente, se podría escribir una copia llamada data.csv_2018-01-01_12-00-00-000 en la carpeta especificada como Carpeta de Éxito. Si tal archivo ya existe de una ejecución anterior, se añadiría un nuevo archivo data.csv_2018-01-01_12-00-00-000_1.
  • De manera similar, si se especifica una carpeta de error, cualquier archivo que falle se escribirá en un archivo en la Carpeta de Error.

• Archivo de Disparo: Utilice esto para especificar un archivo de disparo para iniciar el procesamiento del(los) archivo(s) fuente. El archivo de disparo se elimina cuando comienza el procesamiento.

  • Después de seleccionar la casilla Usar Disparo, especifique una Ruta de archivo absoluta a un archivo cuya presencia activará el procesamiento.
  • Se pueden usar variables (aunque no comodines) en este campo.
  • Dado que el archivo de disparo se elimina al comenzar el procesamiento, el archivo de disparo no puede ser el mismo archivo que un archivo fuente que se esté procesando.
  • Una vez que comienza la operación, esta sondeará, buscando el archivo de disparo. El intervalo de tiempo de sondeo está fijado en un segundo.
  • El archivo de disparo se elimina al comenzar el procesamiento.
  • Si no se encuentra el archivo de disparo, la operación seguirá intentando encontrar el archivo de disparo hasta que la operación se agote.
  • Establecer un archivo de disparo bloquea cualquier operación o script que utilice la fuente hasta que se satisfaga la condición del archivo de disparo o hasta que la operación se agote.

• Después del procesamiento:

  • Si la casilla Eliminar archivo está seleccionada, el(los) archivo(s) fuente serán eliminados después de haber sido procesados.
  • Si se especifica un valor en el campo Renombrar archivo, el archivo será renombrado utilizando el patrón suministrado. Se pueden usar variables en este campo.
  • Solo se acepta una de las opciones de eliminar o renombrar; si la casilla Eliminar archivo está marcada, Renombrar archivo estará deshabilitada e ignorada. Si Renombrar archivo está vacío, será ignorado. Si se deja como predeterminado, no se llevará a cabo ningún procesamiento posterior de los archivos fuente.

• Ignorar líneas: Los números indicados de las primeras y últimas líneas se ignoran para cada archivo. Si hay encabezados o pies de página que se deben ignorar, ingrese el número de líneas en los campos Primera y Última según corresponda.

  Nota

  Esta configuración no tiene efecto cuando se hace referencia a un archivo local desde un script utilizando las funciones ReadFile o WriteFile.

• Compresión: Si la casilla para Los datos fuente están comprimidos está seleccionada, los archivos fuente serán descomprimidos utilizando el formato ZIP. Se puede especificar una Contraseña (para archivos comprimidos encriptados). Solo se admite la lectura desde el directorio raíz del archivo comprimido.