Crear un destino de sitio FTP en Jitterbit Design Studio

Introducción

Se puede usar un destino de sitio FTP para escribir en un servidor FTP con opciones como carpetas de éxito/error.

Prerrequisito

Antes de poder utilizar la función de carpetas de éxito/error de un destino de sitio FTP (consulte Opciones a continuación), debe haber habilitado la Ubicación de archivo local en su agente privado Jitterbit. Consulte Habilitar la ubicación de archivo local para más detalles.

Crear un sitio FTP de destino

Puede optar por crear un nuevo destino de sitio FTP por sí solo o dentro de una operación existente. Para obtener detalles sobre cómo funcionan los destinos dentro de las operaciones, consulte Creación de una operación.

Crear un nuevo destino de sitio FTP como destino independiente

Dentro de su proyecto en Jitterbit Design Studio, puede crear un nuevo destino de sitio FTP mediante cualquiera de los siguientes métodos:

• Vaya a Archivo > Nuevo > Nuevo objetivo; o

• En el árbol de la izquierda, haga clic derecho en Objetivos y seleccione Nuevo objetivo; o

• En la barra de herramientas superior, haga clic en el ícono de objetivo azul .

En la ventana emergente, seleccione Sitio FTP como tipo:

Su nuevo objetivo aparece en su propia pestaña Nuevo objetivo en el panel derecho de la ventana.

Crear un nuevo destino de sitio FTP en una operación existente

Por lo general, se crea un objetivo de forma predeterminada cuando se crea una nueva operación. (La excepción es una operación que consta únicamente de un secuencia de comandos). Con una operación existente, puede especificar el tipo de su objetivo mediante:

• Haga doble clic en el icono del objetivo; en la ventana emergente, seleccione Crear nuevo objetivo; o

• Hacer clic derecho en el ícono del objetivo y seleccionar Crear nuevo objetivo.

En la pantalla de configuración que aparece, utilice el menú desplegable Tipo para seleccionar Sitio FTP, como se muestra arriba.

Utilizar un destino de sitio FTP existente en una operación existente

Para utilizar un destino de sitio FTP existente en una operación existente con un destino, puede configurarlo mediante cualquiera de las siguientes opciones:

• Dentro de la operación, haciendo doble clic en el icono de destino y, en la ventana emergente resultante, seleccionando el destino del sitio FTP deseado de la lista; o

• Dentro de la operación, haga clic derecho en el ícono de destino, elija Seleccionar destino existente y, en la ventana emergente resultante, seleccione el destino del sitio FTP deseado de la lista; o

• Arrastre el destino del sitio FTP deseado desde el árbol de la izquierda y soltándolo sobre el ícono de destino existente de la operación.

Configurar un sitio FTP de destino

Una vez que haya creado un destino de sitio FTP, se abrirá la pantalla de configuración en la vista principal de Design Studio. Puede volver a la pantalla de configuración en cualquier momento haciendo doble clic en el icono del destino en la operación o haciendo doble clic en el destino en el árbol de la izquierda.

Configuración básica

La pantalla de configuración será similar a la de este ejemplo:

• Nombre: Ingrese un nombre apropiado y único para el objetivo.
• Tipo: Utilice el menú desplegable para seleccionar Sitio FTP, si aún no está especificado.
• Parámetros de conexión: Especifique los detalles para la conexión de su sitio FTP:

• Host: Ingrese una ubicación de servidor FTP válida para su fuente, como ftp.example.com. (Requerido.)

  • Usar puerto predeterminado: Los puertos predeterminados son 21 para FTP/FTPS y 22 para SFTP/SCP. Para puertos diferentes, desmarque la casilla Usar puerto predeterminado e ingrese un puerto para usar en el campo Puerto.
  • Ruta(s): Ingrese una o más rutas válidas. La ruta debe apuntar a un directorio existente en el servidor FTP, como /incoming/ Se pueden especificar varias rutas mediante valores delimitados por comas. Si se especifican varias rutas, el mismo archivo se escribe en varias ubicaciones.
  • Inicio de sesión y Contraseña: Ingrese un nombre de usuario (obligatorio) y una contraseña (si corresponde) que le permitirán acceder al servidor FTP. Deje la contraseña en blanco si no se requiere contraseña.

• Nombre(s) de archivo: Ingrese el nombre deseado para el(los) archivo(s) de destino. Se pueden usar variables en este campo. Si especifica un archivo comprimido (ZIP), consulte la sección "Compresión" de los parámetros de conexión adicionales en Opciones a continuación. El archivo se escribirá automáticamente en el archivo en el nivel raíz. (Obligatorio).

  • Desmarque Usar cambio de nombre de FTP si esta opción causa problemas.

• Conexión de prueba: Al hacer clic en el archivo probará el destino del sitio FTP; fallará si el directorio especificado no existe. No prueba si el usuario especificado tiene permiso de escritura en el directorio.

• Haga clic en el botón Guardar en la barra de herramientas principal o en la barra de herramientas de destino para guardar la configuración.

Opciones

Se pueden especificar parámetros de conexión adicionales haciendo clic en Opciones en la parte inferior de la sección Parámetros de conexión:

• Modo pasivo: Deje esta casilla marcada para utilizar el método "PASV" del servidor FTP para recuperar archivos. Cuando esta opción está habilitada, el agente abrirá una conexión de control con el servidor FTP, le indicará al servidor FTP que espere una segunda conexión y luego abrirá la conexión de datos con el servidor FTP en un puerto de número alto elegido al azar. Esto funciona con la mayoría de los firewalls a menos que el firewall restrinja las conexiones salientes en los puertos de número alto.

• Crear directorios automáticamente: Crea 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. Según el servidor FTP en 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 usarlo en producción.

• Escribir encabezados: Si está marcado y el destino es texto plano, se escribirá un encabezado de nombres de columnas/campos como la primera línea.

• No crear archivos vacíos: Si está marcada, se omitirá la creación del archivo de destino si no hay datos de destino.
• Agregar a archivo: Si se marca esta opción, los datos se agregarán a un archivo de destino existente en lugar de sobrescribirse. Tenga en cuenta que las conexiones SFTP no admiten la capacidad de agregar datos a archivos, lo cual es una limitación de SFTP.

• Tipo de fin de línea: Determina cómo Jitterbit escribe 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 convertirán. Opciones disponibles:

  • 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: Se utiliza para especificar una codificación de caracteres para el archivo de destino. Si se deja en blanco, Jitterbit intentará detectar la codificación. Para especificar una codificación diferente a la predeterminada, inserte una de las codificaciones compatibles que se describen en Codificaciones de caracteres compatibles.

• Carpeta de éxito/error: Especifica si se utilizarán las carpetas de éxito y/o error para archivar una copia de todos los archivos procesados.

  • Si se especifica una carpeta de éxito, al procesar correctamente el objetivo, se escribirá una copia del archivo en un archivo de esa carpeta.
  • El archivo tendrá el mismo nombre que el especificado en el campo Nombre(s) de archivo anterior, pero con un guión bajo final y una marca de tiempo agregados. Si ya hay un archivo con el mismo nombre en esa carpeta, se agregará un guión bajo adicional y un contador.
  • Ejemplo: si un archivo llamado data.csv se procesó con éxito, se creó una copia denominada data.csv_2018-01-01_12-00-00-000 podría escribirse en la carpeta especificada como Carpeta de éxito. Si ya existe un archivo de este tipo 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, todos los archivos que fallen se escribirán en un archivo en la Carpeta de errores.

  Importante

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

  Al utilizar 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 del nombre de archivo. Utilizando asteriscos (*) y otros caracteres de nombre de archivo normalmente no admitidos provocarán que la operación falle.

• Compresión: Si se selecciona la casilla de verificación Comprimir archivos de destino, los archivos de destino se comprimirán utilizando el formato ZIP. Las opciones adicionales son:

  • Nombre(s) de archivo en el archivo: Acepta variables y palabras clave de nombre de archivo. Para mantener el nombre de archivo en el archivo igual al nombre de archivo definido en el destino, use un formato de [file].[ext] como se muestra arriba.
  • Modo: No aplicable para destinos de sitios FTP.
  • Contraseña: Para archivos cifrados, proporcione una contraseña.
  • Modo de cifrado: Si se proporciona una contraseña, hay dos modos de cifrado disponibles: AES y ZIP estándar.

• Configuración de proxy: Utilice el menú desplegable para seleccionar una de estas opciones para un proxy personalizado para el alojar FTP:

  • Deshabilitar: Las configuraciones de proxy están deshabilitadas para esta fuente específica, omitiendo la configuración de proxy del agente si existe.
  • Predeterminado: La configuración de proxy está habilitada, utilizando la configuración de proxy del agente si existe. Si no se especifican configuraciones de proxy en la configuración del agente, la configuración Predeterminada tiene el mismo resultado que la configuración Deshabilitar.

  • Personalizado: Las configuraciones de proxy se habilitan para esta fuente específica utilizando la información personalizada proporcionada aquí. Esta opción omite la configuración de proxy del agente si existe. Cuando se selecciona Personalizado, estos campos están disponibles:

    

    Vea Habilitación de proxy para agentes privados para obtener detalles sobre estos campos.

• Tipo de transferencia: Si los archivos están basados en ASCII, elija el tipo de transferencia ASCII; para todos los demás tipos de archivos, elija Binario. El binario es el valor predeterminado y suele funcionar mejor.

• Opciones de seguridad: Estas opciones están disponibles:

• FTP no seguro: Utiliza FTP normal sin cifrar y no es seguro, ya que las contraseñas se envían en texto sin cifrar a través de la red. Utilizar solo en un ambiente seguro. (Predeterminado).

  • FTP explícito: Esta opción utiliza FTP explícito con SSL, lo que requiere que el cliente FTP solicite información de seguridad antes de que comience la transferencia de un archivo. Cuando se selecciona esta opción, puede configurar el Modo de autenticación preferido (TLS o SSL) y estas Opciones de SSL:

    • Probar SSL: Esto intenta iniciar una transferencia cifrada con TLS/SSL. Si falla, se utilizará un FTP no cifrado.
    • Requerir TLS/SSL para la conexión de control: Con esta opción, la conexión de control FTP inicial se cifra mediante TLS/SSL para garantizar que el intercambio de contraseñas esté cifrado. La transferencia en sí no se cifrará, pero al menos la contraseña no se enviará en texto sin cifrar. Si los datos en sí no son confidenciales o ya están cifrados, puede utilizar esta opción. Si el servidor no admite FTPS, la transferencia fallará.
    • Requerir TLS/SSL para todas las transferencias de datos: Esta opción requiere que tanto la conexión de control como la conexión de datos estén cifradas mediante TLS/SSL. Si el servidor no admite SSL, la transferencia fallará.

  • FTPS implícito: Esta opción utiliza FTPS implícito (FTP implícito con TLS/SSL), lo que requiere una conexión TLS/SSL antes de la transferencia de archivos.

  • SFTP: Esta opción utiliza el protocolo SFTP en lugar de FTP. Esta opción solo se puede utilizar si se conecta a un servidor SFTP. Los archivos de clave pública y privada para SFTP se pueden configurar en la sección SSH del archivo de configuración del agente, como se describe en Conectarse a SFTP con claves SSH. Tenga en cuenta que SFTP y FTP/FTPS son protocolos diferentes y utilizan puertos predeterminados diferentes.