Saltar al contenido

Actividad de escritura FTP

Introducción

Una actividad de Escritura FTP, que utiliza su conexión FTP, escribe datos en un extremo FTP y está destinado a ser utilizado como un destino para consumir datos en una operación o para ser llamado en un secuencia de comandos.

Crear una actividad de escritura FTP

Se crea una instancia de una actividad Escritura de FTP desde una conexión FTP utilizando su tipo de actividad Escribir.

Para crear una instancia de una actividad, arrastre el tipo de actividad al tela de diseño de tela de diseño o cópielo y péguelo en él. Para obtener más información, consulte Crear una instancia de actividad o herramienta en Reutilización de componentes.

Una actividad Escritura FTP existente se puede editar desde estas ubicaciones:

Configurar una actividad de escritura FTP

Siga estos pasos para configurar una actividad de Escritura de FTP:

Paso 1: Ingrese un nombre, proporcione un esquema de solicitud y especifique la configuración

Actividad de escritura FTP 1

Consejo

Campos con un icono de variable soporte utilizando variables globales, variables del proyecto y variables de Jitterbit. Comience escribiendo un corchete abierto [ en el campo o haciendo clic en el ícono de variable para mostrar una lista de las variables existentes para elegir.

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

  • Proporcionar esquema de solicitud: El esquema de solicitud define la estructura de datos que utiliza la actividad de Escritura de FTP. La necesidad de un esquema de solicitud depende de si la actividad se utiliza como destino de una transformación (véase Uso del esquema). Para obtener instrucciones sobre cómo completar esta sección de 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 varias rutas mediante valores separados por comas. Si se especifican varias rutas, el mismo archivo se escribe en varias ubicaciones. Un ejemplo de varias rutas podría ser user1\path, user2\path.

    Precaución

    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: Introduzca el nombre del archivo o archivos en los que desea escribir dentro de las rutas introducidas anteriormente. Cualquiera de las palabras clave del nombre de archivo están disponibles para generar nombres de archivos únicos (por ejemplo, result [date][tiempo].[ext]). Si especifica datos en formato ZIP, consulte las opciones de Compresión que se describen a continuación.

  • Usar renombrar FTP: Seleccionada por defecto, esta opción permite que los archivos usen inicialmente un nombre temporal que luego se renombra con el nombre definitivo. Desmarque esta casilla si esta opción causa problemas.

  • Configuración opcional: Haga clic para expandir configuraciones opcionales adicionales:

    Configuración opcional de la actividad de escritura FTP 1

    • 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 forma inconsistente. Dependiendo del servidor FTP, es posible que el directorio no se cree. Si se utiliza esta opción, se debe confirmar que el directorio se haya creado antes de su uso en producción.

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

    • Añadir a archivo: Seleccione esta casilla para añadir datos al archivo de destino existente en lugar de sobrescribirlos. Tenga en cuenta que las conexiones SFTP no permiten añadir datos a archivos, lo cual es una limitación de SFTP.

    • Escribir encabezados: Seleccione esta casilla de verificación si está utilizando un destino de texto plano y desea escribir encabezados (nombres de columnas/campos) en la primera línea.

    • Tipo de fin de línea: Especifica 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 no se convierten. Las opciones son las siguientes:

      • Predeterminado: Caracteres de final de línea estándar para la plataforma en la que se ejecuta 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 específica para el archivo de destino. Si deja este campo en blanco, Harmony intentará detectar la codificación. Si desea sobrescribir la predeterminada, puede elegir cualquiera de los tipos de codificación que aparecen en Codificaciones de caracteres compatibles.

    • Carpeta de éxito/error: Disponible solo para agentes privados donde los archivos locales están habilitados estas opciones se utilizan para archivar una copia de todos los archivos procesados. Esto puede usarse en lugar de la opción Después del procesamiento para Cambiar el nombre del archivo en el origen del archivo y así poder escribir en una ubicación separada en lugar de en una subcarpeta dentro de la misma ubicación.

      • Usar carpeta de éxito: Seleccione esta casilla para escribir un archivo en la carpeta especificada tras el procesamiento correcto en la ruta de destino principal. Si se escribe un archivo en varias rutas, la operación solo se considera correcta si todas las rutas son correctas. Si esta casilla está seleccionada, proporcione también la carpeta de éxito en la ruta absoluta en el equipo del agente privado.

      • Usar carpeta de errores: Seleccione esta casilla para escribir un archivo en la carpeta especificada tras un procesamiento fallido. Si al menos una ruta falla, el archivo se escribe en esta carpeta. Si esta casilla está seleccionada, proporcione también la carpeta de errores en la ruta absoluta en el equipo del agente privado.

        Precaución

        Un archivo solo se escribe si el fallo se debe a errores al procesar 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 correcta, lo que provoca el fallo de toda la operación.

      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, estas no se resuelven. Para obtener una solución alternativa, consulte [Limitación y solución alternativa](/es/integration-studio/design/variables/filename-keywords/#filenamekeywords-limitations) en [Palabras clave del nombre de archivo](/es/integration-studio/design/variables/filename-keywords). Usando asteriscos (`*`) y otros caracteres de nombre de archivo normalmente no admitidos provocarán que la operación falle.

      Los archivos se nombran como se especifica en el campo Nombre(s) de archivo anterior, con un guion bajo final y una marca de tiempo. Si ya existe 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 crea una copia con nombre 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 añadiría. De forma similar, si se especifica una carpeta de errores, los archivos que fallan se escriben en un archivo de dicha carpeta.

    • Compresión: Seleccione la casilla Comprimir archivos de destino si desea comprimir los datos de destino. Estas opciones estarán disponibles:

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

      • Nombres de archivo en el/los archivo(s): Introduzca el nombre del/de los archivo(s) de destino que se comprimirán dentro del archivo. Cualquiera de las palabras clave del nombre de archivo están disponibles para generar nombres de archivo únicos. Los archivos se escriben automáticamente en el archivo en el nivel raíz.

        Consejo

        Para mantener los nombres de archivo en el archivo comprimido iguales a los nombres de archivo definidos en el destino, ingrese [file].[ext].

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

      • Contraseña: Para cifrar el archivo, ingrese la contraseña deseada.

      • Modo de cifrado: Si se proporciona una contraseña, utilice el menú desplegable para seleccionar entre los dos modos de cifrado disponibles: AES y ZIP estándar.

    • Tipo de transferencia: Si los archivos están basados en ASCII, seleccione el botón de opción ASCII. Para todos los demás tipos de archivo, seleccione Binario. El formato binario es el predeterminado y suele ser el más adecuado.

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

Siguiente: Haga clic para guardar temporalmente la configuración de este paso y continuar con el siguiente. La configuración no se guardará hasta que haga 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 pedirá que confirme que desea descartar los cambios.

Paso 2: Revisar los esquemas de datos

Actividad de escritura FTP 2

Esquema de datos: Si se proporciona durante la configuración de la actividad, se muestra el esquema de datos solicitado. Si la operación utiliza una transformación, los esquemas de datos se muestran de nuevo posteriormente durante el mapeo de la transformación, donde puede asignar campos de destino mediante objetos de origen, secuencias de comandos, variables, valores personalizados y más. También puede definir esquemas directamente en una transformación.

  • Añadir complemento(s): Los complementos son aplicaciones proporcionadas por Jitterbit o por el usuario que amplían las funciones nativas de Harmony. Para aplicar un complemento a la actividad, haga clic para expandir esta sección y seleccione la casilla junto al complemento que desea utilizar. Para obtener instrucciones adicionales sobre el uso de complementos, incluyendo detalles sobre cómo configurar las variables requeridas, consulte complemento añadidos a una actividad.

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

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

Próximos pasos

Después de configurar una actividad de Escritura de FTP, puede usarla dentro de una operación o secuencia de comandos como se describe a continuación.

Completar la operación

Después de configurar una actividad de Escritura de FTP, complete la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de la operación. También puede configurar los ajustes de una operación, lo que incluye la posibilidad de encadenar operaciones que se encuentren en el mismo flujo de trabajo o en flujos de trabajo diferentes.

Una vez creada una actividad de escritura FTP, se puede acceder a las acciones del menú correspondiente desde el panel del proyecto, en las pestañas Flujos de trabajo o Componentes, y desde el tela de diseño. Consulte menú de acciones de la actividad para más detalles.

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

Otros patrones no son válidos con actividades de escritura FTP. Consulte los patrones de validación en Validez de la operación página.

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

Utilizar actividades FTP en secuencias de comandos

Las actividades de Escritura de FTP también se pueden referenciar en un secuencia de comandos para usar con funciones de secuencia de comandos que utilizan un targetId como parámetro, incluyendo estos:

Funciones de Jitterbit Script

  • ArchiveFile
  • FlushAllFiles
  • FlushFile
  • WriteFile

Funciones de Jitterbit en JavaScript

  • Jitterbit.WriteFile

Para obtener más detalles sobre cómo hacer referencia a actividades en secuencias de comandos, consulte Extremos en Jitterbit Script o Extremos en JavaScript.