Ejercicio: Crear un nuevo conector en una solución

  • 5 minutos

En este ejercicio, creará su primer conector personalizado para una API existente llamada Contoso Invoicing.

Importante

Utilice un entorno de prueba con Microsoft Dataverse aprovisionado. Si no dispone de ningún entorno de prueba, puede suscribirse al Plan de la comunidad de Power Apps.

Tarea 1: Revisar la API

Para revisar la API, siga estos pasos:

  1. Vaya a Facturación de Contoso.

  2. Seleccione el vínculo a la documentación.

    Captura de pantalla con una flecha que apunta al vínculo de la documentación de la API

  3. Revise las operaciones disponibles.

  4. Seleccione para expandir y revisar cada operación.

  5. Cierre la pestaña o ventana del navegador de la documentación.

  6. Seleccione el vínculo de la Definición de Open API.

  7. En la siguiente imagen se muestra un ejemplo de la versión de OpenAPI de lo que se mostró en la página de documentación. Haga clic con el botón derecho y seleccione Guardar como.

    Captura de pantalla que muestra una flecha que apunta al botón Guardar como

  8. Guarde el archivo de forma local. Este archivo se usará más adelante en este ejercicio.

  9. Cierre la ventana o pestaña del navegador de la definición.

  10. Seleccione el vínculo de la Clave de API.

  11. Copie y guarde su clave de API, porque la necesitará más adelante.

    Captura de pantalla de la clave de API de Contoso Invoicing

  12. Seleccione Volver a la página principal.

  13. Seleccione Descargar logotipo.

  14. Guarde la imagen del logotipo localmente; la usará más tarde.

Tarea 2: Crear una nueva solución

Para crear una nueva solución, siga estos pasos:

  1. Vaya a Power Apps Maker Portal y asegúrese de que se encuentra en el entorno correcto.

  2. Seleccione Soluciones > + Nueva solución.

  3. Introduzca Facturación de Contoso como Nombre para mostrar, seleccione CDS Default Publisher como Editor y luego elija Crear. Cuando trabaje con un proyecto real, es mejor crear su propio editor.

    Captura de pantalla sobre la creación de una nueva solución de Contoso Invoicing

  4. No navegue fuera de esta página después de seleccionar Crear.

Tarea 3: Crear un conector nuevo

Para crear un nuevo conector, siga estos pasos:

  1. Abra la solución Contoso invoicing que ha creado.

  2. Seleccione + Nuevo > Automatización > Conector personalizado.

    Captura de pantalla de una flecha que apunta para crear una nueva conexión personalizada

  3. Introduzca Facturación de Contoso como Nombre de conector y luego seleccione Cargar la imagen.

    Captura de pantalla con una flecha que apunta al botón para cargar la imagen del icono

  4. Seleccione la imagen del logotipo del conector que descargó en la Tarea 1: Revisar la API.

  5. Introduzca #175497 como Color de fondo del icono.

  6. Introduzca API de facturación de Contoso como Descripción.

  7. Introduzca contosoinvoicingtest.azurewebsites.net como Host.

  8. Seleccione Crear conector.

    Captura de pantalla de una flecha que apunta al botón para crear un conector

  9. No se vaya de esta página.

Tarea 4: Importar la definición de OpenAPI

Siga estos pasos para importar la definición de OpenAPI:

  1. Seleccione la flecha junto al Nombre del conector.

    Captura de pantalla que muestra una flecha que apunta al botón Atrás

  2. Seleccione los puntos suspensivos (...) del conector y luego seleccione Actualizar desde el archivo OpenAPI.

    Captura de pantalla de una flecha que apunta al botón Actualizar desde el archivo OpenAPI.

  3. Seleccione Importar.

  4. Seleccione el archivo swagger.json que descargó en Tarea 1: Revisar la API y luego seleccione Abrir.

  5. Seleccione Continuar.

  6. Complete la URL del host como contosoinvoicingtest.azurewebsites.net y luego seleccione Seguridad.

    Captura de pantalla que muestra una flecha que apunta a la pestaña Seguridad

  7. Observe que el campo se completa desde el archivo importado.

  8. No se vaya de esta página.

Tarea 5: Revisar y ajustar las definiciones

Para revisar y ajustar las definiciones, siga estos pasos:

  1. Seleccione la pestaña Definición.

  2. Tómese unos minutos para revisar las operaciones que se importaron.

  3. Observe el triángulo naranja junto a GetInvoice que indica una advertencia.

  4. Seleccione la operación GetInvoice.

    Captura de pantalla de una flecha que apunta a la acción para obtener factura

  5. Observe que la operación indica que falta un Resumen.

  6. Introduzca Obtener factura como Resumen para mejorar la usabilidad.

    Captura de pantalla del resumen de la acción para obtener factura

  7. Observe el círculo informativo azul en la operación PayInvoice que indica que falta una Descripción.

  8. Introduzca Pagar una factura como Descripción.

  9. Eliminar ambas operaciones NewInvoice, porque no las usará.

    Captura de pantalla que muestra una flecha que apunta al botón Eliminar

  10. Seleccione la operación GetInvoiceSchema.

  11. Modifique la opción Visibilidad a interna para que nadie la vea en su lista de acciones.

  12. Seleccione Actualizar conector.

    Captura de pantalla de una flecha que apunta al botón Actualizar conector

  13. No se vaya de esta página.

Tarea 6: Probar el conector

Para probar el conector, siga estos pasos:

  1. Seleccione la pestaña Prueba.

  2. Seleccione + Nueva conexión.

    Captura de pantalla de una flecha que apunta al botón Nueva conexión

  3. Pegue la Clave de API que guardó en la Tarea 1: Revisar la API y luego seleccione Crear conexión.

  4. Seleccione el botón Actualizar.

    Captura de pantalla que muestra una flecha que apunta al botón Actualizar

  5. Seleccione ListInvoiceTypes > Probar operación.

    Captura de pantalla de una flecha que apunta al botón Probar operación

Debería ver algunos datos de la factura en el área del cuerpo.