Saltar al contenido

Actividad de escritura FTP

Introducción

Una actividad de Escritura FTP, utilizando su conexión FTP, escribe datos en un punto final FTP y está destinada a ser utilizada como un objetivo para consumir datos en una operación o para ser llamada en un script.

Crear una actividad de escritura FTP

Una instancia de una actividad de Escritura FTP se crea a partir de una conexión FTP utilizando su tipo de actividad Escritura.

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 Escritura FTP existente se puede editar desde estas ubicaciones:

Configurar una actividad de escritura FTP

Siga estos pasos para configurar una actividad de Escritura FTP:

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

Consejo

Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comience escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar un menú con las variables existentes para elegir.

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

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

  • Ruta: Ingresa una o más rutas válidas. Una ruta debe apuntar a un directorio existente en el servidor FTP. Por ejemplo, una única ruta podría ser /outbound. Se pueden especificar múltiples rutas utilizando valores separados por comas. Si se especifican múltiples rutas, el mismo archivo se escribe en múltiples ubicaciones. Un ejemplo de múltiples rutas podría ser user1\path, user2\path.

    Precaución

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

  • Nombre(s) de archivo: Ingresa el nombre del(los) archivo(s) que deseas escribir dentro de la(s) ruta(s) ingresada(s) arriba. Cualquiera de las palabras clave de nombre de archivo está disponible para generar nombres de archivo únicos (por ejemplo, result[date][time].[ext]). Si se especifican datos en formato ZIP, consulta las opciones de Compresión descritas a continuación.

  • Usar renombrar FTP: Seleccionado por defecto, esta opción es para que los archivos utilicen inicialmente un nombre de archivo temporal que luego se renombra al nombre final. Desmarca la casilla si esta opción causa problemas.

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

    • Crear directorios automáticamente: Mantén esta casilla seleccionada para crear automáticamente cualquier directorio que aún no exista en la ruta de destino.

      Advertencia

      Es un problema conocido que la auto-creación de directorios funciona de manera inconsistente. Dependiendo del servidor FTP particular involucrado, el directorio puede no ser creado. Si se utiliza esta opción, se debe confirmar que el directorio ha sido creado antes de su uso en producción.

    • No crear archivos vacíos: Seleccione esta casilla para omitir la creación del archivo de destino si no hay datos de destino.

    • Agregar al archivo: Seleccione esta casilla para agregar al archivo de destino existente en lugar de sobrescribirlo. Tenga en cuenta que las conexiones SFTP no admiten la capacidad de agregar a archivos, lo cual es una limitación de SFTP.

    • Escribir encabezados: Seleccione esta casilla si está utilizando un archivo de texto plano y desea escribir encabezados (nombres de columna/campo) en la primera línea.

    • Tipo de fin de línea: Especifique cómo escribir los saltos de línea al escribir en un destino. Tenga en cuenta que los caracteres de fin de línea en los datos mismos no se convierten. Las opciones son las siguientes:

      • Predeterminado: Caracteres de fin de línea estándar para la plataforma en la que se está ejecutando el agente.

      • Windows: CRLF (ASCII 13 y ASCII 10).

      • Unix: LF (ASCII 10).

    • Codificación de caracteres: Especifique la codificación de caracteres para definir una codificación de caracteres específica para el archivo de destino. Si deja el campo en blanco, Harmony intenta detectar la codificación. Si desea sobrescribir la predeterminada, puede elegir entre cualquiera de los tipos de codificación enumerados en Codificaciones de caracteres admitidas.

    • Carpeta de éxito/error: Disponible solo para su uso con agentes privados donde se habilitan archivos locales, 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 de procesar para Renombrar archivo en la fuente de archivo para permitirle escribir en una ubicación separada en lugar de en una subcarpeta en la misma ubicación.

      • Usar carpeta de éxito: Seleccione 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 se selecciona esta casilla, también proporcione la Carpeta de éxito en ruta absoluta en la máquina del agente privado.

      • Usar Carpeta de Errores: Seleccione esta casilla para escribir un archivo en la carpeta especificada después de un procesamiento fallido. Si al menos una ruta es fallida, entonces el archivo se escribe en esta carpeta. Si esta casilla está seleccionada, también proporcione la Carpeta de Errores en Ruta Absoluta en la máquina del agente privado.

        Advertencia

        Un archivo se escribe solo si la falla se debe a errores en el procesamiento de la actividad de escritura FTP, como permisos de escritura insuficientes para la actividad. No se escribe un archivo si, por ejemplo, la conexión FTP es fallida, lo que causa 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 en 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 Nombre(s) de Archivo, con un guion bajo adicional 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 correctamente, 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 errores, cualquier archivo que falle se escribe en un archivo en la carpeta de errores.

    • Compresión: Seleccione la casilla para Comprimir Archivos de Destino si desea que los datos de destino sean comprimidos. Estas opciones estarán disponibles:

      • Formato: Use el menú desplegable para seleccionar el formato de compresión deseado. Actualmente, solo se admite el formato ZIP.

      • Nombres de archivos en el(los) archivo(s): Ingresa el nombre del(los) archivo(s) de destino que se van a comprimir dentro del archivo. Cualquiera de las palabras clave de nombre de archivo está disponible para generar nombres de archivo únicos. El(los) archivo(s) se escriben automáticamente en el archivo a nivel raíz.

        Consejo

        Para mantener el(los) nombre(s) de archivo en el archivo igual que el(los) nombre(s) de archivo definidos en el destino, ingresa [file].[ext].

      • Modo: Por defecto, el modo Sobrescribir sobrescribe el archivo existente. Este es el único modo disponible.

      • Contraseña: Para encriptar el archivo, ingresa la contraseña deseada.

      • Modo de encriptación: Si se proporciona una contraseña, utiliza el menú desplegable para seleccionar entre los dos modos de encriptación disponibles: AES y ZIP Estándar.

    • Tipo de Transferencia: Si los archivos son basados en ASCII, elige el botón de opción de tipo de transferencia ASCII. Para todos los demás tipos de archivo, elige el tipo de transferencia 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 Finalizado 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 la solicitud. Si la operación utiliza una transformación, los esquemas de datos se muestran 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 plugin(s): Los plugins son aplicaciones proporcionadas por Jitterbit o por el usuario que amplían las capacidades nativas de Harmony. Para aplicar un plugin a la actividad, haz clic para expandir esta sección y selecciona la casilla junto al plugin que se va a utilizar. Para instrucciones adicionales sobre el uso de plugins, incluidos los detalles sobre la configuración de cualquier variable requerida por el plugin, consulta Plugins añadidos a una actividad.

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

  • Terminado: 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.

Siguientes pasos

Después de configurar una actividad de FTP Escritura, 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 FTP Escritura, completa la configuración de la operación agregando 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.

Una vez que se ha creado una actividad de FTP Escritura, las acciones del menú para esa actividad son accesibles desde el panel del proyecto en las pestañas de Flujos de trabajo o Componentes, y desde el lienzo de diseño. Consulta Menú de acciones de actividad para más detalles.

Las actividades de FTP Escritura se pueden usar como un objetivo con estos patrones de operación:

Otros patrones no son válidos al usar actividades de FTP Escribir. Consulte los patrones de validación en la página de validez de operaciones.

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

Usar actividades de FTP en scripts

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

Funciones de Script de Jitterbit

  • ArchiveFile
  • FlushAllFiles
  • FlushFile
  • WriteFile

Funciones de Jitterbit en JavaScript

  • Jitterbit.WriteFile

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