Ejercicio: Creación de un conector personalizado y llamada a este desde un flujo de trabajo en Azure Logic Apps

  • 10 minutos

Tiene una API web llamada PrintFramer que calcula el coste de un marco de imagen en función de las dimensiones que le envíe. Los desarrolladores de la empresa quieren usar esta API en sus flujos de trabajo de Azure Logic Apps, pero actualmente no hay ninguna manera de realizar esa conexión.

En este ejercicio, creará un conector personalizado para Print Framer API y lo usará para enviar y recibir datos de un flujo de trabajo de aplicación lógica a una API web. En primer lugar, se necesita un flujo de trabajo de aplicación lógica.

Creación de un flujo de trabajo de aplicación lógica

  1. En el menú de Azure Portal o la página Inicio, en Servicios de Azure, seleccione Crear un recurso. Aparecerá el panel Crear un recurso.

  2. En el panel del menú de la izquierda, seleccione Integración, y busque y seleccione Aplicación lógica.

  3. En el panel Crear aplicación lógica, en Aspectos básicos, escriba los valores siguientes para cada opción.

    Configuración Value
    Detalles del proyecto
    Suscripción Suscripción de Concierge
    Grupo de recursos Seleccione Grupo de recursos del espacio aislado .
    Detalles de instancia
    Nombre de la aplicación lógica Especifique un nombre único. Recuerde el nombre para usarlo después.
    Publicar Flujo de trabajo
    Region Seleccione una región cerca de usted.
    Habilitación de análisis de registros No
    Plan
    Tipo de plan Consumo
    Redundancia de zona
    Redundancia de zona Déjelo como predeterminado (deshabilitado).

    El espacio aislado gratuito permite crear recursos en un subconjunto de las regiones globales de Azure. Seleccione una región de la lista siguiente al crear los recursos:

    • Oeste de EE. UU. 2
    • Centro-sur de EE. UU.
    • Centro de EE. UU.
    • Este de EE. UU.
    • Oeste de Europa
    • Sudeste de Asia
    • Japón Oriental
    • Sur de Brasil
    • Sudeste de Australia
    • Centro de la India

  4. Seleccione Revisar y crear y, una vez superada la validación, Crear.

  5. Una vez que el portal cree el recurso de aplicación lógica, seleccione Ir al recurso.

    En Azure Portal se muestra una galería con desencadenadores y patrones de flujo de trabajo usados con frecuencia.

  6. Seleccione Diseñador de aplicación lógica en el menú de la izquierda y, a continuación, seleccione Agregar un desencadenador.

  7. Busque y seleccione Cuando se recibe una solicitud HTTP.

    Ahora en el diseñador de flujos de trabajo se muestra el desencadenador seleccionado.

  8. Seleccione Mostrar todo en la sección Parámetros avanzados.

  9. Seleccione GET en la lista desplegable Método.

  10. Escriba {height}/{width} como una cadena literal en el campo Ruta de acceso relativa.

    Captura de pantalla en la que se muestra la información del desencadenador de solicitud.

  11. En la barra de herramientas del diseñador, seleccione Save (Guardar).

Ya tiene un flujo de trabajo de aplicación lógica básico. Ahora se agregará un conector personalizado para poder llamar a Print Framer API personalizada desde el flujo de trabajo.

Creación de un conector personalizado de Azure Logic Apps en Azure Portal

  1. En el menú de Azure Portal o la página Inicio, en Servicios de Azure, seleccione Crear un recurso. Aparecerá el panel Crear un recurso.

  2. En el cuadro de búsqueda, busque y seleccione Conector personalizado de Logic Apps.

  3. En el panel Conector personalizado de Logic Apps, seleccione Crear.

  4. En el panel Crear conector personalizado de Logic Apps, en Aspectos básicos, escriba los valores siguientes para cada opción.

    Configuración Value
    Detalles del proyecto
    Suscripción Suscripción de Concierge
    Grupo de recursos Seleccione Grupo de recursos del espacio aislado .
    Detalles de instancia
    Nombre del conector personalizado PrintFramerConnector
    Region Seleccione una región cercana y que también sea compatible con el espacio aislado.
    Asociación con el entorno del servicio de integración Déjelo sin seleccionar

  5. Seleccione Revisar + crear. Si la validación se realiza correctamente, seleccione Crear.

  6. Una vez finalizada la implementación, seleccione Ir al recurso.

Importación de la definición de OpenAPI

Ahora use el archivo OpenAPI que ha guardado antes para definir el conector personalizado.

  1. En Azure Portal o la página Inicio, seleccione Todos los recursos y luego PrintFramerConnector.

  2. En la página Información general, seleccione Editar.

    Captura de pantalla en la que se muestra el editor del conector personalizado

  3. En la sección Conectores personalizados, seleccione Archivo de OpenAPI e Importar. Abra el archivo JSON que ha guardado en el ejercicio anterior.

Configuración del conector personalizado

El archivo de OpenAPI indica al conector personalizado las operaciones que están disponibles en la API web. Tendrá que establecer otras propiedades para el conector personalizado.

  1. En la sección Información general, en el cuadro Descripción, escriba Obtener una estimación para un marco de imagen. Es posible que deba desplazarse hacia abajo para ver esta parte del panel de configuración.

  2. En el cuadro de texto Host, escriba la dirección URL de ejemplo que ha anotado antes.

  3. En el panel Seguridad, asegúrese de que está seleccionada la opción Sin autenticación.

    Importante

    Para esta demostración, se puede permitir el acceso a la API sin ningún tipo de autenticación. En el caso de API reales, que contienen datos confidenciales o requieren una suscripción de pago, la autenticación es esencial.

  4. En el panel Definición, en el cuadro de texto Resumen, escriba Estimar el coste de un marco de imagen.

  5. En Visibilidad, seleccione Importante.

  6. En la parte superior del panel, seleccione Actualizar conector.

Adición del conector personalizado al flujo de trabajo de aplicación lógica

Ahora puede usar el conector personalizado en el flujo de trabajo de aplicación lógica.

  1. En Azure Portal o la página Inicio, en Recursos de Azure, seleccione Todos los recursos y después la aplicación lógica que ha creado en la unidad 3.

  2. En el menú del recurso de aplicación lógica, seleccione Información general. En la barra de herramientas del panel Información general, seleccione Editar.

  3. En el diseñador, seleccione Nuevo paso>Agregar una acción.

  4. En el cuadro de búsqueda Elegir una acción, seleccione Personalizado y después PrintFramerConnector.

  5. En Acciones, seleccione Estimar el coste de un marco de imagen.

  6. En el cuadro Calcular el costo de un marco de imagen, coloque el cursor en el campo Alto. Desde la lista de contenido dinámico que se abre, seleccione height.

    En la captura de pantalla siguiente se muestra esta selección:

    Captura de pantalla en la que se muestra el conector personalizado y el parámetro

  7. Vuelva al conector personalizado y coloque el cursor en el campo Ancho. En la lista de contenido dinámico, seleccione width.

    Los parámetros de alto y ancho que se reciben de cada solicitud HTTP que desencadena el flujo de trabajo ahora están enlazados a los parámetros de alto y ancho que se pasan a PrintFramerConnector.

Finalización del flujo de trabajo

Por último, el flujo de trabajo necesita una manera de mostrar los resultados. Puede usar la acción Respuesta para mostrar la estimación:

  1. En el diseñador de flujos de trabajo, seleccione Nuevo paso.

  2. En el cuadro de búsqueda Elegir una operación, escriba Respuesta y, después, seleccione la acción denominada Respuesta.

  3. En el cuadro Cuerpo, escriba El coste aproximado del marco es:$.

  4. En la lista de contenido dinámico que se abre, seleccione Cuerpo en la sección Estimar el coste de un marco de imagen.

    En la captura de pantalla siguiente se muestra esta selección:

    Captura de pantalla en la que se muestra la configuración de la acción

  5. Cuando haya terminado, seleccione Guardar para guardar el flujo de trabajo.

Probar el flujo de trabajo

El flujo de trabajo ya está terminado y llamará a la API web mediante el conector personalizado. Ahora, solo tiene que enviar una solicitud que desencadene el flujo de trabajo, lo que puede hacer mediante el explorador.

  1. En el diseñador de flujos de trabajo, expanda la acción Cuando se recibe una solicitud HTTP.

  2. Junto al campo URL HTTP GET, seleccione Copiar dirección URL.

  3. Abra una nueva pestaña del explorador y pegue la dirección URL en la barra de direcciones.

  4. En la URL pegada, reemplace el parámetro {height} por 10. Reemplace el parámetro {width} por 4. Presione ENTRAR.

    En el explorador se mostrará un coste aproximado.

  5. Pruebe a escribir otros valores para el alto y el ancho.

¡Enhorabuena! Ha creado un flujo de trabajo de aplicación lógica que puede llamar a la instancia interna de Print Framer API mediante un conector personalizado.