Crear una Fuente de Sitio FTP¶

Introducción¶

Una fuente de sitio FTP puede leer desde un servidor FTP con opciones como carpetas de éxito/error y un archivo desencadenante.

Requisito Previo¶

Antes de poder utilizar las carpetas de éxito/error y la función de archivo de activación de una fuente de sitio FTP (consulte las Opciones a continuación), debe haber habilitado la Ubicación de archivos locales en su Agente Privado Jitterbit. Consulte Habilitación de la ubicación del archivo local para detalles.

Crear una Fuente de Sitio FTP¶

Puede optar por crear una nueva fuente de sitio FTP por sí sola o dentro de una operación existente. Para obtener más información sobre cómo funcionan las fuentes dentro de las operaciones, consulte Creación de una operación.

Cree una Nueva Fuente de Sitio FTP Como Fuente Independiente¶

Dentro de su proyecto dentro de Jitterbit Design Studio, crea una nueva fuente de sitio FTP mediante cualquiera de:

• Vaya a Archivo > Nuevo > Nueva fuente; o

• En el árbol de la izquierda, haga clic derecho en Fuentes y seleccione Nueva fuente; o

• En la barra de herramientas superior, haga clic en el icono de fuente verde .

En la ventana emergente, seleccione Sitio FTP como tipo:

Su nueva fuente aparece en su propia pestaña Nueva fuente en el panel derecho de la ventana.

Crear una Nueva Fuente de Sitio FTP en una Operación Existente¶

Normalmente se crea una fuente 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 fuente de la siguiente manera:

• Hacer doble clic en el icono de fuente; en la ventana emergente, seleccione Crear nueva fuente; o

• Hacer clic derecho en el icono de la fuente y seleccionar Crear nueva fuente.

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

Utilice la Fuente del Sitio FTP Existente en una Operación Existente¶

Para utilizar una fuente de sitio FTP existente en una operación existente con una fuente, puede configurarla mediante cualquiera de:

• Dentro de la operación, haga doble clic en el icono de la fuente y, en la ventana emergente resultante, seleccione la fuente del sitio FTP deseada de la lista; o

• Dentro de la operación, haga clic derecho en el icono de fuente, elija Seleccionar fuente existente y, en la ventana emergente resultante, seleccione la fuente del sitio FTP deseada de la lista; o

• Arrastrando la fuente del sitio FTP deseada desde el árbol de la izquierda y soltándola en el icono de fuente existente de la operación.

Configurar una Fuente de Sitio FTP¶

Después de haber creado una fuente 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 de la fuente en la operación, o haciendo doble clic en la fuente en el árbol de la izquierda.

Configuracion Basica¶

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

• Nombre: Introduzca un nombre único y apropiado para la fuente.
• Tipo: Utilice el menú desplegable para seleccionar Sitio FTP, si aún no está especificado.

• Parámetros de conexión: Especifique los detalles de su conexión 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 diferentes puertos, desmarque la casilla de verificación Usar puerto predeterminado e ingrese un puerto para usar en el campo Puerto.
  • Ruta: Introduzca una única ruta válida. Una ruta debe apuntar a un directorio existente en el servidor FTP, como por ejemplo /inbound/.
  • Inicio de sesión y Contraseña: Ingrese un nombre de usuario (obligatorio) 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.

  • Obtener archivos: Ingrese el nombre de los archivos de origen que desea leer dentro del directorio especificado en Ruta. Este campo también puede incluir un asterisco. * para utilizar como comodín (por ejemplo, *.txt o *.*) o un signo de interrogación ? para que coincida exactamente con un carácter (por ejemplo, file?.txt). También se pueden utilizar 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 abajo. El archivo comprimido se puede descomprimir y leer automáticamente. (Requerido.)

    Consejo

    Si faltan archivos conocidos o si los nombres de los archivos tienen información adicional adjunta después de recuperarlos del extremo, configure jitterbit.source.ftp.enable_regex_parser a true arriba en la cadena de la lectura de archivos desde el extremo.

  • Opciones de filtro: Permite especificar si se deben ignorar las mayúsculas y minúsculas del nombre de archivo o si la información de Obtener archivos debe tratarse como una expresión regular.

• Probar conexión: Haga clic en probará la fuente del sitio FTP; Fallará si no se puede establecer una conexión con el alojar o si la ruta no es una ruta válida que encuentre archivos. Se devolverá una lista de archivos que coinciden con el patrón especificado en Obtener archivos.

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

• Listar solo nombres de archivos: Marque esta casilla para listar solo nombres de archivos (usa el comando FTP NLST en lugar de LIST). Pruebe esto si Jitterbit no puede analizar la lista del directorio FTP enviada por el servidor FTP.

  Consejo

  Si faltan archivos conocidos o si los nombres de los archivos tienen información adicional adjunta después de recuperarlos del extremo, configure jitterbit.source.ftp.enable_regex_parser a true arriba en la cadena de la lectura de archivos desde el extremo.

• 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 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 puertos con números altos.

• Codificación de caracteres: Se utiliza para especificar una codificación de caracteres para los archivos de origen. 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 Codificación de caracteres.
• Tiempo de espera de transferencia: Especifique la cantidad de segundos después de los cuales expirará el tiempo de espera de una transferencia FTP. De forma predeterminada, este número es 14.400 segundos o 4 horas.

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

  • Si se especifica una carpeta correcta, al procesar correctamente la fuente, se escribirá una copia del archivo en un archivo de esa carpeta.
  • El archivo tendrá el mismo nombre que el especificado en el campo Obtener archivos anterior, pero 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 agregará un guión bajo adicional y un contador.
  • 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 en la máquina del Agente Privado. 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 escribirá en un archivo en la Carpeta de errores en la máquina del Agente Privado.

  Importante

  Las rutas absolutas para las carpetas de éxito y error se encuentran en 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.

• Archivo de activación: Especifica si un archivo de activación iniciará el procesamiento de los archivos de origen. El archivo desencadenante se elimina cuando comienza el procesamiento.

  • Después de seleccionar la casilla de verificación Usar activador, especifique una Ruta de archivo absoluta para un archivo cuya presencia activará el procesamiento.
  • En este campo se pueden utilizar variables (aunque no comodines).
  • Dado que el archivo desencadenante se elimina cuando comienza el procesamiento, el archivo desencadenante no puede ser el mismo archivo que el archivo fuente que se está procesando.
  • La operación sondeará y buscará el archivo desencadenante. El intervalo de tiempo de sondeo se fija en un segundo.
  • El archivo desencadenante se elimina cuando comienza el procesamiento.
  • Si no se encuentra el archivo desencadenante, la operación seguirá intentando encontrar el archivo desencadenante hasta que expire el tiempo de espera de la operación.
  • La configuración de un archivo desencadenante bloquea cualquier operación o secuencia de comandos que utilice el código fuente hasta que se cumpla la condición del archivo desencadenante o se agote el tiempo de espera de la operación.

• Después de procesar:

  • Si la casilla de verificación Eliminar archivo está marcada, los archivos de origen se eliminarán una vez procesados.
  • Si se especifica un valor en el campo Cambiar nombre de archivo, se cambiará el nombre del archivo utilizando el patrón proporcionado. Se pueden utilizar variables en este campo.
  • Sólo se acepta uno de eliminar o cambiar el nombre; Si la casilla de verificación Eliminar archivo está marcada, Cambiar nombre de archivo se desactivará y se ignorará. Si Cambiar nombre de archivo está vacío, se ignorará. Si se deja como predeterminado, no se realizará ningún procesamiento posterior de los archivos fuente.

• Ignorar líneas: Los números indicados de la primera y última línea que se ignorarán para cada archivo. Si hay encabezados o pies de página que deben ignorarse, ingrese el número de líneas en los campos Primero y Último según corresponda.

• Compresión: Si la casilla de verificación Los datos de origen están comprimidos está marcada, los archivos de origen se descomprimirán utilizando el formato ZIP. Se puede especificar una Contraseña (para archivos cifrados). Solo se admite la lectura desde el directorio raíz del archivo.

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

  • Desactivar: La configuración del proxy está desactivada para esta fuente específica, sin pasar por la Configuración del proxy del Agente si existe.
  • Predeterminado: La configuración del proxy está habilitada mediante la Configuración del proxy del Agente si existe. Si la configuración del proxy no se especifica en la configuración del Agente, la configuración Predeterminada tiene el mismo resultado que la configuración Desactivar.

  • Personalizado: La configuración de 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 pasan a estar disponibles:

    

    Consulte Habilitación del 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 predeterminado y normalmente funciona mejor.

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

• FTP no seguro: Esto 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. Úselo únicamente en un ambiente seguro. (Predeterminado).

  • FTPS 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 una transferencia de archivos. Cuando se selecciona esta opción, puede configurar el Modo de autenticación preferido (ya sea TLS o SSL) y estas Opciones SSL:

    • Pruebe SSL: Esto intenta iniciar una transferencia cifrada con 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 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 claro. 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 está conectando a un servidor SFTP. Los archivos de claves públicas y privadas 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.