Actividad de Escritura FTP¶

Introducción¶

Una actividad de escritura FTP escribe datos en un extremo FTP y está diseñada para usarse como destino para consumir datos en una operación o para ser llamada en un secuencia de comandos. Después de configurar una conexión FTP, puede configurar tantas actividades FTP como desee para cada conexión FTP.

Crear una Actividad FTP¶

Una instancia de una actividad se crea a partir de una conexión utilizando un tipo de actividad.

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

Una actividad existente se puede editar desde estas ubicaciones:

• El tela de diseño (consulte Menú de acciones del componente en Tela de Diseño).
• La pestaña Componentes del panel del proyecto (consulte Menú de acciones de componentes en Pestaña Componentes del panel de proyecto).

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 la configuración
• Paso 2: revisar los esquemas de datos

Paso 1: Ingrese un Nombre, Proporcione un Esquema de Solicitud y Especifique la Configuración¶

• Nombre: Introduzca un nombre que se utilizará 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 FTP. La necesidad de un esquema de solicitud depende de si la actividad se utiliza como objetivo de una transformación (consulte Uso del esquema). Para obtener instrucciones sobre cómo completar esta sección de configuración de actividad, consulte Esquemas definidos en una actividad.

• Ruta: Introduzca 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 varias rutas utilizando valores separados por comas. Si se especifican varias rutas, el mismo archivo se escribe en varias ubicaciones. Un ejemplo de múltiples caminos podría ser user1\path, user2\path.

• Nombre(s) de archivo: Ingrese el nombre de los archivos en los que desea escribir dentro de las rutas ingresadas anteriormente. Cualquiera de las palabras clave de 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 cambio de nombre FTP: Seleccionada de forma predeterminada, esta opción es para que los archivos utilicen inicialmente un nombre de archivo temporal que luego se renombra al nombre final. Desactive la casilla de verificación si esta opción causa problemas.

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

  

  • Crear directorios automáticamente: Mantenga esta casilla de verificación 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, es posible que no se cree el directorio. Si se utiliza esta opción, 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.

  • Agregar a archivo: Seleccione esta casilla de verificación para agregar al archivo de destino existente en lugar de sobrescribirlo. Tenga en cuenta que las conexiones SFTP no admiten la capacidad de agregar 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: Especifique cómo escribir saltos de línea al escribir en un destino. Tenga en cuenta que los caracteres de final de línea de los propios datos no se convierten. Las opciones son las siguientes:

    • Predeterminado: Caracteres de fin 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 de caracteres específica para el archivo de destino. Si deja el campo en blanco, Harmony intenta detectar la codificación. Si desea sobrescribir el valor predeterminado, puede elegir cualquiera de los tipos de codificación enumerados en Codificaciones de caracteres admitidas.

  • Carpeta de éxito/error: Disponible solo para 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 Cambiar nombre del archivo en el origen del archivo para permitirle escribir en una ubicación separada en lugar de en una subcarpeta en la misma ubicación.

    • Usar carpeta correcta: Seleccione esta casilla de verificación para escribir un archivo en la carpeta especificada después de un procesamiento exitoso en la ruta de destino principal. Si escribe un archivo en varias rutas, la operación será exitosa solo si todas las rutas lo son. Si esta casilla de verificación está seleccionada, proporcione también la Carpeta de éxito en la ruta absoluta en la máquina del Agente Privado.

    • Usar carpeta de errores: Seleccione esta casilla de verificación para escribir un archivo en la carpeta especificada después de un procesamiento fallido. Si al menos una ruta no tiene éxito, el archivo se escribe en esta carpeta. Si esta casilla de verificación está seleccionada, proporcione también la Carpeta de error en la ruta absoluta en la máquina del Agente Privado.

      Precaución

      Un archivo se escribe solo si el error se debe a errores al procesar la actividad de escritura FTP, como permisos de escritura insuficientes para la actividad. Un archivo no se escribe si, por ejemplo, la conexión FTP no tiene éxito, lo que provoca que falle 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.

    Cuando se utilizan palabras clave de nombre de archivo en estos campos, las palabras clave no se resuelven. Para obtener una solución alternativa, consulte Limitación y solución alternativa en Palabras clave de nombre de archivo. Usando asteriscos (*) y otros caracteres de nombres de archivos que normalmente no se admiten provocarán que la operación falle.

    Los archivos reciben el nombre especificado en el campo Nombre(s) de archivo anterior, 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 agrega 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 escribe en un archivo en la carpeta de errores.

  • Compresión: Seleccione la casilla de verificación para Comprimir archivos de destino si desea que los datos de destino se compriman. 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 archivos en archivos comprimidos: Ingrese el nombre de los archivos de destino que se comprimirán dentro del archivo comprimido. Cualquiera de las palabras clave de nombre de archivo están disponibles para generar nombres de archivos ú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 igual que los nombres de archivo definidos en el destino, ingrese [file].[ext].

    • Modo: De forma predeterminada, 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, elija el botón de opción tipo de transferencia ASCII. Para todos los demás tipos de archivos, elija el tipo de transferencia Binario. El binario es el predeterminado y normalmente funciona mejor.

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

• Siguiente: Haga clic para almacenar temporalmente la configuración para 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 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 la asignación de transformación proceso, donde puede asignar campos de destino utilizando objetos de origen, secuencias de comandos, variables, valores personalizados y más. También puede definir esquemas directamente en una transformación.

• Agregar complemento(s): Los complementos son aplicaciones de Jitterbit o proporcionadas por el usuario que amplían las capacidades nativas de Harmony. Para aplicar un complemento a la actividad, haga clic para expandir esta sección y seleccione la casilla de verificación junto al complemento que se utilizará. Para obtener instrucciones adicionales sobre el uso de complementos, incluidos detalles sobre cómo configurar las variables requeridas utilizadas por el complemento, consulte Complementos agregados a una actividad.

• Volver: Haga clic para almacenar temporalmente la configuración de este paso y volver 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 escritura FTP, puede usarla dentro de una operación o secuencia de comandos como se describe a continuación.

Completa la Operación¶

Después de configurar una actividad de escritura FTP, complete la configuración de la operación agregando y configurando otras actividades, transformaciones o secuencias de comandos como pasos de la operación. También puede configurar los ajustes de operación de una operación, que incluyen la capacidad de encadenar operaciones que se encuentran en el mismo flujo de trabajo o en diferentes flujos de trabajo.

Una vez que se ha creado una actividad de escritura FTP, se puede acceder a las acciones del menú para esa actividad 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 actividad para detalles.

Las actividades de escritura FTP se pueden utilizar como destino con estos patrones de operación:

• Patrón de archivo
• Patrón de secuencia de comandos
• Patrón de transformación
• Patrón de archivo de dos objetivos (solo como segundo objetivo)
• Patrón de archivo HTTP de dos destinos (solo como segundo objetivo)
• Patrón de dos transformaciones (solo como segundo objetivo)
• Patrón de origen masivo de Salesforce

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

Un caso de uso típico es utilizar una actividad de escritura FTP en el Patrón de Transformación. En este ejemplo, la actividad Consulta de base de datos (Solicitud de consulta) proporciona datos a la operación que luego se reciben mediante la transformación (Base de datos a FTP). La actividad de escritura FTP (Write Response) se utiliza como destino, recibiendo datos dentro de la operación:

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

Uso de Actividades FTP en Secuencias de Comandos¶

También se puede hacer referencia a las actividades de escritura FTP en un secuencia de comandos para usar con funciones de secuencia de comandos que utilizan un targetId como parámetro, incluidos estos:

Funciones de Jitterbit Script

• ArchiveFile
• FlushAllFiles
• FlushFile
• WriteFile

Funciones Jitterbit de 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.