Compartir a través de

Configuración del adaptador de FTP

Antes de empezar

  • El adaptador FTP admite la lectura y escritura de datos desde un servidor FTP seguro. El adaptador ofrece soporte para la transferencia de archivos desde un servidor FTP a través de Secure Sockets Layer (SSL)/Transport Level Security (TLS).
  • El adaptador FTP admite la descarga de archivos desde ubicaciones de archivos de solo lectura.
  • El adaptador FTP también admite la transferencia atómica de archivos para el modo ASCII.

Consulte Procedimientos recomendados y recomendaciones para el adaptador ftp.

Configuración de la ubicación de recepción

Puede establecer las propiedades del adaptador de ubicación de recepción de FTP en la consola de administración de BizTalk Server. Si las propiedades no se establecen en la ubicación de recepción, se usan los valores de controlador de recepción predeterminados en la consola de administración de BizTalk Server.

Nota:

Antes de completar el siguiente procedimiento, debe haber agregado ya un puerto de recepción. Consulte How to Create a Receive Port (Cómo crear un puerto de recepción).

  1. En la consola de administración de BizTalk Server, expanda Administración de BizTalk Server, expanda Grupo de BizTalk, expanda Aplicaciones y, a continuación, expanda la aplicación en la que desea crear una ubicación de recepción.

  1. En el panel izquierdo, haga clic en el nodo Puertos de recepción . En el panel derecho, haga clic con el botón derecho en el puerto de recepción asociado a una ubicación de recepción existente o que desee asociar a una nueva ubicación de recepción y, a continuación, haga clic en Propiedades.

  2. En el cuadro de diálogo Propiedades del puerto de recepción , en el panel izquierdo, seleccione Ubicaciones de recepción. En el panel derecho, haga doble clic en una ubicación de recepción existente o haga clic en Nuevo para crear una nueva ubicación de recepción.

  3. En el cuadro de diálogo Propiedades de ubicación de recepción , en la sección Transporte junto a Tipo, seleccione FTP en la lista desplegable y, a continuación, haga clic en Configurar.

  4. En Propiedades de transporte FTP, haga lo siguiente:

    Lote

    Usa esto Para
    Máximo de archivos Especifique el número máximo de archivos por lote de BizTalk Server.

    Cero (0) indica que no hay límite.

    Valor predeterminado: 0
    Tamaño máximo Especifique el número máximo de bytes por lote de BizTalk Server.

    Cero (0) indica que no hay límite.

    Valor predeterminado: 0

    Cortafuegos

    Usa esto Para
    Dirección Especifique la dirección del firewall, ya sea un nombre DNS o una dirección IP.
    Modo Especifique el modo en el que el adaptador se conecta al servidor FTP.

    Valores válidos: Pasivo y Activo

    En modo activo, el servidor FTP se conecta a un puerto abierto por el adaptador FTP. En modo pasivo, el adaptador FTP se conecta a un puerto abierto por el servidor FTP. Es posible que el modo activo no funcione si usa una dirección IP interna y se conecta a una dirección IP externa. En este caso, debe usar el modo pasivo o el modo activo con una puerta de enlace de capa de aplicación (ALG) con compatibilidad con FTP.

    Valor predeterminado: Activo
    Contraseña Especifique la contraseña del firewall.
    Puerto Especifique el puerto para el firewall.

    Valores válidos: de 1 a 65535 inclusive

    Valor predeterminado: 21
    Tipo Especifique el tipo de firewall implementado.

    Valores válidos: Ninguno, Calcetines 4 y Calcetines 5

    Valor predeterminado: Ninguno
    Usuario Especifique el nombre de usuario del firewall.

    FTP

    Usa esto Para
    Cuenta Especifique el nombre de cuenta para el servidor FTP. Esta opción está en desuso y no se recomienda el uso de esta propiedad.
    Después de obtener Especifique los comandos FTP que se ejecutarán después del archivo GET. Separe los comandos con un punto y coma (;).
    Antes de Obtener Especifique los comandos FTP que se van a ejecutar antes del archivo GET. Separe los comandos con un punto y coma (;). Nota: El comando QUIT no se admite antes del archivo GET.
    Umbral de error Especifique el número de errores que BizTalk Server puede encontrar antes de deshabilitar la ubicación.

    Valor predeterminado: 10
    Máscara de archivo Especifique el filtro de máscara de archivo que se va a usar al transmitir archivos.
    Carpeta Especifique la ubicación de sondeo en el servidor FTP.
    Tipo de servidor FTP Nuevo a partir de BizTalk Server 2016.

    Use esta propiedad para elegir un servidor FTP que no requiera el comando SYST. Las opciones son None, AIX, Detect, GXS, MVS, OS400 y Other.

    Si se establece en Ninguno, se usa el comando SYST. Otro se usa cuando el tipo de sistema operativo no se ajusta a ninguna de las categorías especificadas.

    Valor predeterminado: Ninguno
    Registro Especifique la ruta de acceso completa, incluido el nombre del archivo de registro donde se va a generar. Este archivo se usa para diagnosticar condiciones de error al enviar o recibir archivos a través de FTP.
    Tamaño máximo de archivo Especifique el tamaño máximo de archivo descargable, en megabytes.

    Cero (0) no indica ningún límite en el tamaño del archivo.

    Valor predeterminado: 100
    Contraseña Especifique la contraseña de usuario para iniciar sesión en el servidor FTP.
    Puerto Especifique la dirección de puerto para este servidor FTP.

    Valor predeterminado: 21
    representación Seleccione cómo FTP recibe los datos.

    Valores válidos: binarios o ASCII

    Valor predeterminado: binario
    Servidor Especifique el nombre del servidor o la dirección IP del servidor FTP. Nota: El URI de un puerto de envío o una ubicación de recepción no puede superar los 256 caracteres.
    Filial de SSO Especifique la aplicación afiliada de la empresa Single Sign-On.
    Utilizar la lista de nombres (NLST) Especifique cómo el adaptador enumera los archivos. Para ver los nombres de archivo en lugar de la lista de archivos definida por el sistema, establezca este valor en Sí.

    Valor predeterminado: No
    Nombre de usuario Especifique el nombre de usuario para iniciar sesión en el servidor FTP.

    Interrogación

    Usa esto Para
    Eliminar después de la descarga Especifique si el adaptador elimina un archivo del servidor FTP después de descargarlo.

    Valor predeterminado: Sí Nota:
    Habilitar comparación de marca de tiempo Especifique si el adaptador vuelve a descargar un archivo en función de su marca de tiempo modificada. En los casos en los que el adaptador no tiene permisos de eliminación en el servidor FTP, el comando MDTM (hora de modificación) permite al adaptador saber si se ha modificado un archivo desde la última descarga. En función del valor de esta propiedad, el archivo se descarga de nuevo.

    Valor predeterminado: Sin nota: En caso de que el servidor FTP no admita MDTM, establezca la propiedad Redownload Interval . Nota: Esta propiedad solo es aplicable cuando Eliminar después de descargar se establece en No.
    Intervalo Especifique el número de intervalo para sondear esta ubicación. Para sondear continuamente, establezca este valor en cero (0).

    Valor predeterminado: 60
    Intervalo de redescargar Especifique el intervalo después del cual el adaptador vuelve a descargar los archivos. Esta propiedad es aplicable solo cuando tanto Eliminar después de descargar como Habilitar comparación de marca de tiempo se establecen en No.

    Valor predeterminado: -1

    -1 indica que el adaptador no volverá a descargar archivos.

    0 indica que el adaptador descargará el archivo en cada ciclo de sondeo.
    Unidad Especifique el tipo de unidades para las propiedades Interval y Redownload Interval .

    Valores válidos: Segundos, minutos, horas y días

    Valor predeterminado: Segundos

    SSL

    Usa esto Para
    Hash de certificado de cliente Especifique el hash SHA1 del certificado de cliente que se debe usar en la negociación de la Capa de Sockets Seguros (SSL).

    En función de este hash, el certificado de cliente se recoge del almacén personal de la cuenta de usuario en la que se ejecuta la instancia de host de BizTalk.
    Modo de conexión FTPS Especifique el modo de conexión SSL realizada al servidor FTPS.

    Valores válidos: Implícito o explícito

    Valor predeterminado: Explícito
    Uso de la protección de datos Especifique esto como Sí si el adaptador debe usar el cifrado SSL cuando envía y recibe archivos de datos del servidor FTPS. Especifique esto como No para que el adaptador envíe y reciba archivos de datos como texto no cifrado. Nota: Esta propiedad solo es aplicable si la propiedad Use SSL está establecida en Sí.

    Valores válidos: Sí o no

    Valor predeterminado: Sí
    Uso de SSL Especifique si el adaptador ftp debe usar SSL para comunicarse con el servidor FTPS.

    Valores válidos: Sí o no

    Valor predeterminado: No

    Parámetros de optimización

    Usa esto Para
    Tiempo de espera de recepción de datos Especifique la hora en milisegundos antes de que se anule la llamada de recepción. Esta propiedad se utiliza para evitar que un servidor lento provoque que la ubicación de recepción deje de responder.

    Valor predeterminado: 90000
    Carpeta temporal Especifique la ubicación de una carpeta temporal. Esta ubicación se usa para garantizar la recuperación de un error de transferencia.

  5. Haga clic en Aceptar para guardar la configuración.

  6. En el cuadro de diálogo Propiedades de ubicación de recepción, escriba los valores adecuados para completar la configuración de la ubicación de recepción y, a continuación, haga clic en Aceptar para guardar la configuración. Para obtener información sobre el cuadro de diálogo Propiedades de ubicaciones de recepción , vea Cómo crear una ubicación de recepción.

Nota:

No configure varias ubicaciones de recepción de FTP para sondear la misma dirección URL de FTP. Si varias ubicaciones de recepción ftp sondean simultáneamente la misma dirección URL, cada ubicación de recepción puede recibir una copia del archivo, lo que puede provocar la duplicación de datos. Este comportamiento se produce porque el protocolo FTP no tiene ningún aprovisionamiento para bloquear archivos al leerlos desde la dirección URL de destino.

Para proporcionar alta disponibilidad para el adaptador de recepción ftp, debe configurar el adaptador de recepción ftp para que se ejecute en una instancia de host de BizTalk en clúster. Consulte Consideraciones para ejecutar controladores de adaptador dentro de un host en clúster.

Configuración del puerto de envío

Puede establecer las propiedades del adaptador de puerto de envío ftp en la consola de administración de BizTalk Server. Si no se establecen propiedades para el puerto de envío, se usan los valores de controlador de envío predeterminados en la consola de administración de BizTalk Server.

  1. En la consola de administración de BizTalk Server, cree un puerto de envío o haga doble clic en un puerto de envío existente para modificarlo. Consulte How to Create a Send Port (Cómo crear un puerto de envío). Configure todas las opciones de puerto de envío y, en la sección Transporte de la página General , especifique FTP para la opción Tipo .

  2. En la página General , en la sección Transporte , haga clic en el botón Configurar situado junto a Tipo.

  3. En Propiedades de transporte FTP, haga lo siguiente:

    Cortafuegos

    Usa esto Para
    Dirección Especifique la dirección del firewall, ya sea un nombre DNS o una dirección IP.
    Modo Seleccione el modo en el que el adaptador se conecta al servidor FTP.

    Valores válidos: Pasivo y Activo

    En modo activo, el servidor FTP se conecta a un puerto abierto por el adaptador FTP. En modo pasivo, el adaptador FTP se conecta a un puerto abierto por el servidor FTP. Es posible que el modo activo no funcione si usa una dirección IP interna y se conecta a una dirección IP externa. En este caso, debe usar el modo pasivo o el modo activo con una puerta de enlace de capa de aplicación (ALG) con compatibilidad con FTP.

    Valor predeterminado: Activo
    Contraseña Especifique la contraseña del firewall.
    Puerto Especifique el puerto para el firewall.

    Valores válidos: de 1 a 65535 inclusive

    Valor predeterminado: 21
    Tipo Seleccione el tipo de firewall implementado.

    Valores válidos: Calcetines 4, Calcetines 5, Ninguno

    Valor predeterminado: Ninguno
    Usuario Especifique el nombre de usuario del firewall.

    FTP

    Usa esto Para
    Cuenta Opcional. Especifique el nombre de cuenta para el servidor FTP. Se desaconseja esta opción y el uso de esta propiedad.
    Después de colocar Especifique los comandos FTP que se ejecutarán después del archivo PUT. Separe los comandos con un punto y coma (;).
    Asignar almacenamiento Especifique si se va a asignar espacio de almacenamiento para los sistemas host heredados. Esta opción se proporciona para la compatibilidad con versiones anteriores.

    Valores válidos: No y Sí

    Valor predeterminado: No
    Antes de colocar Especifique los comandos FTP que se ejecutarán antes del archivo PUT, como los comandos para cambiar los valores predeterminados en el servidor FTP. Separe los comandos con un punto y coma (;). No se requiere ningún comando abierto. Nota: El comando QUIT no se admite antes del archivo PUT.
    Carpeta Especifique la ubicación a la que mover los archivos en el servidor FTP.
    Tipo de servidor FTP Nuevo a partir de BizTalk Server 2016.

    Use esta propiedad para elegir un servidor FTP que no requiera el comando SYST. Las opciones son None, AIX, Detect, GXS, MVS, OS400 y Other.

    Si se establece en Ninguno, se usa el comando SYST. Otro se usa cuando el tipo de sistema operativo no se ajusta a ninguna de las categorías especificadas.

    Valor predeterminado: Ninguno
    Registro Especifique la ruta de acceso completa, incluido el nombre del archivo de registro donde se va a generar. Use este archivo para diagnosticar condiciones de error al enviar o recibir archivos a través del adaptador ftp.
    Contraseña Especifique la contraseña para iniciar sesión en el servidor FTP.
    Puerto Especifique la dirección de puerto para el servidor FTP.

    Valor predeterminado: 21
    representación Seleccione cómo envía el adaptador ftp los datos, ya sea como binario o como ASCII.

    Valores válidos: binarios o ASCII

    Valor predeterminado: binario
    Servidor Especifique el nombre del servidor o la dirección IP del servidor FTP.
    Filial de SSO Especifique la aplicación afiliada de la empresa Single Sign-On.
    Nombre de archivo de destino Especifique un nombre alternativo para el archivo. Conservar el nombre predeterminado garantiza nombres de mensaje únicos para cada mensaje enviado.

    Valor predeterminado: %MessageID%.xml
    Nombre de usuario Especifique el nombre de usuario para iniciar sesión en el servidor FTP.

    SSL

    Usa esto Para
    Hash de certificado de cliente Especifique el hash SHA1 del certificado de cliente que se debe usar en la negociación de la Capa de Sockets Seguros (SSL).

    En función de este hash, el certificado de cliente se recoge del almacén personal de la cuenta de usuario en la que se ejecuta la instancia de host de BizTalk.
    Modo de conexión FTPS Especifique el modo de conexión SSL realizada al servidor FTPS.

    Valores válidos: Implícito o explícito

    Valor predeterminado: Explícito
    Uso de la protección de datos Especifique esto como Sí si el adaptador debe usar el cifrado SSL cuando envía y recibe archivos de datos del servidor FTPS. Especifique esto como No para que el adaptador envíe y reciba archivos de datos como texto no cifrado. Nota: Esta propiedad solo es aplicable si la propiedad Use SSL está establecida en Sí.

    Valores válidos: Sí o no

    Valor predeterminado: Sí
    Uso de SSL Especifique si el adaptador ftp debe usar SSL para comunicarse con el servidor FTPS.

    Valores válidos: Sí o no

    Valor predeterminado: No

    Parámetros de optimización

    Usa esto Para
    Límite de conexión Especifique el número máximo de conexiones FTP simultáneas que se pueden abrir en el servidor. Un valor de 0 significa que no hay límite.

    Valor predeterminado: 0 Nota: Esta propiedad reemplaza la entrada del Registro que se usó en versiones anteriores de BizTalk Server para controlar el límite de conexión. BizTalk Server omite la entrada del Registro usada para controlar el límite de conexiones.
    Carpeta temporal Especifique la ubicación de una carpeta temporal en el servidor FTP. El archivo se carga primero aquí y, a continuación, se mueve a la carpeta FTP de destino. En caso de error de transferencia, el adaptador reinicia la carga de archivos en modo de transferencia ASCII y la reanuda en modo de transferencia binario. Nota: Si la transferencia de archivos es atómica entre la ubicación temporal y la ubicación pertinente en el servidor FTP, la carga de archivos también es atómica.

  4. Haga clic en Aceptar y vuelva a aceptar para guardar la configuración.

Comandos FTP requeridos por el adaptador de FTP

El adaptador ftp está sujeto a las limitaciones del protocolo FTP y requiere que determinados comandos FTP estén disponibles en el servidor FTP de origen o destino.

El adaptador FTP funciona como un cliente FTP y puede requerir que los siguientes comandos estén disponibles en el servidor FTP para funcionar correctamente:

Comando Requerido por Receive Necesario para Enviar
SYST ✔

Opcional a partir de BizTalk Server 2016		 ✔

Opcional a partir de BizTalk Server 2016
TIENDA ✔
RETR ✔
USUARIO ✔ ✔
PASAR ✔ ✔
Enfermedad Crónica Desgastante (CWD) ✔ ✔
SALIR ✔ ✔
PUERTO ✔ ✔
PASV ✔ ✔
ABOR ✔ ✔
TIPO ✔ ✔
RNFR ✔ ✔
RNTO ✔ ✔
DELE ✔ ✔
PWD ✔ ✔
LISTA ✔ ✔
NLST ✔ ✔
NOOP ✔ ✔
APPE ✔
ALLO ✔ ✔
MDTM ✔
Autenticación TLS ✔ ✔
PBSZ ✔ ✔
PROT ✔ ✔

Para obtener más información sobre estos comandos FTP, consulte:

Configuración de un adaptador FTP para trabajar con hosts heredados

En estas secciones se aborda lo que necesita saber para facilitar la comunicación entre el adaptador FTP y un equipo central.

Nota:

No puede usar la función de carpeta temporal al enviar archivos a un host MVS o AS400. No se admite la entrada en este campo y provocará errores.

Importante

La siguiente información se proporciona como guía y no debe sustituirse por la información que se encuentra en la documentación de AS400 o IBM.

MVS

Para enviar archivos a un servidor FTP en un sistema central, el sistema central debe admitir IBM Generation Data Group (GDG). En el campo nombre, cada nombre de archivo anexará un (+1) al nombre del archivo de destino (una ruta de acceso completa con comillas alrededor de él).

AS400

Hay tres métodos de nomenclatura de archivos y la definición de sus rutas de acceso al transferir archivos hacia y desde un sistema AS400:

  • Campo Nombre de archivo: al enviar un archivo a un servidor FTP, escriba el nombre de archivo en el campo Nombre de archivo. El nombre de archivo debe cumplir las convenciones de nomenclatura de archivos del sistema AS400 porque el archivo se almacenará en el sistema de archivos de biblioteca.

  • Comando Quote: use el comando Quote para ejecutar un script en el equipo remoto. Escriba el comando Quote en los campos Before GET, Before PUT, After GET y After PUT en cualquiera de los puntos de conexión. Escriba el comando Quote en el formato siguiente:

    QUOTE RCMD <command to be run on the remote system>.

  • Sistema de archivos integrado (IFS): IFS es un área en el sistema AS400 que permite el almacenamiento de archivos basados en PC y, por tanto, las mismas convenciones de nomenclatura que un equipo. Para usar ifS en lugar del sistema de archivos de biblioteca predeterminado, el primer comando que se va a escribir es quote site namefmt 1. Este comando indica al sistema AS400 que use la convención de nomenclatura IFS.

Más cosas buenas

Esquema de propiedades y propiedades del adaptador de FTP

Procedimientos recomendados y recomendaciones para el adaptador ftp

Adaptador ftp