Conexión a servidores FTP desde flujos de trabajo en Azure Logic Apps

Se aplica a: Azure Logic Apps (consumo + estándar)

En este artículo se muestra cómo acceder al servidor del protocolo de transferencia de archivos (FTP) desde un flujo de trabajo en Azure Logic Apps con el conector FTP. Puede crear flujos de trabajo automatizados que se ejecuten cuando se desencadenen mediante eventos en el servidor FTP o en otros sistemas y ejecutar acciones para administrar archivos en el servidor FTP.

Por ejemplo, el flujo de trabajo puede empezar con un desencadenador FTP que supervisa y responde a eventos en el servidor FTP. El desencadenador hace que las salidas estén disponibles para las acciones del flujo de trabajo. El flujo de trabajo puede ejecutar acciones ftp que creen, envíen, reciban y administren archivos a través de la cuenta del servidor FTP mediante las siguientes tareas específicas:

• Supervisar cuándo se agregan o cambian archivos
• Crear, copiar, eliminar, enumerar y actualizar archivos.
• Obtener metadatos de archivo y contenido.
• Administrar carpetas.

Si no está familiarizado con Azure Logic Apps, consulte la siguiente documentación:

• ¿Qué es Azure Logic Apps?
• Inicio rápido: crear un flujo de trabajo de aplicación lógica de consumo de ejemplo

Referencia técnica del conector

El conector FTP tiene diferentes versiones, en función del tipo de aplicación lógica y del entorno de host.

Limitaciones

• Capacidad y rendimiento

  • Conector integrado para flujos de trabajo estándar:

    De forma predeterminada, las acciones de FTP pueden leer o escribir archivos con un tamaño de 200 MB o menos. Actualmente, el conector integrado FTP no admite la fragmentación.

  • Conector administrado para flujos de trabajo estándar y consumo

    De forma predeterminada, las acciones de FTP pueden leer o escribir archivos con un tamaño de 50 MB o menos. Para procesar archivos mayores de 50 MB, las acciones de FTP admiten la fragmentación de mensajes. La acción Obtener contenido de archivo usa implícitamente la fragmentación.

• Los desencadenadores para el conector administrado por FTP o hospedado en Azure pueden experimentar resultados ausentes, incompletos o retrasados cuando se conserva la marca de tiempo de último cambio. Por otro lado, el desencadenador del conector integrado FTP en los flujos de trabajo de la aplicación lógica estándar no tiene esta limitación. Para más información, consulte Limitaciones del conector FTP.

• El conector administrado por FTP puede crear un número limitado de conexiones al servidor FTP. El límite se basa en la capacidad de conexión en la región de Azure donde existe el recurso de la aplicación lógica. Si este límite supone un problema en un flujo de trabajo de aplicación lógica de consumo, cree un flujo de trabajo de aplicación lógica estándar que use el conector integrado ftp.

• Tanto el conector FTP integrado como el administrado solo admiten FTP explícito a través de FTPS, que es una extensión de TLS. Ninguna versión del conector admite FTPS implícito.

Requisitos previos

• Una cuenta y una suscripción de Azure. Si no tiene una suscripción de Azure, regístrese para obtener una cuenta gratuita de Azure.

• El flujo de trabajo de la aplicación lógica desde donde quiere acceder a la cuenta de FTP. Para iniciar el flujo de trabajo mediante un desencadenador de FTP, deberá empezar con un flujo de trabajo en blanco. Para usar una acción FTP, inicie el flujo de trabajo con otro desencadenador, como el desencadenador Recurrence.

• Para obtener más requisitos que se aplican al conector administrado por FTP y al conector integrado, consulte la referencia del conector administrado por FTP: Requisitos.

Problemas conocidos

De forma predeterminada, los desencadenadores que aceptan y devuelven matrices suelen tener un valor Split on que ya está habilitado. El desencadenador desagrupa automáticamente una matriz mediante la creación interna de una instancia de flujo de trabajo independiente para procesar cada elemento de matriz. Todas las instancias de flujo de trabajo se ejecutan en paralelo para que los elementos de matriz se procesen al mismo tiempo.

Con la opción Dividir en habilitada, los desencadenantes del conector administrado devuelven las salidas de todos los elementos de la matriz como listas. Las acciones posteriores que hagan referencia a estas salidas deben controlar primero estas salidas como listas. Para controlar cada elemento de matriz individualmente, puede agregar acciones adicionales. Por ejemplo, para recorrer en iteración estos elementos de matriz, puede usar un bucle For each. En el caso de los desencadenadores que devuelven solo metadatos o propiedades, use una acción que obtenga primero los metadatos del elemento de matriz y, a continuación, use una acción para obtener el contenido de los elementos.

Debe aplicar este enfoque solo para los desencadenadores de conector administrados, y no para los desencadenadores de conector integrados que devuelven salidas de un elemento de matriz a la vez cuando la opción Dividir en elementos está habilitada.

Por ejemplo, supongamos que tiene un desencadenador de conector administrado denominado Cuando se agrega o modifica un archivo (solo propiedades) que devuelve los metadatos o propiedades de los archivos nuevos o actualizados como matrices. Para obtener los metadatos por separado para cada archivo, puede usar un bucle For each que recorre en iteración la matriz. En este bucle, use las siguientes acciones del conector administrado en el orden especificado:

1. Obtenga metadatos de archivo para obtener los metadatos de cada archivo.

2. Obtenga la acción de contenido del archivo para obtener el contenido de cada archivo.

Agregar un desencadenador FTP

Un flujo de trabajo de aplicación lógica de consumo solo puede usar el conector administrado por FTP. Sin embargo, un flujo de trabajo de aplicación lógica estándar puede usar el conector administrado por FTP y el conector integrado FTP.

El conector administrado por FTP y el conector integrado tienen solo un desencadenador disponible:

• Desencadenador de conector administrado: el desencadenador FTP denominado Cuando se agrega o modifica un archivo (solo propiedades) ejecuta un flujo de trabajo de aplicación lógica de consumo o estándar cuando uno o varios archivos se agregan o cambian en una carpeta del servidor FTP. Este desencadenador solo obtiene las propiedades o metadatos del archivo, no el contenido del archivo. Para obtener el contenido del archivo, el flujo de trabajo puede seguir este desencadenador con otras acciones de FTP.

  Para obtener más información, vea Cuando se agrega o modifica un archivo (solo propiedades).

• Desencadenador de conector integrado: el desencadenador FTP denominado Cuando se agrega o actualiza un archivo ejecuta un flujo de trabajo de aplicación lógica estándar cuando uno o varios archivos se agregan o cambian en una carpeta del servidor FTP. Este desencadenador solo obtiene las propiedades o metadatos del archivo, no el contenido del archivo. Para obtener el contenido, el flujo de trabajo puede seguir este desencadenador con otras acciones de FTP. Para obtener más información, consulte Cuándo se agrega o actualiza un archivo.

Los procedimientos siguientes usan Azure Portal. Con la extensión de Azure Logic Apps correspondiente para aplicaciones lógicas de consumo o estándar, puede usar las siguientes herramientas en su lugar para crear y editar flujos de trabajo de aplicaciones lógicas:

• Flujos de trabajo de aplicaciones lógicas de consumo: Visual Studio Code
• Flujos de trabajo de aplicaciones lógicas estándar: Visual Studio Code

En esta sección se muestran los pasos para los siguientes desencadenadores del conector FTP:

• Desencadenador integrado denominado Cuando se agrega o actualiza un archivo

  Si usa este desencadenador integrado ftp, puede obtener el contenido del archivo mediante la acción integrada FTP denominada Obtener contenido del archivo sin usar primero la acción Obtener metadatos del archivo , a diferencia de cuando se usa el desencadenador administrado por FTP. Para obtener más información sobre las operaciones del conector integrado ftp, consulte Operaciones de conector integradas de FTP.

  Este desencadenador FTP integrado no está disponible para flujos de trabajo de aplicaciones lógicas de consumo.

• Administración del desencadenante denominado Cuando un archivo se agrega o modifica (solo propiedades)

  Si usa este desencadenador administrado por FTP, debe usar la acción Obtener metadatos de archivo para obtener un solo elemento de matriz antes de usar cualquier otra acción en el archivo que se agregó o modificó. Esta solución alternativa resulta del problema conocido en torno a la configuración Split On descrita anteriormente en este artículo.

Agregar desencadenador de conector integrado

Para agregar un desencadenador de conector integrado a un flujo de trabajo estándar:

1. En el portal de Azure, abra su recurso de aplicación lógica.

2. En el menú de la barra lateral de recursos, en Flujos de trabajo, seleccione Flujos de trabajo, y luego seleccione su flujo de trabajo vacío, el cual se abrirá en el diseñador.

3. En el diseñador, seleccione Agregar un desencadenador.

4. Siga los pasos generales para agregar el desencadenador FTP Cuando se agrega o actualiza un archivo (versión preliminar).

5. Proporcione la información de la conexión. Cuando haya terminado, seleccione Crear nuevo.

   

   Nota:

   De forma predeterminada, este conector transfiere los archivos en formato de texto. Para transferir archivos en formato binario, por ejemplo, cuando se use la codificación, seleccione la opción "transporte binario".

6. Una vez que aparezca el panel de información del desencadenador, en el cuadro Ruta de acceso de carpeta, especifique la ruta de acceso a la carpeta que desea supervisar.

   

7. Cuando haya terminado, guarde el flujo de trabajo.

Al guardar el flujo de trabajo, Azure publica las actualizaciones en la aplicación lógica implementada y activa en Azure. Con solo un desencadenador, el flujo de trabajo solo comprueba el servidor FTP en función de la programación especificada. Debe agregar una acción que responda al desencadenador y haga algo con los resultados del desencadenador, como se describe en secciones posteriores.

Agregar desencadenador de conector administrado

Para agregar un desencadenador de conector administrado a un flujo de trabajo de consumo o estándar:

1. En Azure Portal, busque y abra el recurso de aplicación lógica.

2. En función de si tiene una aplicación lógica de consumo o estándar:

   • Consumo: en el menú de la barra lateral del recurso, en Herramientas de desarrollo, seleccione el diseñador para abrir el flujo de trabajo.

   • Estándar: en el menú de la barra lateral del recurso, en Flujos de trabajo, seleccione Flujos de trabajo. Seleccione el flujo de trabajo en blanco, que se abre en el diseñador.

3. En el diseñador de flujos de trabajo, seleccione Agregar un desencadenador.

4. Siga los pasos generales para agregar el desencadenador FTP Cuando se agrega o modifica un archivo (solo propiedades).

5. Proporcione la información de la conexión. Cuando haya terminado, seleccione Crear nuevo.

   

   Nota:

   De forma predeterminada, este conector transfiere los archivos en formato de texto. Para transferir archivos en formato binario, por ejemplo, cuando se use la codificación, seleccione la opción "transporte binario".

6. Cuando se abra el panel de información del desencadenador, busque la carpeta que desea supervisar para los archivos nuevos o editados.

   1. En el cuadro Carpeta, seleccione el icono de carpeta para ver el directorio de carpetas.

   2. Seleccione la flecha derecha (>). Busque la carpeta que desee y selecciónela.

   

   La carpeta seleccionada aparece en el cuadro Carpeta.

   

7. Cuando haya terminado, guarde el flujo de trabajo.

Al guardar el flujo de trabajo, Azure publica las actualizaciones en la aplicación lógica implementada y activa. Con solo un desencadenador, el flujo de trabajo solo comprueba el servidor FTP en función de la programación especificada. Debe agregar una acción que responda al desencadenador y haga algo con las salidas del desencadenador, como se describe en las secciones posteriores.

Agregar una acción de FTP

Un flujo de trabajo de aplicación lógica de consumo solo puede usar el conector administrado por FTP. Un flujo de trabajo de aplicación lógica estándar puede usar el conector administrado por FTP y el conector integrado ftp. Cada versión tiene varias acciones. Por ejemplo, las versiones de conectores administradas y integradas tienen sus propias acciones para obtener metadatos de archivo y obtener contenido de archivo.

• Acciones del conector integradas: estas acciones solo se ejecutan en un flujo de trabajo de aplicación lógica estándar.
• Acciones del conector administrado: estas acciones se ejecutan en un flujo de trabajo de aplicación lógica estándar o consumo.

Los procedimientos siguientes usan Azure Portal. Con la extensión de Azure Logic Apps correspondiente para Consumo o Estándar, puede usar las siguientes herramientas en su lugar para crear y editar flujos de trabajo de aplicaciones lógicas:

• Flujos de trabajo de Consumo: Visual Studio Code
• Flujos de trabajo estándar: Visual Studio Code

Para poder usar una acción FTP, el flujo de trabajo ya debe empezar con un desencadenador, que puede ser cualquier tipo que elija. Por ejemplo, puede usar el desencadenador integrado periodicidad genérico para iniciar el flujo de trabajo según una programación específica.

Los pasos para agregar y usar una acción FTP difieren en función de si el flujo de trabajo usa el conector integrado o el conector administrado.

• Flujos de trabajo de desencadenadores integrados: describe los pasos para agregar una acción integrada a un flujo de trabajo que comienza con un desencadenador integrado.

  Si utilizó el desencadenador FTP incorporado y desea obtener el contenido de un archivo recién agregado o actualizado, puede usar un bucle For each para iterar sobre la matriz devuelta por el desencadenador. A continuación, puede usar solo la acción Obtener contenido del archivo sin ninguna otra acción intermedia. Para obtener más información sobre las operaciones del conector integrado ftp, consulte Operaciones de conector integradas de FTP.

• Flujos de trabajo de desencadenador administrado: describe los pasos para agregar una acción administrada a un flujo de trabajo que comienza con un desencadenador administrado.

  Si ha usado el desencadenador del conector FTP administrado y quiere obtener el contenido de un archivo recién agregado o modificado, puede usar un bucle For each para recorrer la matriz devuelta por el desencadenador. A continuación, debe usar acciones intermedias, como la acción FTP denominada Obtener metadatos de archivo antes de usar la acción Obtener contenido del archivo.

Flujos de trabajo con un desencadenador integrado

Para agregar acciones a un flujo de trabajo estándar que comience con un desencadenador de conector integrado:

1. En Azure Portal, busque y abra el recurso de aplicación lógica.

2. En el menú de la barra lateral de recursos, bajo Flujos de trabajo, seleccione Flujos de trabajo. Seleccione el flujo de trabajo con el activador integrado FTP.

3. En el diseñador, siga estos pasos generales para agregar la acción FTP denominada Obtener contenido de archivo al flujo de trabajo.

4. Si es necesario, proporcione la información de la conexión. Cuando haya terminado, seleccione Crear nuevo.

   

   Nota:

   De forma predeterminada, este conector transfiere los archivos en formato de texto. Para transferir archivos en formato binario, por ejemplo, cuando se use la codificación, seleccione la opción "transporte binario".

5. En el panel de información de acción que se abre, seleccione dentro de ruta de archivo para mostrar las opciones de entrada. Seleccione el icono del rayo para abrir la lista de contenido dinámico.

   Ya puede seleccionar salidas del desencadenador anterior.

6. En la lista de contenido dinámico, en Cuando se agrega o actualiza un archivo, seleccione Ruta de acceso del archivo.

   

   La propiedad Ruta de acceso del archivo ahora hace referencia a la salida del desencadenador ruta de acceso de archivo.

   

7. Agregue cualquier otra acción que necesite su flujo de trabajo.

8. Cuando haya terminado, guarde el flujo de trabajo. En la barra de herramientas del diseñador, seleccione Save (Guardar).

Flujos de trabajo con un desencadenador administrado

Para agregar acciones a un flujo de trabajo de Consumo o Estándar que comience con un disparador de conector administrado:

1. En Azure Portal, busque y abra el recurso de aplicación lógica.

2. En función de si tiene una aplicación lógica de consumo o estándar:

   • Consumo: en el menú de la barra lateral del recurso, en Herramientas de desarrollo, seleccione el diseñador para abrir el flujo de trabajo.

   • Estándar: en el menú de la barra lateral del recurso, en Flujos de trabajo, seleccione Flujos de trabajo. Seleccione el flujo de trabajo que comienza con el desencadenador del conector administrado por FTP. En el menú de la barra lateral del flujo de trabajo, seleccione el diseñador para abrir el flujo de trabajo.

3. En el diseñador, siga estos pasos generales para agregar la acción FTP denominada Obtener metadatos de archivo al flujo de trabajo.

4. Si es necesario, proporcione la información de la conexión. Cuando haya terminado, seleccione Crear nuevo.

   

   Nota:

   De forma predeterminada, este conector transfiere los archivos en formato de texto. Para transferir archivos en formato binario, por ejemplo, cuando se use la codificación, seleccione la opción "transporte binario".

5. En el panel de información de acción que se abre, seleccione en Archivo para ver las opciones de entrada. Seleccione el icono del rayo para abrir la lista de contenido dinámico.

   Ya puede seleccionar salidas del desencadenador anterior.

6. En la lista de contenido dinámico, en Cuando un archivo se agrega o modifica (solo propiedades), seleccione Lista de archivos Id.

   

   La propiedad File ahora hace referencia a la salida del desencadenador Lista de Archivos Id.

   

7. En el diseñador, siga estos pasos generales para agregar la acción FTP denominada Obtener contenido de archivo al flujo de trabajo.

8. En el panel de información de acción que aparece, seleccione dentro de Archivo para mostrar las opciones de entrada. Seleccione el icono del rayo para abrir la lista de contenido dinámico.

   Ya puede seleccionar salidas del desencadenador o las acciones anteriores.

9. En la lista de contenido dinámico, en Obtener metadatos de archivo, seleccione Id.

   

   La propiedad File ahora hace referencia a la salida de la acción Id.

   

10. Agregue cualquier otra acción que necesite su flujo de trabajo.

11. Cuando haya terminado, guarde el flujo de trabajo. En la barra de herramientas del diseñador, seleccione Save (Guardar).

Pruebe el flujo de trabajo

Para comprobar que el flujo de trabajo devuelve el contenido que espera, agregue otra acción que envíe el contenido del archivo agregado o actualizado. En este ejemplo se usa la acción de Office 365 Outlook denominada Enviar un correo electrónico.

Flujo de trabajo con desencadenador y acciones integrados

Para agregar una acción de Office 365 Outlook al flujo de trabajo Estándar:

1. En el diseñador, en la acción Obtener contenido del archivo , siga estos pasos generales para agregar la acción denominada Enviar un correo electrónico al flujo de trabajo.

   Si en cambio tiene una cuenta de Outlook.com, agregue la acción de Outlook.com Enviar un correo electrónico.

2. Si es necesario, inicie sesión en su cuenta de correo electrónico.

3. En el panel de información de acciones, proporcione los valores necesarios e incluya los demás parámetros o propiedades que quiera probar.

   Por ejemplo, puede incluir la salida de contenido archivo de la acción Obtener contenido del archivo. Para encontrar esta salida, siga estos pasos:

   1. En la acción Obtener contenido del archivo , seleccione dentro del cuerpo para mostrar las opciones de entrada. Seleccione el icono del rayo para abrir la lista de contenido dinámico. En esta lista, en Obtener contenido de archivo, seleccione Contenido del archivo.

      

   2. En la lista de contenido dinámico, en Obtener contenido de archivo, seleccione Contenido de archivo.

      La propiedad Body contiene ahora la salida de la acción Contenido del archivo .

      

4. Guarde el flujo de trabajo.

Para ejecutar y desencadenar el flujo de trabajo, siga estos pasos:

1. En la barra de herramientas del diseñador, seleccione Ejecutar>Ejecutar.

2. Agregue un archivo a la carpeta FTP que el flujo de trabajo supervisa.

Flujo de trabajo con desencadenador y acciones administrados

Para agregar una acción de Office 365 Outlook al flujo de trabajo Consumo o Estándar:

1. En el diseñador, en la acción Obtener contenido del archivo , siga estos pasos generales para agregar la acción denominada Enviar un correo electrónico al flujo de trabajo.

   Si en cambio tiene una cuenta de Outlook.com, agregue la acción de Outlook.com Enviar un correo electrónico.

2. Si es necesario, inicie sesión en su cuenta de correo electrónico.

3. En el cuadro de información de acción, proporcione los valores necesarios e incluya los demás parámetros o propiedades que quiera probar.

   Por ejemplo, puede incluir la salida de contenido archivo de la acción Obtener contenido del archivo. Para encontrar esta salida, siga estos pasos:

   1. En la acción Obtener contenido del archivo , seleccione dentro del cuadro Cuerpo para mostrar las opciones de entrada. Seleccione el icono del rayo para abrir la lista de contenido dinámico. En esta lista, en Obtener contenido de archivo, seleccione Contenido del archivo.

      

   2. En la lista de contenido dinámico, en Obtener contenido de archivo, seleccione Contenido de archivo.

      La propiedad Body contiene ahora la salida de la acción Contenido del archivo .

      

4. Guarde el flujo de trabajo de la aplicación lógica.

Para ejecutar y desencadenar el flujo de trabajo, siga estos pasos:

1. En la barra de herramientas del diseñador, seleccione Ejecutar>Ejecutar.

2. Agregue un archivo a la carpeta FTP que el flujo de trabajo supervisa.

Contenido relacionado

• Desencadenadores y acciones integrados para Logic Apps
• Conectores integrados para Azure Logic Apps
• ¿Qué son los conectores en Azure Logic Apps?