Actividad de lectura FTP

Introducción

Una actividad de Lectura FTP, utilizando su conexión FTP, lee datos de un punto final FTP y está destinada a ser utilizada como una fuente para proporcionar datos a una operación o para ser llamada en un script.

Crear una actividad de lectura FTP

Se crea una instancia de una actividad de Lectura FTP a partir de una conexión FTP utilizando su tipo de actividad Lectura.

Para crear una instancia de una actividad, arrastre el tipo de actividad al lienzo de diseño o copie el tipo de actividad y péguelo en el lienzo de diseño. Para más detalles, consulte Crear una instancia de actividad o herramienta en Reutilización de componentes.

Una actividad de Lectura FTP existente se puede editar desde estas ubicaciones:

• El lienzo de diseño (consulte Menú de acciones de componentes en Lienzo de diseño).

• La pestaña Componentes del panel del proyecto (consulte Menú de acciones de componentes en Pestaña de componentes del panel del proyecto).

Configurar una actividad de lectura FTP

Siga estos pasos para configurar una actividad de Lectura FTP:

• Paso 1: Ingrese un nombre, proporcione un esquema de respuesta y especifique configuraciones

• Paso 2: Revise los esquemas de datos

Paso 1: Ingrese un nombre, proporcione un esquema de respuesta y especifique configuraciones

• Nombre: Ingrese un nombre para identificar la actividad de lectura FTP. El nombre debe ser único para cada actividad de lectura FTP y no debe contener barras diagonales (/) ni dos puntos (:).

• Proporcionar esquema de respuesta: El esquema de respuesta define la estructura de los datos que utiliza la actividad de lectura FTP. Si se requiere un esquema de respuesta depende de si la actividad se utiliza como fuente de una transformación (consulte Uso de esquemas). Para instrucciones sobre cómo completar esta sección de la configuración de la actividad, consulte Esquemas definidos en una actividad.

• Ruta: Ingrese una única ruta válida. Una ruta debe apuntar a un directorio existente en el servidor FTP. Por ejemplo, /inbound.

  Advertencia

  Las variables globales con valores predeterminados no se sustituyen en este campo con agentes de la versión 11.38 y anteriores.

• Obtener archivos: Ingrese el nombre del(los) archivo(s) que desea leer dentro de la ruta ingresada arriba. Este campo también puede incluir un asterisco (*) para usar como comodín (por ejemplo, *.dat o *.*) o un signo de interrogación (?) para coincidir exactamente con un carácter (por ejemplo, file?.txt). El uso de comodines es independiente de la opción Usar expresión regular descrita a continuación. Si se especifican datos en formato ZIP para ser descomprimidos y leídos automáticamente, consulte las opciones de Compresión descritas a continuación.

  Consejo

  Si le faltan archivos conocidos o si los nombres de los archivos tienen información adicional adjunta después de recuperarlos del punto final, establezca Jitterbit.source.FTP.enable_regex_parser en true antes de una actividad de lectura FTP.

• Configuraciones opcionales: Haga clic para expandir configuraciones opcionales adicionales.

  • Opciones de filtro de archivos: Estas opciones afectan cómo se interpreta la entrada ingresada en el campo Obtener archivos arriba:

    • Ignorar mayúsculas: Selecciona esta casilla si has ingresado información en el campo Obtener archivos arriba que debe interpretarse como insensible a mayúsculas.

    • Usar expresión regular: Selecciona esta casilla si has ingresado información en el campo Obtener archivos arriba que debe interpretarse como una expresión regular. Esta opción es independiente del uso de comodines descrito en Obtener archivos arriba.

  • Listar solo nombres de archivos: Marca esta casilla si deseas listar solo los nombres de archivos (usando el comando FTP NLST en lugar de LIST). Prueba esto si Harmony no puede analizar la lista de directorios FTP enviada por el servidor FTP.

    Consejo

    Si te faltan archivos conocidos o si los nombres de los archivos tienen información adicional adjunta después de recuperarlos del punto final, establece Jitterbit.source.FTP.enable_regex_parser en true antes de una actividad de lectura FTP.

  • Codificación de caracteres: Especifica la codificación de caracteres para definir una codificación de caracteres específica para el archivo fuente. Si dejas el campo en blanco, Harmony intenta detectar la codificación. Si deseas sobrescribir la predeterminada, puedes elegir entre cualquiera de los tipos de codificación listados en Codificaciones de caracteres soportadas.

  • Carpeta de Éxito/Error: Estas opciones se utilizan para archivar una copia de todos los archivos procesados. Esto se puede usar en lugar de la opción Después del procesamiento para Renombrar archivo en la fuente de archivos para permitirte escribir en una ubicación separada en lugar de en una subcarpeta en la misma ubicación.

    • Usar carpeta de éxito: Selecciona esta casilla para escribir un archivo en la carpeta especificada después del procesamiento exitoso en la ruta de destino principal. Si se escribe un archivo en múltiples rutas, la operación es exitosa solo si todas las rutas son exitosas. Si esta casilla está seleccionada, también proporciona la Carpeta de Éxito en Ruta Absoluta en la máquina del agente privado.

    • Usar carpeta de error: Selecciona esta casilla para escribir un archivo en la carpeta especificada después de un procesamiento no exitoso. Si al menos una ruta no es exitosa, entonces el archivo se escribe en esta carpeta. Si esta casilla está seleccionada, también proporciona la Carpeta de Error en Ruta Absoluta en la máquina del agente privado.

      Precaución

      Un archivo se escribe solo si la falla se debe a errores en el procesamiento de la actividad de lectura FTP. No se escribe un archivo si, por ejemplo, la conexión FTP no es exitosa, lo que provoca que toda la operación falle.

    Importante

    Las rutas absolutas para las carpetas de éxito y error se encuentran en el agente privado, no en el servidor FTP.

    Al usar palabras clave de nombre de archivo en estos campos, las palabras clave no se resuelven. Para una solución alternativa, consulte Limitación y solución alternativa bajo Palabras clave de nombre de archivo. Usar asteriscos (*) y otros caracteres de nombre de archivo típicamente no soportados causará que la operación falle.

    Los archivos se nombran como se especifica en el campo Obtener archivos anterior, 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ñade un guion bajo adicional y un contador.

    Por ejemplo, si un archivo llamado data.csv se procesa con éxito, se podría escribir una copia llamada data.csv_2018-01-01_12-00-00-000 en la carpeta especificada como la 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 escribe en un archivo en la carpeta de error.

  • Después del procesamiento: Si desea realizar acciones adicionales después de procesar los datos, estas opciones están disponibles:

    • Eliminar archivo: Seleccione esta casilla si desea que los archivos que han sido procesados con éxito se eliminen. Cuando se selecciona esta opción, la opción Renombrar archivo a continuación se completa automáticamente con /\delete/\ para indicar que los archivos procesados serán eliminados y, por lo tanto, renombrar un archivo no aplica. Desmarcar Eliminar archivo también borra el campo Renombrar archivo.

    • Renombrar archivo: Ingrese un nombre si desea renombrar archivos después del procesamiento. Cualquiera de las palabras clave de nombre de archivo está disponible para generar nombres de archivo únicos para los datos de origen después del procesamiento. Tenga en cuenta que el campo Renombrar archivo no está disponible si se selecciona Eliminar archivo arriba. Además, alternar Eliminar archivo arriba borra cualquier entrada ingresada en el campo Renombrar archivo.

      Consejo

      Si deseas archivar la fuente del archivo en una ubicación separada en un agente privado, también consulta la opción Carpeta de Éxito/Error en la configuración de la actividad de escritura FTP.

  • Archivo de Disparo: Disponible solo para su uso con agentes privados donde se habilitan archivos locales, un archivo de disparo es un archivo que debe estar presente antes de que un archivo fuente sea recuperado por una operación para su procesamiento. La presencia de un archivo de disparo indica que un archivo fuente está listo para ser leído y no está aún en proceso de ser escrito por una operación anterior.

    • Usar Disparo: Selecciona esta casilla si deseas que el sistema busque un archivo de disparo antes de procesar archivos fuente. Nota, al usar un archivo de disparo:

      • La operación sondea, 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 sigue 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 use la fuente hasta que se satisfaga la condición del archivo de disparo o la operación se agote.

    • Ruta de archivo absoluta: Ingresa la ruta de archivo absoluta en la máquina del agente privado donde reside el archivo de disparo. Selecciona un archivo que cumpla con estos criterios:

      • El archivo puede ser de cualquier tipo y puede contener cualquier cosa como su contenido; solo la presencia del archivo define el comportamiento del archivo de disparo.

      • No se permite el uso de comodines.

      • El archivo de disparo no puede ser el mismo archivo que un archivo fuente que se esté procesando.

      Nota

      Al usar palabras clave de nombre de archivo en este campo, las palabras clave no se resuelven. Para una solución alternativa, consulta Limitación y solución alternativa bajo Palabras clave de nombre de archivo.

  • Ignorar Líneas: Si hay encabezados y/o pies de página en los datos de origen, ingresa el número de líneas a ignorar en los campos Primero y Último.

    Nota

    Esta configuración no tiene efecto cuando una actividad de Lectura FTP es referenciada desde un script utilizando las funciones ReadFile o WriteFile.

  • Compresión: Si los datos de origen están en un formato comprimido, selecciona Los datos de origen están comprimidos. Estas opciones estarán disponibles:

    • Formato: Usa el menú desplegable para seleccionar el formato de los datos comprimidos. Actualmente, solo se admite el formato ZIP.

    • Contraseña: Si el archivo está encriptado, ingresa la contraseña.

      Nota

      Harmony solo admite la lectura desde el directorio raíz de un archivo comprimido encriptado.

  • Tipo de Transferencia: Si los archivos son basados en ASCII, elige el tipo de transferencia ASCII. Para todos los demás tipos de archivos, elige Binario. Binario es el predeterminado y generalmente funciona mejor.

• Guardar y Salir: Si está habilitado, haz clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

• Siguiente: Haz clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. La configuración no se guardará hasta que hagas clic en el botón Terminado en el último paso.

• Descartar Cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pedirá que confirmes que deseas descartar los cambios.

Paso 2: Revisar los esquemas de datos

• Esquema de Datos: Si se proporciona durante la configuración de la actividad, se muestra el esquema de datos de respuesta. Si la operación utiliza una transformación, los esquemas de datos se mostrarán nuevamente más adelante durante el proceso de mapeo de transformación, donde puedes mapear a campos de destino utilizando objetos de origen, scripts, variables, valores personalizados y más. También puedes definir esquemas directamente en una transformación.

• Agregar complemento(s): Los complementos son aplicaciones proporcionadas por Jitterbit o por el usuario que amplían las capacidades nativas de Harmony. Para aplicar un complemento a la actividad, haz clic para expandir esta sección y selecciona la casilla junto al complemento que se utilizará. Para obtener instrucciones adicionales sobre el uso de complementos, incluidos los detalles sobre la configuración de cualquier variable requerida por el complemento, consulta Complementos añadidos a una actividad.

• Regresar: Haz clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

• Finalizado: Haz clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.

• Descartar cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Próximos pasos

Después de configurar una actividad de Lectura FTP, puedes usarla dentro de una operación o script como se describe a continuación.

Completar la operación

Después de configurar una actividad de Lectura FTP, completa la configuración de la operación añadiendo y configurando otras actividades o herramientas como pasos de la operación. También puedes configurar la configuración de operación de una operación, que incluye la capacidad de encadenar operaciones que están en los mismos o diferentes flujos de trabajo.

Las acciones del menú para una actividad son accesibles desde el panel del proyecto y el lienzo de diseño. Para más detalles, consulta Menú de acciones de actividad en Conceptos básicos de conectores.

Las actividades de Lectura FTP se pueden usar como fuente con estos patrones de operación:

• Patrón de archivo
• Patrón de transformación
• Patrón de archivo de dos destinos (como la primera fuente solamente)
• Patrón de archivo HTTP de dos destinos (como la primera fuente solamente)
• Patrón de dos transformaciones (como la primera fuente solamente)
• Patrón de destino masivo de Salesforce

Otros patrones no son válidos utilizando actividades de FTP Read. Consulte los patrones de validación en la página de validez de operación.

Cuando esté listo, implemente y ejecute la operación y valide el comportamiento revisando los registros de operación.

Usar actividades de FTP en scripts

Las actividades de FTP Read también se pueden referenciar en un script para su uso con funciones de script que utilizan un sourceId como parámetro, incluyendo estas:

Funciones de Script de Jitterbit

• ArchiveFile
• Base64EncodeFile
• DeleteFile
• DeleteFiles
• DirList
• FileList
• ReadFile

Funciones de Jitterbit en JavaScript

• Jitterbit.ReadFile

Para más detalles sobre cómo referenciar actividades en scripts, consulte Puntos finales en Jitterbit Script o Puntos finales en JavaScript.