Ejercicio: Implementar un desencadenador de sondeo

  • 10 minutos

En este ejercicio, agregará un desencadenador de sondeo al conector personalizado de una API de facturación de Contoso existente.

Importante

Utilice un entorno de prueba con Microsoft Dataverse aprovisionado. Si no dispone de ninguno, puede suscribirse al plan de la comunidad.

Tarea 1: Importar la solución con el conector personalizado

Nota

Puede continuar con el conector que creó y modificó en la Unidad 4: Implementar un desencadenador de webhook. Si ya completó ese ejercicio, puede pasar a la Tarea 2.

Nota

Para completar este ejercicio, descargue el siguiente archivo en su equipo local: Desencadenadores de Contoso Invoicing. Seleccione el botón de descarga en la parte central derecha de la pantalla.

En esta tarea, importará una solución no administrada que contiene un conector personalizado prediseñado para la API de Contoso Invoicing.

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

  2. Seleccione Soluciones > Importar.

  3. Seleccione Examinar.

  4. Seleccione la solución ContosoInvoicingTriggers_1_0_0_0.zip y luego elija Abrir.

  5. Seleccione Siguiente.

  6. Seleccione Importar y espere a que se complete la importación. Una vez que se complete la importación, debería recibir un mensaje para indicar que se ha realizado correctamente.

  7. Seleccione Publicar todas las personalizaciones y espere a que se complete la publicación.

  8. Abra la solución Desencadenadores de Contoso Invoicing que ha importado.

    Debería ver el componente de conector personalizado Desencadenadores de Contoso Invoicing.

    Captura de pantalla del componente Desencadenadores de facturación de Contoso resaltado

  9. Vaya a Facturación de Contoso.

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

    Captura de pantalla del vínculo de la clave de API resaltado

  11. Copie la Clave de API y péguela en un bloc de notas para usarla en el futuro.

  12. Regrese al portal del creador de Power Apps y asegúrese de que se encuentra en el entorno.

  13. Seleccione Soluciones y abra la solución Contoso invoicing triggers.

  14. Abra el conector personalizado Desencadenadores de facturación de Contoso.

  15. Seleccione Editar.

    Captura de pantalla de una flecha que apunta al botón para editar el conector

  16. Introduzca contosoinvoicing.azurewebsites.net en Host.

  17. Seleccione Actualizar conector.

  18. Seleccione Prueba > + Nuevo conector.

    Captura de pantalla de una flecha que apunta al botón para agregar una nueva conexión

  19. Pegue la Clave de API y luego seleccione Crear conexión.

    Captura de pantalla del botón Crear conexión

  20. Seleccione Actualizar. La conexión que creó debería seleccionarse automáticamente.

  21. Desplácese hacia abajo hasta la sección Operaciones, seleccione ListInvoice y luego elija Probar operación.

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

    Debería ver una lista de facturas en la sección Cuerpo.

    Captura de pantalla de una lista de facturas en la sección Cuerpo

  22. No se vaya de esta página.

Tarea 2: Agregar un desencadenador de sondeo

Si omitió la tarea anterior, vaya al conector personalizado Desencadenadores de facturación de Contoso y seleccione Editar.

  1. Seleccione Definición.

    Captura de pantalla de la pestaña Definición seleccionada

  2. Desplácese hacia abajo hasta la sección Desencadenadores y seleccione + Nuevo desencadenador.

  3. Indique los siguientes valores:

    • Resumen: Cuando se crea la factura (sondeo)

    • Descripción: Cuando se crea la factura (sondeo)

    • Id. de operación: InvoiceCreatedPoll

    • Tipo de desencadenador: Sondeo

    Captura de pantalla de las propiedades del desencadenador del conector

  4. Vaya a la sección Solicitud y seleccione + Importar desde ejemplo.

    Captura de pantalla de una flecha que apunta al botón Importar desde ejemplo

  5. Introduzca los valores siguientes y después seleccione Importar.

    • Verbo: GET

    • URL - https://contosoinvoicing.azurewebsites.net/ListInvoices?fromDate=

  6. Seleccione el botón de contenido adicional (puntos suspensivos) junto a fromDate y, después, seleccione Editar.

    Captura de pantalla de una flecha que apunta al botón para editar la consulta

  7. Seleccione interna en Visibilidad y luego elija el botón Atrás.

    Captura de pantalla de la opción de visibilidad del parámetro establecida en interna

  8. Desplácese hacia abajo hasta la sección Respuesta y seleccione + Agregar respuesta predeterminada.

  9. Pegue el siguiente código JSON en el campo Cuerpo y luego seleccione Importar.

     {
   "invoices": [
     {
       "invoiceId": "1933",
       "date": "2021-01-26T04:02:52.1490835Z",
       "createDate": "2021-01-25T04:02:52.1490835Z",
       "amount": 5000,
       "accountId": "1001",
       "accountName": "Wing Tips",
       "status": "Invoiced",
       "typeId": 1,
       "purchaseOrderId": "3002",
       "tags": "New Account;Special Pricing"
     }
   ]
 }

    Captura de pantalla de la respuesta predeterminada de la importación

  10. Vaya a la sección Configuración de desencadenador y proporcione los siguientes valores:

    • Seleccione un parámetro de consulta para supervisar el cambio de estado: fromDate

    • Especifique un valor que se pasará al parámetro de consulta seleccionado. Puede elegir expresiones - @{triggerBody().invoices[0].createDate}

    • Seleccione la colección que contiene los datos del desencadenador - @triggerBody().invoices

    Captura de pantalla de la sección Configuración de desencadenador con valores

  11. Seleccione el botón Actualizar conector que está ubicado en la parte superior de la pantalla y espere a que se actualice el conector.

Tarea 3: Probar el desencadenador

Si ya ha completado la Unidad 4: Implementar un desencadenador de webhook y ha creado el flujo de nube Crear factura, continúe en el paso 14.

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

  2. Seleccione Soluciones y abra la solución Contoso invoicing triggers.

  3. Seleccione + Nuevo > Flujo de nube.

  4. Introduzca Crear factura como nombre y seleccione Desencadenar un flujo manualmente para el desencadenador.

    Captura de pantalla de una flecha que apunta al desencadenador Desencadenar un flujo manualmente

  5. Seleccione + Agregar una entrada.

  6. Seleccione Número como tipo de entrada.

    Captura de pantalla de una flecha que apunta al tipo de entrada Número

  7. Escriba Importe como nombre de la entrada y seleccione Nuevo paso.

    Captura de pantalla de una flecha que apunta al botón para agregar un nuevo paso de flujo

  8. Seleccione la pestaña Personalizado y, a continuación, seleccione el conector personalizado Contoso Invoicing.

    Captura de pantalla de una flecha que apunta al conector personalizado

  9. Seleccione la acción Agregar factura.

  10. Introduzca Conexión de Contoso en el campo Nombre de la conexión, pegue la Clave de API que copió en la Tarea 1 y luego seleccione Crear.

    Captura de pantalla del botón para crear la conexión

  11. Seleccione el campo importe y, a continuación, Importe en el panel Contenido dinámico.

    Captura de pantalla de la salida del campo Importe del paso anterior

  12. Seleccione Guardar.

  13. Mantenga abierta esta pestaña o ventana del explorador.

  14. Abra una nueva ventana de explorador y vaya a https://make.powerapps.com/

  15. Asegúrese de que ha seleccionado el entorno correcto.

  16. Seleccione Soluciones y abra las soluciones Contoso Invoicing - Triggers.

  17. Seleccione + Nuevo > Automatización > Flujo de nube > Automatizado.

  18. Introduzca Sondeo de notificación de factura para el nombre y seleccione Omitir.

  19. Seleccione la pestaña Personalizado y, a continuación, seleccione el conector personalizado Contoso invoicing.

    Captura de pantalla de una flecha que apunta al desencadenador del conector personalizado

  20. Seleccione el desencadenador Cuando se crea la factura (sondeo).

    Captura de pantalla de una flecha que apunta a un desencadenador de conector personalizado

  21. Seleccione el botón ... Menú del desencadenador y asegúrese de que Referencias de la conexión está seleccionado.

    Captura de pantalla de la sección Referencias de la conexión

  22. Seleccione + Nuevo paso.

  23. Busque redactar y luego seleccione la acción Redactar.

  24. Seleccione el campo Entradas y, a continuación, cuerpo en el panel Contenido dinámico.

    Captura de pantalla del campo Entradas y el cuerpo en el panel Contenido dinámico

  25. Seleccione Guardar y luego espere a que se guarde el flujo.

  26. Seleccione Probar.

  27. Seleccione Manualmente > Probar. El flujo comenzará y deberá esperar las notificaciones.

  28. Cambie a la pestaña o ventana del navegador del flujo Crear factura.

  29. Seleccione Probar.

  30. Seleccione Manualmente > Probar.

  31. Introduzca 6500 como Importe y luego seleccione Ejecutar flujo.

  32. Seleccione Listo.

  33. El flujo debería ejecutarse correctamente. Seleccione Editar.

    Captura de pantalla del flujo correcto con el icono de edición

  34. Seleccione Probar de nuevo.

  35. Seleccione Manualmente > Probar.

  36. Introduzca 8800 como Importe y luego seleccione Ejecutar flujo.

  37. Seleccione Listo. Una vez más, el flujo debería ejecutarse correctamente.

  38. Cambie al flujo Sondeo de notificación de factura. Este flujo debería ejecutarse correctamente.

    Nota

    A diferencia de un desencadenador de webhook, puede llevar alrededor de un minuto averiguar si el flujo se ejecutó correctamente o no.

  39. Seleccione la opción para expandir el paso de la acción Redactar.

    Captura de pantalla de una flecha que apunta a la acción de flujo Redactar

  40. Revise los valores de Salidas y, a continuación, seleccione el botón.

    Captura de pantalla de las salidas de la acción de flujo Redactar

    Debería ver dos resultados de ejecución para las dos facturas que creó.

    Captura de pantalla de los detalles del historial de ejecución del flujo