Ejercicio: Crear un conector personalizado desde Visual Studio

  • 5 minutos

En este ejercicio, creará un conector personalizado en el entorno de Power Platform desde su API web en Visual Studio.

Power Platform permite que los desarrolladores de API web creen rápidamente aplicaciones móviles o web utilizando una aplicación de lienzo de Power Apps como front end. Con el servicio conectado de Power Platform en Visual Studio 2022, los desarrolladores de API web ASP.NET pueden crear fácilmente un conector personalizado para usarlo con Power Apps.

Nota

Si desea utilizar Visual Studio y Power Apps en este ejercicio, deberá hacer lo siguiente:

  • Instale Visual Studio 2022 con ASP.NET y la carga de trabajo de desarrollo web instaladas. Debe iniciar sesión en Visual Studio para crear y utilizar túneles de desarrollo. La característica no está disponible en Visual Studio para Mac.
  • Cree un entorno de desarrollo de Power Platform gratuito.
  • Descargue las muestras.

Agregar Power Platform como un servicio conectado

  1. Abra esta API de muestra desde GitHub con Visual Studio. Este es un proyecto API web principal de ASP.NET.

  2. Desde el explorador de soluciones de su proyecto, haga clic con el botón derecho en el nodo Servicios conectados y seleccione Agregar > Microsoft Power Platform

    Captura de pantalla de los servicios conectados para agregar, con la opción Microsoft Power Platform resaltada

  3. Seleccione o introduzca los siguientes valores:

    • Entornos de Power Platform: select your developer environment
    • Soluciones de Power Platform: Common Data Service Default Solution
    • Conector personalizado: seleccione el ícono + e introduzca InventoryLocations_Connector

    Captura de pantalla de la configuración de servicios conectados

  4. En el campo Seleccione un túnel de desarrollo público, seleccione el ícono + y los siguientes valores:

    • Nombre: devtunnel
    • Tipo de túnel: Persistent
    • Acceso: Public

    Captura de pantalla de la configuración del túnel de desarrollo

  5. Seleccione Aceptar y Finalizar. Cuando se haya configurado el servicio conectado, puede seleccionar Cerrar.

    Captura de pantalla con el proceso finalizado para la configuración de servicios conectados

Ya ha creado un conector personalizado para ubicaciones de inventario que utiliza los túneles de desarrollo para conectar su API a Power Platform. Aquí, en el bucle interno, está ejecutando su API en el entorno local.

Ejecutar la API

Cuando Visual Studio ejecuta una aplicación web y hay un túnel activo, el navegador web abre una URL de túnel en lugar de una URL de localhost.

  1. Ejecute su solución de Visual Studio y comience la depuración.

    Captura de pantalla con el icono para ejecutar la depuración

  2. Cuando se abra el navegador, se abrirá una página de advertencia con la primera solicitud enviada a la URL del túnel. Seleccione Continuar.

    Captura de pantalla de la página de advertencia inicial

Importante

Recuerde que debe mantener la API en ejecución (en una pestaña del navegador) mientras crea su Power App.

Crear una aplicación desde la API

Nota

Para utilizar la aplicación de muestra proporcionada en este paso, deberá instalar Power Platform Tools para Visual Studio Code.

  1. Abra Visual Studio Code y cree una nueva autenticación para su usuario usando el comando de la CLI de Power Platform. Cambie la URL a la URL de su entorno de desarrollo, que se encuentra en el Centro de administración.

    pac auth create --url https://yourenvironment.crm.dynamics.com

  2. Obtenga el conector personalizado que ha creado. Copie el id. del conector.

    pac connector list

  3. Genere una aplicación de lienzo (archivo *.msapp), basada en las operaciones de su API.

    pac canvas create --connector-id your connector id --msapp your file name.msapp

Vista previa de la aplicación

  1. Abra Power Apps.

  2. Seleccione Aplicación vacía. En Aplicación de lienzo desde cero, seleccione Crear.

    Captura de pantalla del asistente Crear aplicación

  3. Introduzca el nombre de la aplicación Inventory app y seleccione el formato Tableta. Seleccione Crear.

    Captura de pantalla del asistente Crear aplicación, con la introducción del nombre de una aplicación

  4. En la barra de comandos, seleccione ... y Abrir.

    Captura de pantalla en la que se ve cómo abrir una aplicación existente

  5. Busque y abra al archivo *.msapp que ha creado en el paso 3. Esto cargará la aplicación de muestra en el estudio.

    Captura de pantalla de la opción Examinar archivos

  6. En la barra izquierda, seleccione el icono de datos y Agregar datos. Busque InventoryLocations_Connector y seleccione Conectar. Este es el conector personalizado que se ha creado a partir de la API web.

    Captura de pantalla en la que se observa cómo agregar el conector personalizado

  7. Para obtener una vista previa de esta aplicación, seleccione el icono para reproducir.

    Captura de pantalla del icono para obtener una vista previa de la aplicación

  8. Seleccione el botón de aplicación OBTENER para ver una lista de ubicaciones de inventario.

    Captura de pantalla de la vista previa de la aplicación

  9. Seleccione el icono para cerrar, en la parte superior derecha de la aplicación, a fin de volver a Studio. Seleccione el icono de publicación para guardar el trabajo.

    Captura de pantalla del icono de publicación

Sugerencia

  • ¿No se devuelve ningún país desde la API de muestra? Asegúrese de que la API se esté ejecutando mientras crea su aplicación.
  • Como está utilizando túneles de desarrollo, puede iterar su API en tiempo real, lo que incluye la depuración y la recarga en funcionamiento.

Ha terminado de crear una aplicación y un conector personalizado desde una API web.