Inicio rápido: Crear y administrar definiciones de flujo de trabajo de aplicación lógica con Azure Logic Apps multiinquilino y Visual Studio Code

Artículo
01/04/2024

Se aplica a: Azure Logic Apps (consumo)

En este inicio rápido se muestra cómo crear y administrar flujos de trabajo de aplicación lógica que le ayuden a automatizar tareas y procesos para integrar aplicaciones, datos, sistemas y servicios en organizaciones y empresas mediante el uso de Azure Logic Apps multiinquilino y Visual Studio Code. Puede crear y editar las definiciones de los flujos de trabajo subyacentes, que usan la notación de objetos JavaScript (JSON), para aplicaciones lógicas mediante código. También puede trabajar en aplicaciones lógicas existentes ya implementadas en Azure. Para más información sobre el modelo multiinquilino frente al modelo de inquilino único, consulte Inquilino único frente a multiinquilino y entorno del servicio de integración.

Aunque puede realizar estas mismas tareas en Azure Portal y en Visual Studio, puede empezar a trabajar con mayor rapidez en Visual Studio Code si ya tiene familiaridad con la aplicación lógica y desea trabajar directamente en el código. Por ejemplo, puede deshabilitar, habilitar, eliminar y actualizar las aplicaciones lógicas ya creadas. Además, puede trabajar en Logic Apps y las cuentas de integración desde cualquier plataforma de desarrollo donde se ejecute Visual Studio Code, como Linux, Windows y Mac.

En este artículo, puede crear la misma aplicación lógica desde este inicio rápido, que se centra más en los conceptos básicos. También puede aprender a crear la aplicación de ejemplo en Visual Studio y aprender a crear y administrar aplicaciones mediante la CLI de Azure. En Visual Studio Code, la aplicación lógica se parece a este ejemplo:

Example logic app workflow definition

Requisitos previos

Antes de empezar, asegúrese de que dispone de estos elementos:

Si no tiene una cuenta de Azure y una suscripción, regístrese para obtener una cuenta gratuita de Azure.
Conocimientos básicos acerca de las definiciones de flujos de trabajo de aplicaciones lógicas y su estructura, que se describe con JSON

Si nunca ha usado Azure Logic Apps, pruebe este inicio rápido, con el que puede crear su primer flujo de trabajo de aplicación lógica en Azure Portal y está más enfocado en los conceptos básicos.
Acceso a la web para iniciar sesión en Azure y en su suscripción
Descargue e instale estas herramientas si no las tiene aún:
- Visual Studio Code versión 1.25.1 o posterior, que es gratis
- La extensión de Visual Studio Code para Azure Logic Apps
  
  Puede descargar e instalar esta extensión desde Visual Studio Marketplace o directamente desde Visual Studio Code. Asegúrese de volver a cargar Visual Studio Code después de la instalación.
  
  Para comprobar que la extensión se ha instalado correctamente, seleccione el icono de Azure que aparecer en la barra de herramientas de Visual Studio Code.
  
  Para más información, consulte Extension Marketplace (Marketplace de extensiones). Para contribuir a la versión de código abierto de esta extensión; vaya a Extensión de Azure Logic Apps para Visual Studio Code en GitHub.
Si la aplicación lógica necesita comunicarse a través de un firewall que limite el tráfico a direcciones IP específicas, ese firewall debe permitir el acceso para ambas direcciones IP, la de entrada y la de salida, utilizadas por Azure Logic Apps o por el entorno de ejecución en la región de Azure donde se encuentra la aplicación lógica. Si la aplicación lógica también usa conectores administrados, como el conector de Outlook de Office 365 o el conector de SQL, o emplea conectores personalizados, el firewall también debe permitir el acceso a todas las direcciones IP de salida del conector administrado en la región de Azure de la aplicación lógica.

Acceso a Azure desde Visual Studio Code

Abra Visual Studio Code. En la barra de herramientas de Visual Studio Code, seleccione el icono de Azure.
En la ventana de Azure, en Logic Apps, seleccione Iniciar sesión en Azure. Cuando la página de inicio de sesión de Microsoft se lo solicite, inicie sesión con su cuenta de Azure.
1. Si el inicio de sesión tarda más de lo habitual, Visual Studio Code le pedirá que inicie sesión a través de un sitio web de autenticación de Microsoft. Para ello, le proporcionará un código de dispositivo. Para iniciar sesión con el código en su lugar, seleccione Use Device Code (Usar el código de dispositivo).
2. Para copiar el código, seleccione Copy & Open (Copiar y abrir).
3. Para abrir una nueva ventana del explorador y continuar con el sitio web de autenticación, seleccione Abrir vínculo.
4. En la página Iniciar sesión en tu cuenta, escriba el código de autenticación y seleccione Siguiente.
Seleccione su cuenta de Azure. Después de iniciar sesión, puede cerrar el explorador y volver a Visual Studio Code.

En el panel de Azure, las secciones Logic Apps y Cuentas de integración muestran las suscripciones a Azure asociadas con su cuenta. Sin embargo, si no ve las suscripciones que espera, o si las secciones muestran demasiadas suscripciones, siga estos pasos:
1. Mueva el puntero sobre la etiqueta Logic Apps. Cuando aparezca la barra de herramientas, seleccione Seleccionar suscripciones (icono de filtro).
2. En la lista que aparece, seleccione las suscripciones que quiere que aparezcan.
En Logic Apps, seleccione la suscripción que quiera. El nodo de la suscripción se expande y muestra las aplicaciones lógicas que existen en esa suscripción.

Sugerencia

En Cuentas de integración, al seleccionar su suscripción, se muestran todas las cuentas de integración que existen en esa suscripción.

Creación de una nueva aplicación lógica

Si aún no ha iniciado sesión en su cuenta y suscripción de Azure desde dentro de Visual Studio Code, siga los pasos anteriores para iniciar sesión ahora.
En Visual Studio Code, en Logic Apps, abra el menú contextual de la suscripción y seleccione Crear aplicación lógica.

Aparece una lista que muestra los grupos de recursos de Azure de su suscripción.
En la lista del grupo de recursos, seleccione Crear un nuevo grupo de recursos o un grupo de recursos existente. Para este ejemplo, cree un nuevo grupo de recursos:
Proporcione un nombre para el grupo de recursos de Azure y presione ENTRAR.
Seleccione la región de Azure en la que quiera guardar los metadatos de la aplicación lógica.
Proporcione un nombre para la aplicación lógica y presione Entrar.

En la ventana de Azure, en su suscripción, se mostrará la nueva aplicación lógica en blanco. Visual Studio Code también abre un archivo JSON (.logicapp.json), que incluye una definición de flujo de trabajo de esqueleto para la aplicación lógica. Ahora puede empezar a crear manualmente la definición de flujo de trabajo de la aplicación lógica en este archivo JSON. Para obtener información técnica sobre la estructura y la sintaxis de una definición de flujo de trabajo, consulte la Guía de referencia del esquema del lenguaje de definición de flujo de trabajo en Azure Logic Apps.

Por ejemplo, a continuación se muestra una definición de flujo de trabajo de aplicación lógica de muestra que comienza con un desencadenador RSS y una acción de Office 365 Outlook. Normalmente, los elementos JSON aparecen en orden alfabético en cada sección. Sin embargo, en este ejemplo se muestran aproximadamente en el orden en que aparecen los pasos de la aplicación lógica en el diseñador.

Importante

Si quiere volver a usar esta definición de aplicación lógica de muestra, necesita una cuenta profesional, como por ejemplo, @fabrikam.com. Asegúrese de reemplazar la dirección de correo electrónico ficticia por su propia dirección de correo electrónico. Para usar un conector de correo electrónico diferente, como Outlook.com o Gmail, reemplace la acción Send_an_email_action por una acción similar disponible en un conector de correo electrónico compatible con Azure Logic Apps.

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.
```
{
 "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
 "contentVersion": "1.0.0.0",
 "parameters": {
 "$connections": {
 "defaultValue": {},
 "type": "Object"
 }
 },
 "triggers": {
 "When_a_feed_item_is_published": {
 "recurrence": {
 "frequency": "Minute",
 "interval": 1
 },
 "splitOn": "@triggerBody()?['value']",
 "type": "ApiConnection",
 "inputs": {
 "host": {
 "connection": {
 "name": "@parameters('$connections')['rss']['connectionId']"
 }
 },
 "method": "get",
 "path": "/OnNewFeed",
 "queries": {
 "feedUrl": "http://feeds.reuters.com/reuters/topNews"
 }
 }
 }
 },
 "actions": {
 "Send_an_email_(V2)": {
 "runAfter": {},
 "type": "ApiConnection",
 "inputs": {
 "body": {
 "Body": "Title: @{triggerBody()?['title']} \n \nDate published: @{triggerBody()?['updatedOn']} \n \nLink: @{triggerBody()?['primaryLink']}",
 "Subject": "RSS item: @{triggerBody()?['title']}",
 "To": "sophia-owen@fabrikam.com"
 },
 "host": {
 "connection": {
 "name": "@parameters('$connections')['office365']['connectionId']"
 }
 },
 "method": "post",
 "path": "/v2/Mail"
 }
 }
 },
 "outputs": {}
}
```
Cuando haya terminado, guarde la definición de flujo de trabajo de la aplicación lógica. (Menú Archivo > Guardar, o bien presione Ctrl+S)
Cuando se le pida que cargue la aplicación lógica en su suscripción a Azure, seleccione Cargar.

Este paso publica la aplicación lógica en Azure Portal y hace que la lógica se ejecute en Azure.

Ver la aplicación lógica en el diseñador

En Visual Studio Code, puede abrir la aplicación lógica en una vista de diseño de solo lectura. Aunque no puede editar la aplicación lógica en el diseñador, puede comprobar visualmente el flujo de trabajo de la aplicación lógica mediante la vista del diseñador.

En la ventana de Azure, en Logic Apps, abra el menú contextual de la aplicación lógica y seleccione Abrir en el diseñador.

El diseñador de solo lectura se abre en una ventana independiente y muestra el flujo de trabajo de la aplicación lógica, por ejemplo:

View logic app in read-only designer

Ver en Azure Portal

Para revisar la aplicación lógica en Azure Portal, siga estos pasos:

Inicie sesión en Azure Portal con la misma cuenta de Azure y la misma suscripción asociadas con la aplicación lógica.
En el cuadro de búsqueda de Azure Portal, escriba el nombre de la aplicación lógica. En la lista de resultados, seleccione la aplicación lógica.

Edición de la aplicación lógica implementada

En Visual Studio Code, puede abrir y editar la definición de flujo de trabajo de una aplicación lógica ya implementada en Azure.

Importante

Antes de editar una aplicación lógica que se ejecuta activamente en producción, evite el riesgo de interrumpir esa aplicación lógica y minimice la interrupción mediante la deshabilitación de la aplicación lógica en primer lugar.

Si aún no ha iniciado sesión en su cuenta y suscripción de Azure desde dentro de Visual Studio Code, siga los pasos anteriores para iniciar sesión ahora.
En la ventana de Azure, en Logic Apps, expanda su suscripción de Azure y seleccione la aplicación lógica que quiera.
Abra el menú de la aplicación lógica y seleccione Abrir en el . O bien, junto al nombre de la aplicación lógica, seleccione el icono de edición.

Visual Studio Code abre el archivo .logicapp.json en una carpeta temporal local para que pueda ver la definición del flujo de trabajo de la aplicación lógica.
Aplique los cambios en la definición del flujo de trabajo de la aplicación lógica.
Cuando haya terminado, guarde los cambios. (Menú Archivo > Guardar, o bien presione Ctrl+S)
Cuando se le pida que cargue los cambios y sobrescriba la aplicación lógica existente en Azure Portal, seleccione Cargar.

Este paso publica las actualizaciones de la aplicación lógica en Azure Portal.

Ver o promover otras versiones

En Visual Studio Code, puede abrir y revisar las versiones anteriores de la aplicación lógica. También puede promover una versión anterior a la versión actual.

Importante

Antes de modificar una aplicación lógica que se ejecuta activamente en producción, evite el riesgo de interrumpir esa aplicación lógica y minimice la interrupción mediante la deshabilitación de la aplicación lógica en primer lugar.

En la ventana de Azure, en Logic Apps, expanda su suscripción a Azure para poder ver todas las aplicaciones lógicas de la suscripción.
En su suscripción, expanda la aplicación lógica y, a continuación, Versiones.

La lista Versiones muestra las versiones anteriores de la aplicación lógica, si existe alguna.
Para ver una versión anterior, seleccione uno de estos pasos:
- Para ver la definición de JSON, en Versiones, seleccione el número de versión de esa definición. O bien, abra el menú contextual de la versión y seleccione Abrir en el editor.
  
  Se abre un nuevo archivo en el equipo local y se muestra la definición de JSON de la versión.
- Para ver la versión en la vista del diseñador de solo lectura, abra el menú contextual de esa versión y seleccione Abrir en el diseñador.
Para promover una versión anterior a la versión actual, siga estos pasos:
1. En Versiones, abra el menú contextual de la versión anterior y seleccione Promover.
2. Para continuar después de que Visual Studio Code le pida confirmación, seleccione Sí.
  
  Visual Studio Code promueve la versión seleccionada a la versión actual y asigna un nuevo número a la versión promovida. La versión actual anterior aparece ahora bajo la versión promovida.

Deshabilitación o habilitación de la aplicaciones lógicas

En Visual Studio Code, si edita una aplicación lógica publicada y guarda los cambios, sobrescribe la aplicación ya implementada. Para evitar interrumpir la aplicación lógica en producción y minimizar la interrupción, deshabilite primero la aplicación lógica. Luego, puede reactivar la aplicación lógica, después de haber confirmado que aún funciona.

Azure Logic Apps continúa todas las ejecuciones en curso y pendientes hasta que finalizan. Según el volumen o el trabajo pendiente, este proceso puede tardar en completarse.
Azure Logic Apps no crea ni ejecuta nuevas instancias de flujo de trabajo.
El desencadenador no se activará la próxima vez que se cumplan sus condiciones.
El estado del desencadenador recuerda el punto en el que se detuvo la aplicación lógica. Por lo tanto, si reactiva la aplicación lógica, el desencadenador se activará para todos los elementos no procesados desde la última ejecución.

Para evitar que el desencadenador se active con elementos no procesados desde la última ejecución, borre el estado del desencadenador antes de reactivar la aplicación lógica:
1. En la aplicación lógica, edite cualquier parte del desencadenador del flujo de trabajo.
2. Guarde los cambios. Este paso restablece el estado actual del desencadenador.
3. Reactive la aplicación lógica.
Aunque un flujo de trabajo esté deshabilitado, puede volver a enviar ejecuciones.

Si aún no ha iniciado sesión en su cuenta y suscripción de Azure desde dentro de Visual Studio Code, siga los pasos anteriores para iniciar sesión ahora.
En la ventana de Azure, en Logic Apps, expanda su suscripción a Azure para poder ver todas las aplicaciones lógicas de la suscripción.
1. Para deshabilitar la aplicación lógica que desee, abra el menú de la aplicación lógica y seleccione Deshabilitar.
2. Cuando esté listo para volver a activar la aplicación lógica, abra el menú de la aplicación lógica y seleccione Habilitar.

Eliminación de aplicaciones lógicas

La eliminación de una aplicación lógica afecta a las instancias de flujo de trabajo de las maneras siguientes:

Azure Logic Apps hace todo lo posible por cancelar todas las ejecuciones en curso y pendientes.

Incluso con un gran volumen o trabajo pendiente, la mayoría de las ejecuciones se cancelan antes de que finalicen o se inicien. Sin embargo, el proceso de cancelación puede tardar en completarse. Mientras tanto, pueden seleccionarse algunas ejecuciones para su ejecución mientras el servicio se encarga del proceso de cancelación.
Azure Logic Apps no crea ni ejecuta nuevas instancias de flujo de trabajo.
Si elimina un flujo de trabajo y, luego, vuelve a crear el mismo flujo de trabajo, el flujo de trabajo recreado no tendrá los mismos metadatos que el flujo de trabajo eliminado. Tiene que volver a guardar todo flujo de trabajo que haya llamado al flujo de trabajo eliminado. De este modo, el autor de la llamada obtiene la información correcta para el flujo de trabajo recreado. De lo contrario, las llamadas al flujo de trabajo recreado producirán un error Unauthorized. Este comportamiento también se aplica a los flujos de trabajo que usan artefactos en cuentas de integración y a flujos de trabajo que llaman a funciones de Azure.

Si aún no ha iniciado sesión en su cuenta y suscripción de Azure desde dentro de Visual Studio Code, siga los pasos anteriores para iniciar sesión ahora.
En la ventana de Azure, en Logic Apps, expanda su suscripción a Azure para poder ver todas las aplicaciones lógicas de la suscripción.
Busque la aplicación lógica que desee eliminar, abra el menú de la aplicación lógica y seleccione Eliminar.

Pasos siguientes

Creación de flujos de trabajo de aplicación lógica basados en un solo inquilino en Visual Studio Code