Saltar al contenido

Actividad de escritura FTP en Jitterbit Studio

Introducción

Una actividad de escritura FTP Write, 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 Write se crea a partir de una conexión FTP utilizando su tipo de actividad Write.

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

Configurar una actividad de escritura FTP

Siga estos pasos para configurar una actividad de escritura FTP Write:

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ú que enumera las variables existentes de las que elegir.

  • Menú de puntos finales: Si tiene múltiples puntos finales del mismo tipo de conector configurados, un menú en la parte superior de la pantalla muestra el nombre del punto final actual. Haga clic en el menú para cambiar a un punto final diferente. Para más información, consulte Cambiar el punto final asignado en Pantallas de configuración.

    • Editar punto final: Aparece cuando pasa el cursor sobre el nombre del punto final actual. Haga clic para editar la configuración de conexión del punto final seleccionado actualmente.

  • Nombre: Ingrese 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 diagonales (/) ni dos puntos (:).

  • Proporcionar esquema de solicitud: El esquema de solicitud define la estructura de los datos que se utilizan en 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 (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 o más rutas válidas. Una ruta debe apuntar a un directorio existente en el servidor FTP. Por ejemplo, una sola 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: Ingrese el nombre del(los) archivo(s) que desea 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, consulte 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. Desmarque la casilla si esta opción causa problemas.

    Importante

    Usar la opción Usar Renombrar FTP al escribir en un servidor SFTP en una operación de patrón de archivo requiere versiones de agentes 11.56 o posteriores. También se recomienda la versión 11.56 o posterior si esta opción no responde como se espera con un servidor FTP.

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

    • Crear Directorios Automáticamente: Mantenga 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 creación automática de directorios funciona de manera inconsistente. Dependiendo del servidor FTP particular involucrado, el directorio puede no ser creado. Si se utiliza esta opción, 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 sobrescribir. 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 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 soportadas.

    • Carpeta de Éxito/Error: Disponible solo para su uso con agentes privados donde los archivos locales están habilitados, 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 permitir 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 esta casilla está seleccionada, también proporcione la Carpeta de Éxito en Ruta Absoluta en la máquina del agente privado.

      • Usar Carpeta de Error: Seleccione 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 proporcione 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 Escritura FTP, como permisos de escritura insuficientes para la actividad. No se escribe un archivo si, por ejemplo, la conexión FTP no es exitosa, causando 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 Nombre(s) de Archivo 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 errores, cualquier archivo que falle se escribe en un archivo en la carpeta de errores.

    • Compresión: Selecciona la casilla para Comprimir Archivos de Destino si deseas que los datos de destino se compriman. Estas opciones estarán disponibles:

      • Formato: Usa 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 en el 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 cifrar el archivo, ingresa la contraseña deseada.

      • Modo de cifrado: Si se proporciona una contraseña, usa el menú desplegable para seleccionar entre los dos modos de cifrado 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, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea 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 puede mapear a campos de destino utilizando objetos de origen, scripts, variables, valores personalizados y más. También puede 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, haga clic para expandir esta sección y seleccione la casilla junto al plugin que se utilizará. Para obtener instrucciones adicionales sobre el uso de plugins, incluidos los detalles sobre la configuración de cualquier variable requerida utilizada por el plugin, consulte Plugins añadidos a una actividad.

  • Atrás: Haga clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

  • Terminado: Haga 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, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.

Próximos pasos

Después de configurar una actividad de FTP Escribir, puede 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 Escribir, complete la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de operación. También puede 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 Write, las acciones del menú para esa actividad son accesibles desde el panel del proyecto en las pestañas de Workflows o Components, y desde el lienzo de diseño. Consulta el menú de acciones de actividad para más detalles.

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

Otros patrones no son válidos utilizando actividades de FTP Write. Consulta los patrones de validación en la página de Validez de operación.

Cuando estés listo, despliega y ejecuta la operación y valida el comportamiento revisando los registros de operación.

Usar actividades de FTP en scripts

Las actividades de FTP Write 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, consulta Endpoints en Jitterbit Script o Endpoints en JavaScript.