Conectar a los sistemas de archivos locales desde los flujos de trabajo en Azure Logic Apps
Se aplica a: Azure Logic Apps (consumo + estándar)
En esta guía paso a paso se explica cómo se puede acceder a un recurso compartido de archivos en un entorno local desde un flujo de trabajo en Azure Logic Apps mediante el conector del sistema de archivos. Después, puede crear flujos de trabajo automatizados que se ejecutan cuando eventos los desencadenan en el recurso compartido de archivos o en otros sistemas y ejecutar acciones para administrar los archivos. El conector ofrece las capacidades siguientes:
- Crear, obtener, anexar, actualizar y eliminar archivos.
- Enumerar archivos en carpetas o carpetas raíz.
- Obtener contenido de archivos y metadatos
En esta guía práctica, los escenarios de ejemplo muestran las siguientes tareas:
- Desencadenar un flujo de trabajo al crearse o agregarse un archivo a un recurso compartido de archivos y, a continuación, enviar un correo electrónico.
- Desencadenar un flujo de trabajo al copiar un archivo de una cuenta de Dropbox en un recurso compartido de archivos y, a continuación, enviar un correo electrónico.
Limitaciones y problemas conocidos
- El conector del sistema de archivos solo admite actualmente sistemas de archivos de Windows en sistemas operativos Windows.
- Las unidades de red mapeadas no son compatibles.
Referencia técnica del conector
El conector del sistema de archivos tiene diferentes versiones, en función del tipo de aplicación lógica y del entorno del host.
| Aplicación lógica | Entorno | Versión del conector |
|---|---|---|
| Consumo | Azure Logic Apps multiinquilino | El conector administrado, que aparece en el diseñador con la etiqueta Estándar. Para obtener más información, revise la siguiente documentación: - Referencia del conector administrado del sistema de archivos - Conectores administrados en Azure Logic Apps |
| Consumo | Entorno del servicio de integración (ISE) | Conector administrado, que aparece en el diseñador con la etiqueta Estándar y la versión de ISE, que tiene distintos límites de mensaje que la clase Estándar. Para obtener más información, revise la siguiente documentación: - Referencia del conector administrado del sistema de archivos - Límites de mensajes ISE - Conectores administrados en Azure Logic Apps |
| Estándar | Azure Logic Apps de inquilino único y App Service Environment v3 (solo planes de Windows) | El conector administrado, que aparece en la galería de conectores en Runtime>Compartido y el conector integrado, que aparece en la galería de conectores en Runtime>En la aplicación y se basa en el proveedor de servicios. El conector integrado difiere de las siguientes maneras: - El conector integrado solo admite aplicaciones lógicas estándar que se ejecutan en la versión 3 de App Service Environment únicamente con planes de Windows. - La versión integrada puede conectarse directamente a un recurso compartido de archivos y acceder a redes virtuales de Azure mediante una cadena de conexión sin una puerta de enlace de datos local. Para obtener más información, revise la siguiente documentación: - Referencia del conector administrado del sistema de archivos - Referencia del conector integrado del sistema de archivos - Conectores integrados en Azure Logic Apps |
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.
Para conectarse al recurso compartido de archivos, se aplican requisitos diferentes en función de la aplicación lógica y del entorno de hospedaje:
Flujos de trabajo de aplicaciones lógicas basados en consumo
En la modalidad multiinquilino de Azure Logic Apps deben cumplirse los siguientes requisitos, si aún no se ha hecho:
Instalar la puerta de enlace de datos local en un equipo local.
El conector administrado del sistema de archivos requiere que la instalación de la puerta de enlace y el servidor del sistema existan en el mismo dominio de Windows.
Crear un recurso de puerta de enlace de datos local en Azure.
Después de agregar una acción o un desencadenador del conector administrado del sistema de archivos al flujo de trabajo, seleccione el recurso de puerta de enlace de datos que creó anteriormente para poder conectarse al sistema de archivos.
En un ISE, no se necesita la puerta de enlace de datos local. En su lugar, se puede usar el conector del sistema de archivos con versión ISE.
Flujos de trabajo estándar de aplicaciones lógicas
Puede usar el conector integrado del sistema de archivos o el conector administrado.
Para usar el conector administrado del sistema de archivos, se tienen que cumplir los mismos requisitos que para los flujos de trabajo de aplicaciones lógicas de consumo en la modalidad multiinquilino de Azure Logic Apps.
Para usar el conector integrado del sistema de archivos, el flujo de trabajo de la aplicación lógica estándar se debe ejecutar en la versión 3 de App Service Environment, pero el recurso de la puerta de enlace de datos no es necesario.
Acceda al equipo que tiene el sistema de archivos que quiere usar. Por ejemplo, si instala la puerta de enlace de datos en el mismo equipo que el sistema de archivos, necesita las credenciales de la cuenta para ese equipo.
Para seguir el escenario de ejemplo de esta guía paso a paso, necesita una cuenta de correo electrónico de un proveedor compatible con Azure Logic Apps, como Office 365 Outlook, Outlook.com o Gmail. Para otros proveedores, consulte otros conectores de correo electrónico admitidos. Este ejemplo usa el conector de Office 365 Outlook con una cuenta profesional o educativa. Si usa otra cuenta de correo electrónico, los pasos generales serán los mismos, pero su interfaz de usuario puede ser ligeramente distinta.
Importante
Si quiere usar el conector de Gmail, solo las cuentas empresariales de G-Suite pueden usar este conector sin restricciones en las aplicaciones lógicas. Si tiene una cuenta de consumidor de Gmail, puede usar este conector solo con servicios específicos aprobados por Google, o puede crear una aplicación cliente de Google para usarla en la autenticación con el conector de Gmail. Para más información, consulte Directivas de privacidad y seguridad de datos de los conectores de Google en Azure Logic Apps.
Para el escenario de acción del sistema de archivos de ejemplo, necesita una cuenta de Dropbox, que puede obtener de forma gratuita.
El flujo de trabajo de la aplicación lógica desde donde quiere acceder al recurso compartido de archivos. Para iniciar el flujo de trabajo mediante un desencadenador del sistema de archivos, deberá empezar con un flujo de trabajo en blanco. Para agregar una acción del sistema de archivos, inicie el flujo de trabajo con cualquier desencadenador.
Adición de un desencadenador del sistema de archivos
Abra el flujo de trabajo vacío de la aplicación lógica en el diseñador de Azure Portal.
En el diseñador, siga estos pasos generales para agregar el activador del Sistema de archivos que desee a su flujo de trabajo.
Para más información, consulte Activadores del sistema de archivos. En este ejemplo, se seleccionará el desencadenador denominado Cuando se crea un archivo.
En el cuadro de información de conexión, proporcione la información siguiente según se requiera:
Propiedad Necesario Valor Descripción Nombre de la conexión Sí <connection-name> El nombre que usar para su conexión Carpeta raíz Sí <root-folder-name> Carpeta raíz del sistema de archivos, que suele ser la carpeta principal y es la que se usa para las rutas de acceso relativas con todos los desencadenadores que funcionan en los archivos.
Por ejemplo, si instaló la puerta de enlace de datos local, use la carpeta local en el equipo con la instalación de la puerta de enlace de datos. O bien, use la carpeta para el recurso compartido de red donde el equipo pueda acceder a ella, por ejemplo,\\PublicShare\\MyFileSystem.Tipo de autenticación No <auth-type> Tipo de autenticación que usa el servidor del sistema de archivos, que es Windows. Nombre de usuario Sí <dominio y nombre de usuario> Dominio y nombre de usuario para el equipo donde tiene el sistema de archivos.
Para el conector del sistema de archivos administrado, use uno de los siguientes valores con la barra diagonal inversa (\):
- <dominio>\<nombre de usuario>
- <equipo local>\<nombre de usuario>
Por ejemplo, si la carpeta del sistema de archivos se encuentra en el mismo equipo que la instalación de la puerta de enlace de datos local, puede usar <equipo local>\<nombre de usuario>.
- Para el conector del sistema de archivos basado en ISE, use la barra diagonal en su lugar (/):
- <dominio>/<nombre de usuario>
- <equipo local>/<nombre de usuario>Contraseña Sí <contraseña> La contraseña para el equipo donde tiene el sistema de archivos puerta de enlace No - <Azure-subscription>
- <nombre del recurso de puerta de enlace>Esta sección solo se aplica al conector del sistema de archivos administrado:
- Suscripción: la suscripción de Azure asociada al recurso de puerta de enlace de datos
- Puerta de enlace de conexión: recurso de puerta de enlace de datos.En el ejemplo siguiente se muestra la información de conexión del desencadenador del conector administrado del sistema de archivos:
En el ejemplo siguiente se muestra la información de conexión del desencadenador del sistema basado en ISE del sistema de archivos:
Seleccione Crear cuando haya terminado.
Azure Logic Apps crea y comprueba la conexión para asegurarse de que funciona correctamente. Si la conexión está configurada correctamente, aparecerán las opciones de configuración para el desencadenador seleccionado.
Siga creando el flujo de trabajo.
Proporcione la información necesaria para el desencadenador.
En este ejemplo, seleccione la ruta de acceso de la carpeta en el servidor del sistema de archivos para comprobar si se acaba de crear algún archivo. Especifique el número de archivos que devolverán y la frecuencia con la que se realizará la comprobación.
Para probar el flujo de trabajo, agregue una acción de Outlook que le envíe un correo electrónico cuando se cree un archivo en el sistema de archivos de la carpeta especificada. Escriba los destinatarios, el asunto y el cuerpo del correo electrónico. Para realizar pruebas, puede usar su propia dirección de correo electrónico.
Sugerencia
Para agregar salidas de pasos anteriores en el flujo de trabajo, seleccione dentro de los cuadros de edición del activador. Cuando aparezca la lista de contenido dinámico, seleccione entre las salidas disponibles.
Cuando haya terminado, guarde el flujo de trabajo.
Para probar su flujo de trabajo, cargue un archivo que active el flujo de trabajo.
Si se ejecuta correctamente, el flujo de trabajo envía un correo electrónico sobre el nuevo archivo.
Adición de una acción del sistema de archivos
El flujo de trabajo de la aplicación lógica de ejemplo se inicia con el desencadenador de Dropbox, pero puede usar el desencadenador que quiera.
En Azure Portal abra el flujo de trabajo de la aplicación lógica en el diseñador.
En el diseñador, siga estos pasos generales para agregar la acción Sistema de archivos que desee a su flujo de trabajo.
Para más información, consulte Activadores del sistema de archivos. En este ejemplo, se selecciona la acción denominada Crear archivo.
En el cuadro de información de conexión, proporcione la información siguiente según se requiera:
Propiedad Necesario Valor Descripción Nombre de la conexión Sí <connection-name> El nombre que usar para su conexión Carpeta raíz Sí <root-folder-name> Carpeta raíz del sistema de archivos, que suele ser la carpeta principal y es la que se usa para las rutas de acceso relativas con todos los desencadenadores que funcionan en los archivos.
Por ejemplo, si instaló la puerta de enlace de datos local, use la carpeta local en el equipo con la instalación de la puerta de enlace de datos. O bien, use la carpeta para el recurso compartido de red donde el equipo pueda acceder a ella, por ejemplo,\\PublicShare\\MyFileSystem.Tipo de autenticación No <auth-type> Tipo de autenticación que usa el servidor del sistema de archivos, que es Windows. Nombre de usuario Sí <dominio y nombre de usuario> Dominio y nombre de usuario para el equipo donde tiene el sistema de archivos.
Para el conector del sistema de archivos administrado, use uno de los siguientes valores con la barra diagonal inversa (\):
- <dominio>\<nombre de usuario>
- <equipo local>\<nombre de usuario>
Por ejemplo, si la carpeta del sistema de archivos se encuentra en el mismo equipo que la instalación de la puerta de enlace de datos local, puede usar <equipo local>\<nombre de usuario>.
- Para el conector del sistema de archivos basado en ISE, use la barra diagonal en su lugar (/):
- <dominio>/<nombre de usuario>
- <equipo local>/<nombre de usuario>Contraseña Sí <contraseña> La contraseña para el equipo donde tiene el sistema de archivos puerta de enlace No - <Azure-subscription>
- <nombre del recurso de puerta de enlace>Esta sección solo se aplica al conector del sistema de archivos administrado:
- Suscripción: la suscripción de Azure asociada al recurso de puerta de enlace de datos
- Puerta de enlace de conexión: recurso de puerta de enlace de datos.En el ejemplo siguiente se muestra la información de conexión de la acción del conector administrado del sistema de archivos:
En el ejemplo siguiente se muestra la información de conexión de la acción del conector basado en ISE del sistema de archivos:
Seleccione Crear cuando haya terminado.
Azure Logic Apps crea y comprueba la conexión para asegurarse de que funciona correctamente. Si la conexión está configurada correctamente, aparecerán las opciones de configuración para la acción seleccionada.
Siga creando el flujo de trabajo.
Proporcione la información necesaria para la acción.
En este ejemplo, seleccione la ruta de acceso de la carpeta en el servidor del sistema de archivos que usará, que en este caso es la carpeta raíz. Escriba el nombre de archivo y el contenido, en función del archivo cargado en Dropbox.
Sugerencia
Para agregar salidas de pasos anteriores en el flujo de trabajo, seleccione dentro de los cuadros de edición de la acción. Cuando aparezca la lista de contenido dinámico, seleccione entre las salidas disponibles.
Para probar el flujo de trabajo, agregue una acción de Outlook que le envíe un correo electrónico cuando la acción del sistema de archivos cree un archivo. Escriba los destinatarios, el asunto y el cuerpo del correo electrónico. Para realizar pruebas, puede usar su propia dirección de correo electrónico.
Cuando haya terminado, guarde el flujo de trabajo.
Para probar su flujo de trabajo, cargue un archivo que active el flujo de trabajo.
Si se ejecuta correctamente, el flujo de trabajo crea un archivo en el servidor del sistema de archivos, en función del archivo cargado en DropBox, y envía un correo electrónico sobre el archivo creado.
