Compartir a través de


Inicio rápido: Creación de flujos de trabajo de consumo en Azure Logic Apps multiinquilino mediante Visual Studio Code

Se aplica a: Azure Logic Apps (Consumo)

Como desarrollador de integración, a menudo necesita automatizar los procesos empresariales en aplicaciones SaaS, sistemas empresariales y orígenes de datos sin administrar la infraestructura. También necesita un enfoque de código primero para construir flujos de trabajo, de modo que pueda versionar las definiciones, realizar actualizaciones y revisar los cambios de manera eficiente.

En este inicio rápido se muestra cómo crear y administrar flujos de trabajo de consumo en Azure Logic Apps multiinquilino mediante las herramientas locales de código primero en Visual Studio Code. Los flujos de trabajo de consumo proporcionan un modelo de integración sin servidor para flujos de trabajo programados y controlados por eventos, por lo que puede conectar servicios y automatizar procesos mientras paga solo por las acciones que se ejecutan.

En Visual Studio Code, puede editar definiciones de flujo de trabajo en notación de objetos JavaScript (JSON) mediante el editor de código, usar el diseñador visual cuando sea necesario y administrar flujos de trabajo implementados en Azure. También puede trabajar en flujos de trabajo y cuentas de integración desde cualquier plataforma de desarrollo en la que se ejecute Visual Studio Code, como Linux, Windows y macOS.

En la captura de pantalla siguiente se muestra el aspecto de una definición de flujo de trabajo de consumo de ejemplo:

Captura de pantalla que muestra una definición de flujo de trabajo de aplicación lógica de consumo de ejemplo en Visual Studio Code.

Para obtener más información, consulte:

Requisitos previos

Acceso a Azure desde Visual Studio Code

  1. En Visual Studio Code, inicie sesión en su cuenta de Azure.

    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, siga estos pasos:

    1. Seleccione Usar código de dispositivo y, a continuación, seleccione Copiar y abrir.

    2. Seleccione Abrir vínculo para abrir una nueva ventana del explorador y continuar con el sitio web de autenticación.

    3. En la página Iniciar sesión en tu cuenta, escriba el código de autenticación y seleccione Siguiente.

  2. En la barra actividad, seleccione el icono de Azure.

    Captura de pantalla que muestra Visual Studio Code, barra de actividad y el icono de Azure seleccionado.

    En el panel de Azure, las secciones Logic Apps (consumo) y Cuentas de integración muestran ahora las suscripciones de Azure asociadas a su cuenta. Si no ve las suscripciones que espera o si las secciones muestran demasiadas suscripciones, siga estos pasos:

    1. En la sección Logic Apps (Consumo), seleccione Seleccionar suscripciones.

      Captura de pantalla que muestra el panel de Azure, la sección Consumo de Logic Apps y Seleccionar suscripciones seleccionadas para filtrar las suscripciones de Azure.

    2. En la lista suscripciones, seleccione las suscripciones que desea usar.

  3. En la sección Logic Apps (Consumption), expanda su suscripción para ver las aplicaciones lógicas implementadas en esa suscripción.

    Captura de pantalla que muestra una suscripción expandida de Azure con aplicaciones lógicas asociadas.

Creación de una aplicación lógica

  1. En Visual Studio Code, en la sección Logic Apps (Consumo), desde el menú contextual de la suscripción, seleccione Crear Logic App.

    Captura de pantalla que muestra el menú contextual de la suscripción y la opción Crear Logic App.

    Aparece una lista que muestra los grupos de recursos de Azure de su suscripción.

  2. En la lista de grupos de recursos, seleccione Crear nuevo grupo de recursos o un grupo de recursos existente.

    En este ejemplo, seleccione Crear un nuevo grupo de recursos, por ejemplo:

    Captura de pantalla que muestra la lista de grupos de recursos con la opción Crear nuevo grupo de recursos seleccionado.

  3. Escriba un nombre para el grupo de recursos de Azure.

    Captura de pantalla que muestra un nuevo nombre de grupo de recursos de Azure especificado.

  4. Seleccione la región de Azure donde guardar los metadatos de la aplicación lógica.

    Captura de pantalla que muestra una región de Azure seleccionada.

  5. Escriba un nombre para la aplicación lógica.

    Captura de pantalla que muestra un nombre especificado para una aplicación lógica.

    En la ventana de Azure, bajo tu suscripción de Azure, aparecen la nueva aplicación lógica y el flujo de trabajo vacío. Visual Studio Code también abre un archivo JSON (.logicapp.json), que incluye una definición de flujo de trabajo esqueleto, por ejemplo:

    Captura de pantalla que muestra el marco para una definición de flujo de trabajo de aplicación lógica vacía en un archivo JSON.

    Ahora puede empezar a crear manualmente la definición de flujo de trabajo en este archivo JSON. Para obtener una referencia técnica sobre la estructura y la sintaxis de una definición de flujo de trabajo, consulte Esquema del lenguaje de definición de flujo de trabajo para Azure Logic Apps.

    La siguiente definición de flujo de trabajo de aplicación lógica de ejemplo 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 estos elementos aproximadamente en el orden en que las operaciones de flujo de trabajo aparecen en el diseñador.

    {
       "$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": 30
             },
             "splitOn": "@triggerBody()?['value']",
             "type": "ApiConnection",
             "inputs": {
                "host": {
                   "connection": {
                      "name": "@parameters('$connections')['rss']['connectionId']"
                   }
                },
                "method": "get",
                "path": "/OnNewFeed",
                "queries": {
                   "feedUrl": "@{encodeURIComponent('https://feeds.content.dowjones.io/public/rss/RSSMarketsMain')}",
                   "sinceProperty": "PublishDate"
                }
             }
          }
       },
       "actions": {
          "Send_an_email_(V2)": {
             "runAfter": {},
             "type": "ApiConnection",
             "inputs": {
                "body": {
                   "Body": "<p>Title: @{triggerBody()?['title']}<br>\n<br>\nDate published: @{triggerBody()?['updatedOn']}<br>\n<br>\nLink: @{triggerBody()?['primaryLink']}</p>",
                   "Subject": "RSS item: @{triggerBody()?['title']}",
                   "To": "sophia-owen@fabrikam.com"
                },
                "host": {
                   "connection": {
                      "name": "@parameters('$connections')['office365']['connectionId']"
                   }
                },
                "method": "post",
                "path": "/v2/Mail"
             }
          }
       },
       "outputs": {}
    }
    

    Importante

    Para reutilizar esta definición de flujo de trabajo de ejemplo, necesita una cuenta profesional o educativa de la organización, 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 Send_an_email_action acción por una acción similar disponible desde 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 tienes una cuenta de consumidor de Gmail, puedes usar este conector solo con servicios específicos aprobados por Google o crear una aplicación cliente de Google para usarla para la autenticación con tu 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.

  6. Cuando termine, guarde la definición del flujo de trabajo. (Archivo)>Guarde o presione Ctrl+S).

  7. Cuando se le pida que cargue la definición de flujo de trabajo de la aplicación lógica en la suscripción de Azure, seleccione Cargar.

    En este paso se publica la definición de flujo de trabajo de la aplicación lógica de Visual Studio Code en Azure Portal, lo que hace que el flujo de trabajo esté activo y ejecutándose en Azure.

    Captura de pantalla que muestra un cuadro de diálogo con el botón Cargar resaltado para cargar una aplicación lógica en Azure Portal.

Visualización del flujo de trabajo en el diseñador

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

En la ventana de Azure, en la sección Logic Apps (Consumption), seleccione Abrir en el Diseñador en el menú contextual de su aplicación lógica.

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

Captura de pantalla que muestra el flujo de trabajo de la aplicación lógica en la vista de diseño.

Visualización del flujo de trabajo en Azure Portal

Para revisar la definición del flujo de trabajo de la aplicación lógica en Azure Portal, siga estos pasos:

  1. En Azure Portal, inicie sesión con la misma cuenta y suscripción de Azure asociada a la aplicación lógica.

  2. 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.

    Captura de pantalla que muestra Azure Portal, el cuadro de búsqueda y el nombre especificados para la aplicación lógica con el resultado resaltado.

  3. En la barra lateral de la aplicación lógica, en Herramientas de desarrollo, abra el flujo de trabajo en el diseñador o la vista de código.

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

En Visual Studio Code, puede abrir y editar la definición de flujo de trabajo para un recurso de aplicación lógica ya implementado en Azure.

Importante

Antes de editar un flujo de trabajo de aplicación lógica en ejecución activa en producción, minimice la interrupción y evite el riesgo de interrumpir el flujo de trabajo deshabilitando primero el recurso de la aplicación lógica.

  1. En la barra de actividad de Visual Studio Code, seleccione el icono de Azure.

  2. En la ventana de Azure, en la sección Logic Apps (consumo), expanda la suscripción de Azure y seleccione la aplicación lógica que desee.

  3. En el menú contextual de la aplicación lógica, seleccione Abrir en el Editor. O bien, junto al nombre de la aplicación lógica, seleccione el icono de edición.

    Captura de pantalla que muestra la ventana de Azure, el menú contextual de la aplicación lógica y Abrir en el Editor seleccionado.

    Visual Studio Code abre el archivo .logicapp.json en la carpeta temporal local para que pueda ver la definición del flujo de trabajo.

    Captura de pantalla que muestra Visual Studio Code y el archivo de definición de flujo de trabajo de aplicación lógica abierto.

  4. Realice los cambios en el archivo de definición de flujo de trabajo.

  5. Cuando termine, guarde los cambios (Guardar archivo> o presione Ctrl+S).

  6. Cuando se le pida que cargue los cambios y sobrescriba el flujo de trabajo de la aplicación lógica existente en Azure Portal, seleccione Cargar.

    Este paso publica tus actualizaciones en el recurso de la aplicación lógica en el portal de Azure.

    Captura de pantalla que muestra un cuadro de diálogo de Visual Studio Code con el botón Cargar resaltado para cargar los cambios de la aplicación lógica en Azure Portal.

Ver o promover otras versiones

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

Importante

Antes de cambiar un flujo de trabajo de aplicación lógica que se ejecuta activamente en producción, minimice la interrupción y evite el riesgo de interrumpir esa aplicación lógica deshabilitando primero el recurso de la aplicación lógica.

  1. En la ventana de Azure, en la sección Logic Apps (consumo), expanda la suscripción de Azure para ver las aplicaciones lógicas asociadas.

  2. En su suscripción, expanda la aplicación lógica y, a continuación, Versiones.

    En la lista Versiones se muestran las versiones anteriores de la aplicación lógica, si existen.

    Captura de pantalla que muestra Visual Studio Code y las versiones anteriores de una aplicación lógica.

  3. Para ver una versión anterior, elija uno de los pasos siguientes:

    • Para ver la definición de JSON, en Versiones, seleccione el número de versión de esa definición. O bien, en el menú contextual de la versión, 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 el diseñador de solo lectura, en el menú contextual de la versión, seleccione Abrir en el Diseñador.

  4. Para promover una versión anterior a la versión actual, siga estos pasos:

    1. En Versiones, en el menú contextual de la versión anterior, seleccione Promover.

      Captura de pantalla que muestra Visual Studio Code y cómo promover una versión de aplicación lógica anterior a la versión actual.

    2. Para continuar después de que Visual Studio Code le pida confirmación, seleccione .

      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.

Desactivar o activar las aplicaciones lógicas

En Visual Studio Code, si edita un flujo de trabajo de aplicación lógica publicada y guarda los cambios, sobrescribe la aplicación lógica ya implementada. Para evitar interrumpir el flujo de trabajo de la aplicación lógica en producción y minimizar la interrupción, deshabilite primero el recurso de la aplicación lógica. Después de confirmar que el flujo de trabajo sigue funcionando según lo previsto, puede reactivar el recurso de aplicación lógica.

Deshabilitar o habilitar un recurso de aplicación lógica afecta a las instancias de flujo de trabajo de las maneras siguientes:

  • Azure Logic Apps continúa las ejecuciones de flujo de trabajo 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 activa la próxima vez que se cumplan sus condiciones.

  • El estado del desencadenador recuerda el punto en el que se detuvo el flujo de trabajo. Por lo tanto, si reactiva la aplicación lógica, el desencadenador se activa para los elementos que aún no se han procesado desde la última ejecución.

    Para impedir que el desencadenador se active en estos elementos no procesados, antes de reactivar el recurso de la aplicación lógica, borre el estado del desencadenador:

    1. En el flujo de trabajo, edite cualquier parte del desencadenador.
    2. Guarde los cambios. Este paso restablece el estado actual del desencadenador.
    3. Vuelva a activar el recurso de la aplicación lógica.
  • Cuando el recurso de la aplicación lógica está deshabilitado, todavía puede volver a enviar ejecuciones de flujo de trabajo.

Para deshabilitar o habilitar un recurso de aplicación lógica en Visual Studio Code, siga estos pasos:

  1. En Visual Studio Code, abra la ventana de Azure.

  2. En la sección Logic Apps (Consumo), expanda la suscripción de Azure para ver las aplicaciones lógicas asociadas.

  3. Para deshabilitar un recurso de aplicación lógica, en el menú contextual de la aplicación lógica, seleccione Deshabilitar.

    Captura de pantalla que muestra Visual Studio Code y cómo deshabilitar un recurso de aplicación lógica.

  4. Cuando esté listo para reactivar el recurso de aplicación lógica, en el menú contextual de la aplicación lógica, seleccione Habilitar.

    Captura de pantalla que muestra Visual Studio Code y cómo habilitar un recurso de aplicación lógica.

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 intenta cancelar las ejecuciones de flujo de trabajo en curso y pendientes.

    Incluso con un gran volumen o trabajo pendiente, la mayoría de las ejecuciones se cancelan antes de que finalizan o se inician. Sin embargo, el proceso de cancelación puede tardar en completarse. Mientras tanto, el servicio puede seleccionar algunas tareas para ejecución mientras procesa el proceso de cancelación.

  • Azure Logic Apps no crea ni ejecuta nuevas instancias de flujo de trabajo.

  • Si elimina un flujo de trabajo y vuelve a crear el mismo flujo de trabajo, el flujo de trabajo recreado tiene metadatos diferentes. Debe volver a guardar cualquier flujo de trabajo que llame al flujo de trabajo eliminado. Al volver a guardar, el llamador recibe 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.

Para eliminar un recurso de aplicación lógica de Visual Studio Code, siga estos pasos:

  1. En Visual Studio Code, abra la ventana de Azure.

  2. En la sección Logic Apps (Consumo), expanda la suscripción de Azure para ver los recursos de aplicaciones lógicas asociados. Busque el recurso de aplicación lógica que desea eliminar.

  3. En el menú contextual de la aplicación lógica, seleccione Eliminar.

    Captura de pantalla que muestra Visual Studio Code y cómo eliminar un recurso de aplicación lógica.