Realizar operaciones

  • 11 minutos

Además de las operaciones básicas para crear, actualizar, eliminar y consultar datos de Dataverse también hay otras acciones personalizadas que se pueden utilizar. Estas acciones pueden ser una lógica de utilidad genérica como AISummarize o lógica personalizada específica para una solución. Por ejemplo, es posible que tenga una acción ScheduleVisit y cuando la llamaran, buscaría un técnico disponible y la asignaría a la visita. Al utilizar acciones, puede proporcionar información de entrada y puede devolver resultados como salida. Por lo general, no se tiene que preocupar por la lógica utilizada internamente por la acción para realizar la tarea. Una ventaja significativa de acciones como esta es que múltiples flujos y aplicaciones pueden usarlos, y constantemente hacen el trabajo de la misma manera. Si es necesario un cambio en la lógica, solo tiene que cambiar la acción y luego todas las aplicaciones y flujos aprovecharán el cambio.

Estas acciones pueden ser nativas de Dataverse, creadas por desarrolladores de código mediante la función de API de Dataverse personalizada o hechas mediante complementos con poco código con Power Fx. Cuando utiliza una acción para crear su flujo de nube, no necesariamente sabe cómo se creó, solo que está disponible para que la incluya en su flujo de nube. Las acciones se pueden utilizar para hacer cambios en los datos, como crear o actualizar filas en Dataverse, o simplemente pueden contener lógica reutilizable.

Las acciones pueden estar enlazadas o sin enlazar. Las acciones enlazadas tienen como objetivo una fila de tabla específica. Cuando utiliza una acción enlazada, debe proporcionar una referencia a la fila de esa tabla. Las acciones sin enlazar no están vinculadas a una tabla específica y se usan sin el contexto de una tabla o fila específica. El conector de Dataverse tiene dos operaciones, Realizar una acción enlazada y Realizar una acción sin enlazar, que puede utilizar para invocar las acciones. Cuando crea su flujo de nube, elige una acción enlazada o una acción sin enlazar para ese paso.

Captura de pantalla que muestra la acción Realizar una acción sin enlazar

Un creador con poco código podría utilizar un complemento con poco código para crear una acción para hacer un cálculo. Por ejemplo, utilizar entradas de columnas de moneda seleccionadas de una tabla para calcular un índice de endeudamiento. A partir de ahí, se podría agregar lógica para hacer cumplir la directiva en función de los resultados de los cálculos. En el siguiente ejemplo, puede ver una acción sin enlazar en Power Automate para hacer esto.

Captura de pantalla que muestra el botón Guardar

En el siguiente ejercicio, utilizará una acción en un flujo de nube para enviar un correo electrónico semanal con información resumida sobre las recaudaciones de fondos activas. Primero debe crear la acción como un complemento con poco código.

Ejercicio: crear un complemento con poco código y usarlo desde un flujo de nube

En este ejercicio, creará un complemento instantáneo con poco código que calcula las donaciones promedio para una recaudación de fondos. Luego invoca esta lógica desde un flujo de nube.

Requisitos previos

Acceda a un entorno con Dataverse con aplicaciones de muestra instaladas si desea hacer el siguiente ejercicio.

Tarea: Crear el complemento con poco código

  1. Vaya a Power Platform Maker Portal y seleccione el entorno correcto.

  2. Seleccione Aplicaciones en la navegación izquierda, Todas y luego inicie la Dataverse Accelerator App.

    Captura de pantalla que muestra la Dataverse Accelerator App

  3. Seleccione Crear complemento instantáneo.

  4. Introduzca Calcular donación promedio para Nombre para mostrar y luego seleccione el botón Nuevo parámetro de entrada .

    Captura de pantalla que muestra el botón para agregar un nuevo parámetro de entrada

  5. Introduzca TargetFundraiser para Etiqueta, seleccione EntityReference para Tipo de datos, luego sample_fundraiser y, por último, el botón Nuevo parámetro de salida .

    Captura de pantalla que muestra el botón para agregar un nuevo parámetro de salida

  6. Introduzca AverageDonation para Etiqueta y seleccione Decimal para Tipo de datos.

  7. Pegue esta expresión en el campo Expresión y luego seleccione el botón Guardar.

    {AverageDonation: LookUp(Fundraisers, sample_fundraiserid = TargetFundraiser.sample_fundraiserid).'Total Donations' / CountIf(Donations, Regarding = TargetFundraiser)}

    Captura de pantalla que muestra la expresión

  8. Ahora obtiene un id. de recaudación de fondos que puede usar para probar el complemento. Inicie una nueva sesión del navegador, vaya a Power Platform Maker Portal y seleccione el entorno correcto.

  9. Seleccione Aplicaciones en la navegación izquierda, Todas y luego inicie la Aplicación Fundraiser.

  10. Seleccione Recaudación de fondos en la navegación izquierda y abra el Fondo de becas.

  11. Vaya a la URL y copie el id. de esta recaudación.

    Captura de pantalla que muestra el id. del registro

  12. Puede cerrar la aplicación Fundraiser.

  13. Vuelva al complemento y seleccione el botón Probar.

  14. Pegue el id. que ha copiado en el campo Valor y luego seleccione Ejecutar.

    Captura de pantalla con el botón Ejecutar prueba

  15. El complemento debería ejecutarse correctamente y devolver la donación promedio.

    Captura de pantalla que muestra el resultado del complemento

  16. Puede cerrar la Dataverse Accelerator App.

Tarea: Crear flujo y usar el complemento

En esta tarea, utiliza el complemento que creó.

  1. Navegue a Power Automate y seleccione el mismo entorno en el que creó el complemento.

  2. Seleccione Crear en el panel de navegación izquierdo y, después, seleccione Flujo de nube programado.

    Captura de pantalla que muestra el botón Crear flujo de nube programado

  3. Introduzca Informe semanal de recaudación de fondos para el nombre del flujo, seleccione repetir 1 cada semana y ejecutarlo los lunes, y luego seleccione Crear.

    Captura de pantalla que muestra el cuadro de diálogo Crear flujo

  4. Seleccione el botón Insertar un nuevo paso y Agregar una acción.

    Captura de pantalla que muestra el botón Agregar una acción

  5. Busque Enumerar filas y seleccione Enumerar filas en el conector de Microsoft Dataverse. Siga las instrucciones para crear la conexión si es necesario.

  6. Cambie el nombre de la acción a Enumerar recaudaciones de fondos, seleccione Recaudaciones de fondos para Nombre de la tabla.

    Captura de pantalla con la acción Enumerar filas

  7. Seleccione el botón Insertar un nuevo paso y Agregar una acción.

  8. Busque inicializar y luego seleccione Inicializar variable.

  9. Cambie el nombre de la acción a Inicializar promedios, introduzca Promedios de donación para Nombre y seleccione Matriz para Tipo.

    Captura de pantalla que muestra la acción Inicializar variable

  10. Seleccione el botón Insertar un nuevo paso y Agregar una acción.

  11. Busque Realizar una acción sin enlazar y seleccione Realizar una acción sin enlazar desde el conector de Microsoft Dataverse.

  12. Cambie el nombre del paso a Calcular promedio, seleccione el complemento CaluculateAverageDonation que creó para Nombre de la acción y luego seleccione el botón Mostrar todo.

    Captura de pantalla que muestra la acción sin enlazar

  13. Escriba / en el campo Item/TargetFundraiser/Sample_fundraiser y luego seleccione Insertar contenido dinámico.

    Captura de pantalla que muestra la opción Insertar contenido dinámico

  14. Busque fondos y seleccione Fundraiser en el panel de contenido dinámico.

    Captura de pantalla que muestra el identificador único de recaudación de fondos

  15. Power Automate crea un For each y coloca la acción Calcular promedio dentro de For each.

  16. Seleccione For each y cámbiele el nombre a For each fundraiser.

  17. Seleccione el botón Insertar un nuevo paso ubicado debajo de la acción Crear promedio y luego seleccione Agregar una acción.

    Captura de pantalla que muestra los For each creados y luego el botón para agregar una acción

  18. Busque Anexar y seleccione la acción Anexar a la variable de matriz.

  19. Cambie el nombre de la acción Anexar a los promedios de donaciones, seleccione Promedios de donaciones para Nombre y pegue este JSON en el campo Valor. Agregue los valores dinámicos a este JSON.

    {"Name":, "Total Donation":, "Average Donation":}

  20. Escriba / después de "Name": y luego seleccione Insertar contenido dinámico.

    Captura de pantalla que muestra la acción de anexar a matriz y la opción de insertar contenido dinámico

  21. Seleccione Name desde el panel de contenido dinámico.

  22. Escriba / después de "Total Donation": y luego seleccione Insertar contenido dinámico.

  23. Seleccione Total Donations en el panel de contenido dinámico.

  24. Escriba / después de "Average Donation": y luego seleccione Insertar contenido dinámico.

  25. Seleccione AverageDonation en el panel de contenido dinámico.

  26. For each ahora debería verse como esta imagen. Seleccione el botón Insertar un nuevo paso fuera de la acción For each fundraiser y luego seleccione Agregar una acción.

    Captura de pantalla que muestra el botón Agregar una acción fuera de For each

  27. Busque una tabla HTML y seleccione Crear tabla HTML desde el conector de operación de datos.

  28. Escriba / en el campo From y luego seleccione Insertar contenido dinámico.

  29. Seleccione Donation averages en el panel de contenido dinámico.

  30. Seleccione el botón Insertar un nuevo paso ubicado después de la acción Crear tabla HTML y luego seleccione Agregar una acción.

    Captura de pantalla con el botón Agregar una acción después de la acción Crear tabla HTML

  31. Busque enviar correo electrónico y seleccione Enviar correo electrónico (V2). Siga las instrucciones para crear la conexión si es necesario.

  32. Cambie el nombre de la acción de envío de correo electrónico Enviar informe, proporcione el correo electrónico de su usuario para Para, escriba Informe de recaudación de fondos como Asunto.

  33. Escriba / en el campo Body y seleccione Insertar contenido dinámico.

  34. Seleccione Output de Crear tabla HTML desde el panel de contenido dinámico.

    Captura de pantalla que muestra el cuerpo del correo electrónico

  35. Seleccione Guardar y espere a que se guarde el flujo.

  36. No se vaya de esta página.

Tarea: Probar el flujo

  1. Seleccione el botón Probar.

    Captura de pantalla que muestra el botón Probar flujo

  2. Seleccione Manualmente y después Probar.

  3. Seleccione Ejecutar flujo.

  4. Seleccione Listo.

  5. La ejecución de flujo debería ser correcta.

    Captura de pantalla que muestra una ejecución de flujo correcta

  6. Vaya a Outlook.

  7. Debería recibir el correo electrónico con el informe de recaudación de fondos que envía el flujo.

  8. El informe debería parecerse a este correo electrónico.

    Captura de pantalla que muestra el informe