Crear una Fuente de Archivo Local¶

Introducción¶

Se puede utilizar un archivo local en un Agente Privado como fuente en Jitterbit. Debe residir en la máquina donde está instalado el Agente Privado y no se puede utilizar con Agentes en Nube. (Consulte Fuente de almacenamiento temporal para un enfoque aplicable a los Agentes en Nube.)

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

Requisito Previo¶

Antes de poder utilizar una fuente de archivo local, debe haber habilitado la ubicación de archivo local en su Agente Privado Jitterbit. Consulte Habilitación de la ubicación del archivo local para detalles.

Crear una Fuente de Archivo Local¶

Puede optar por crear una nueva fuente de archivo local por sí sola o dentro de una operación existente. Para obtener más información sobre cómo funcionan las fuentes dentro de las operaciones, consulte Creación de una operación.

Crear una Nueva Fuente de Archivo Local Como Fuente Independiente¶

Dentro de su proyecto en Jitterbit Design Studio, crea una nueva fuente de archivo local mediante cualquiera de:

• Vaya a Archivo > Nuevo > Nueva fuente; o

• En el árbol de la izquierda, haga clic derecho en Fuentes y seleccione Nueva fuente; o

• En la barra de herramientas superior, haga clic en el icono de fuente verde .

En la ventana emergente, seleccione Local Archivo como tipo:

Su nueva fuente aparece en su propia pestaña Nueva fuente en el panel derecho de la ventana.

Crear una Nueva Fuente de Archivo Local en una Operación Existente¶

Normalmente se crea una fuente de forma predeterminada cuando se crea una nueva operación. (La excepción es una operación que consta únicamente de un secuencia de comandos). Con una operación existente, puede especificar el tipo de su fuente de la siguiente manera:

• Hacer doble clic en el icono de fuente; en la ventana emergente, seleccione Crear nueva fuente; o

• Hacer clic derecho en el icono de la fuente y seleccionar Crear nueva fuente.

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

Utilice un Origen de Archivo Local Existente en una Operación Existente¶

Para utilizar una fuente de archivo local existente en una operación existente con una fuente, puede configurarla mediante cualquiera de:

• Dentro de la operación, haga doble clic en el icono de la fuente y, en la ventana emergente resultante, seleccione la fuente del Archivo local deseada de la lista; o

• Dentro de la operación, haga clic derecho en el ícono de fuente, elija Seleccionar fuente existente y, en la ventana emergente resultante, seleccione la fuente de archivo local deseada de la lista; o

• Arrastrando la fuente del archivo local deseada desde el árbol de la izquierda y soltándola en el icono de fuente existente de la operación.

Configurar una Fuente de Archivo Local¶

Después de haber creado una fuente de archivo local, se abrirá la pantalla de configuración en la vista principal de Design Studio. Puede volver a la pantalla de configuración en cualquier momento haciendo doble clic en el icono de la fuente en la operación, o haciendo doble clic en la fuente en el árbol de la izquierda.

Configuracion Basica¶

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

• Nombre: Introduzca un nombre único y apropiado para la fuente.
• Tipo: Utilice el menú desplegable para seleccionar Archivo local, si aún no está especificado.

• Parámetros de conexión: Especifique los detalles de su conexión de archivo local:

  • Examinar: El botón Examinar, si está habilitado, se puede utilizar para ingresar rápidamente la ruta de la carpeta. Solo se puede utilizar si Jitterbit Agente está instalado localmente en la misma máquina en la que se ejecuta Design Studio. Si esta opción está deshabilitada, es posible que necesite habilitar los archivos locales como se describe en Habilitación de la ubicación del archivo local. Si selecciona una carpeta o un archivo usando Examinar, los campos Carpetas (y posiblemente Obtener archivos) se completarán automáticamente.

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

    • La ruta no puede contener ninguno de estos caracteres: \~ % $ ? " \< >:
    • Los separadores de ruta ('/'o '\') utilizado debe ser apropiado 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 de los archivos de origen que desea leer dentro del directorio especificado en Carpetas. Este campo también puede incluir un asterisco. * para utilizar como comodín (por ejemplo, *.txt o *.*) o un signo de interrogación ? para que coincida exactamente con un carácter (por ejemplo, file?.txt). También se pueden utilizar variables en este campo. Si especifica un archivo comprimido (ZIP), consulte la sección "Compresión" de los parámetros de conexión adicionales en Opciones abajo. El archivo comprimido se puede descomprimir y leer automáticamente. (Requerido.)

  • Opciones de filtro: Permite especificar si se deben ignorar las mayúsculas y minúsculas del nombre de archivo o si la información de Obtener archivos debe tratarse como una expresión regular.

• Probar conexión: Al hacer clic en probará la fuente del archivo local. Verificará que se pueda establecer una conexión a la carpeta especificada y devolverá una lista de los archivos encontrados; fallará si la ruta no es una ruta válida que encuentre archivos en el sistema operativo donde se ejecuta Jitterbit Agente. Si recibe un error, asegúrese de haber habilitado los archivos locales como se describe en Habilitación de la ubicación del archivo local.

• 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 los archivos de origen. 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 las carpetas de éxito y/o error se utilizarán para archivar una copia de todos los archivos procesados.

  • Si se especifica una carpeta correcta, al procesar correctamente la fuente, se escribirá una copia del archivo en un archivo de esa carpeta.
  • El archivo tendrá el mismo nombre que el especificado en el campo Obtener archivos anterior, pero con un guión bajo al final y una marca de tiempo agregada. Si ya existe un archivo con el mismo nombre en esa carpeta, se agregará un guión bajo adicional y un contador.
  • Por ejemplo, si un archivo llamado data.csv se procesa exitosamente, una copia llamada data.csv_2018-01-01_12-00-00-000 podría escribirse en la carpeta especificada como Carpeta de éxito. Si dicho archivo ya existe de una ejecución anterior, se creará un nuevo archivo. data.csv_2018-01-01_12-00-00-000_1 se agregaría.
  • De manera similar, si se especifica una carpeta de errores, cualquier archivo que falle se escribirá en un archivo en la Carpeta de errores.

• Archivo de activación: Utilícelo para especificar un archivo de activación para iniciar el procesamiento de los archivos de origen. El archivo desencadenante se elimina cuando comienza el procesamiento.

  • Después de seleccionar la casilla de verificación Usar activador, especifique una Ruta de archivo absoluta para un archivo cuya presencia activará el procesamiento.
  • En este campo se pueden utilizar variables (aunque no comodines).
  • Dado que el archivo desencadenante se elimina cuando comienza el procesamiento, el archivo desencadenante no puede ser el mismo archivo que el archivo fuente que se está procesando.
  • Una vez que comienza la operación, la operación sondeará y buscará el archivo desencadenante. El intervalo de tiempo de sondeo se fija en un segundo.
  • El archivo desencadenante se elimina cuando comienza el procesamiento.
  • Si no se encuentra el archivo desencadenante, la operación seguirá intentando encontrar el archivo desencadenante hasta que expire el tiempo de espera de la operación.
  • La configuración de un archivo desencadenante bloquea cualquier operación o secuencia de comandos que utilice el código fuente hasta que se cumpla la condición del archivo desencadenante o se agote el tiempo de espera de la operación.

• Después de procesar:

  • Si se selecciona la casilla de verificación Eliminar archivo, los archivos de origen se eliminarán una vez procesados.
  • Si se especifica un valor en el campo Cambiar nombre de archivo, se cambiará el nombre del archivo utilizando el patrón proporcionado. Se pueden utilizar variables en este campo.
  • Sólo se acepta uno de eliminar o cambiar el nombre; Si la casilla de verificación Eliminar archivo está marcada, Cambiar nombre de archivo se desactivará y se ignorará. Si Cambiar nombre de archivo está vacío, se ignorará. Si se deja como predeterminado, no se realizará ningún procesamiento posterior de los archivos fuente.

• Ignorar líneas: Los números indicados de la primera y última línea se ignoran para cada archivo. Si hay encabezados o pies de página que deben ignorarse, ingrese el número de líneas en los campos Primero y Último según corresponda.

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