Crear un objetivo de sitio FTP en Jitterbit Design Studio

Introducción

Un objetivo de sitio FTP se puede utilizar 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 objetivo de sitio FTP (ver las Opciones a continuación), debe haber habilitado la Ubicación de Archivo Local en su agente privado de Jitterbit. Consulte Habilitar ubicación de archivo local para más detalles.

Crear un objetivo de sitio FTP

Puede optar por crear un nuevo objetivo de sitio FTP por su cuenta, o dentro de una operación existente. Para obtener detalles sobre cómo funcionan los objetivos dentro de las operaciones, consulte Crear una operación.

Crear un nuevo objetivo de sitio FTP como un objetivo independiente

Dentro de su proyecto en Jitterbit Design Studio, puede crear un nuevo objetivo de sitio FTP de cualquiera de las siguientes maneras:

• 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 el tipo:

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

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

Un objetivo generalmente se crea por defecto cuando creas una nueva operación. (La excepción es una operación que consiste solo en un script). Con una operación existente, puedes especificar el tipo de su objetivo de la siguiente manera:

• Haciendo doble clic en el ícono del objetivo; en el popup, selecciona Crear Nuevo Objetivo; o

• Haciendo clic derecho en el ícono del objetivo y seleccionando Crear Nuevo Objetivo.

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

Usar un objetivo de sitio FTP existente en una operación existente

Para usar un objetivo de Sitio FTP existente en una operación existente con un objetivo, puedes configurarlo de cualquiera de las siguientes maneras:

• Dentro de la operación, haciendo doble clic en el ícono del objetivo, y en el popup resultante, seleccionando el objetivo de Sitio FTP deseado de la lista; o

• Dentro de la operación, haciendo clic derecho en el ícono del objetivo, eligiendo Seleccionar Objetivo Existente, y en el popup resultante, seleccionando el objetivo de Sitio FTP deseado de la lista; o

• Arrastrando el objetivo de Sitio FTP deseado desde el árbol a la izquierda y soltándolo sobre el ícono del objetivo existente de la operación.

Configurar un objetivo de sitio FTP

Después de haber creado un objetivo de Sitio FTP, la pantalla de configuración se abrirá en la vista principal de Design Studio. Puedes regresar a la pantalla de configuración en cualquier momento haciendo doble clic en el ícono del objetivo en la operación, o haciendo doble clic en el objetivo en el árbol a la izquierda.

Configuración básica

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

• Nombre: Ingrese un nombre único y apropiado para el destino.
• Tipo: Use el menú desplegable para seleccionar Sitio FTP, si no está especificado ya.
• Parámetros de conexión: Especifique los detalles para su conexión al Sitio FTP:

• Host: Ingrese una ubicación válida del servidor FTP para su origen, 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 a utilizar 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 múltiples rutas utilizando valores delimitados por comas. Si se especifican múltiples rutas, el mismo archivo se escribe en múltiples ubicaciones.
  • Inicio de sesión y Contraseña: Ingrese un nombre de usuario (requerido) y una contraseña (si corresponde) que permitirán el acceso al servidor FTP. Deje la contraseña en blanco si no se requiere contraseña.

• Nombre de archivo(s): Ingrese el nombre deseado para el(los) archivo(s) de destino. Se pueden usar variables en este campo. Si se 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. (Requerido.)

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

    Precaución

    Usar la opción Usar renombrar FTP al escribir en un servidor SFTP en una operación de archivo no es funcional.

• Probar conexión: Hacer clic en el botón 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 del 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 al servidor FTP, le indicará al servidor FTP que espere una segunda conexión y luego abrirá la conexión de datos al servidor FTP en un puerto de alto número elegido aleatoriamente. Esto funciona con la mayoría de los firewalls a menos que el firewall restrinja las conexiones salientes en puertos de alto número.

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

• Escribir Encabezados: Si está marcada y es un destino de texto plano, se escribirá un encabezado de nombres de columna/campo 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 al Archivo: Si está marcada, los datos se agregarán a un 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.

• 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 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: 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 admitidas descritas en Codificaciones de caracteres admitidas.

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

• Si se especifica una carpeta de éxito, al procesar exitosamente 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 arriba, pero se le añadirá un guion bajo al final y una marca de tiempo. Si ya hay un archivo con el mismo nombre en esa carpeta, se añadirá un guion bajo adicional y un contador.
• Ejemplo: si se procesa exitosamente un archivo llamado data.csv, se podría escribir una copia llamada data.csv_2018-01-01_12-00-00-000 en la carpeta especificada como Carpeta de éxito. Si ya existe un archivo así 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 escribirá en un archivo en la Carpeta de errores.

  Importante

  Las rutas absolutas para las carpetas de éxito y de errores 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 hará que la operación falle.

• Compresión: Si se selecciona la casilla para Comprimir archivos de destino, los archivos de destino se comprimirán usando 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 del archivo en el archivo comprimido igual que el nombre del archivo definido en el objetivo, use un formato de [file].[ext] como se muestra arriba.
  • Modo: No aplicable para objetivos de FTP Site.
  • Contraseña: Para archivos comprimidos encriptados, proporcione una contraseña.
  • Modo de encriptación: Si se proporciona una contraseña, hay dos modos de encriptación disponibles: AES y ZIP estándar.

• Configuraciones de proxy: Use el menú desplegable para seleccionar una de estas opciones para un proxy personalizado para el host FTP:

• Deshabilitar: La configuración del proxy está deshabilitada para esta fuente específica, omitiendo la configuración del proxy del agente si existe.

• Predeterminado: La configuración del proxy está habilitada, utilizando la configuración del proxy del agente si existe. Si no se especifican configuraciones de proxy en la configuración del agente, la configuración Predeterminado tiene el mismo resultado que la configuración Deshabilitar.

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

  ![attachment](/_download/attachments/55148712/image2016-12-19%20141147.png)
  
  Consulte [Habilitar proxy para agentes privados](/es/agent/proxy/) para obtener detalles sobre estos campos.
  

• Tipo de Transferencia: Si los archivos son basados en ASCII, elija el tipo de transferencia ASCII; para todos los demás tipos de archivos, elija Binario. Binario es el predeterminado y generalmente funciona mejor.

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

• FTP Inseguro: Esto utiliza FTP normal no cifrado y no es seguro ya que las contraseñas se envían en texto claro a través de la red. Usar solo en un entorno seguro. (Predeterminado.)

  • FTPS Explícito: Esta opción utiliza FTP explícito con SSL, requiriendo que el cliente FTP solicite información de seguridad antes de que comience la transferencia de archivos. Cuando se selecciona esta opción, puede establecer el Modo de Autenticación preferido (ya sea TLS o SSL) y estas Opciones de SSL:

    • Intentar SSL: Esto intenta iniciar una transferencia cifrada TLS/SSL. Si eso falla, se utilizará 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 utilizando TLS/SSL para asegurar que el intercambio de contraseñas esté cifrado. La transferencia en sí no estará cifrada, pero al menos la contraseña no se envía en texto claro. Si los datos en sí no son sensibles o ya están cifrados, puede usar esta opción. Si el servidor no admite FTPS, la transferencia fallará.
    • Requerir TLS/SSL para toda la transferencia de datos: Esta opción requiere que tanto la conexión de control como la conexión de datos estén cifradas utilizando 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), requiriendo 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 está conectando 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 Conectar a SFTP con claves SSH. Tenga en cuenta que SFTP y FTP/FTPS son protocolos diferentes y utilizan puertos predeterminados diferentes.