Conexión a Microsoft Dataverse desde flujos de trabajo en Azure Logic Apps

Se aplica a: Azure Logic Apps (Consumo + Estándar)

Para automatizar las tareas que funcionan con la base de datos de Microsoft Dataverse, puede usar el conector de Microsoft Dataverse con flujos de trabajo en Azure Logic Apps.

Por ejemplo, puede crear flujos de trabajo que creen filas, actualicen filas y realicen otras operaciones. También puede obtener información de la base de datos de Dataverse y hacer que la salida esté disponible para otras acciones que se usarán en los flujos de trabajo. Por ejemplo, cuando se agrega, actualiza o elimina una fila en la base de datos de Dataverse, puede enviar un correo electrónico mediante el conector de Office 365 Outlook.

El conector de Dataverse se conocía anteriormente como conector de Common Data Service 2.0 y originalmente conocido como conector de Dynamics 365. Puede usar el conector de Dataverse para acceder a Microsoft Dataverse para Microsoft Dynamics 365 Sales, Microsoft Dynamics 365 Customer Service, Microsoft Dynamics 365 Field Service, Microsoft Dynamics 365 Customer Insights - Journeys y Microsoft Dynamics 365 Project Service Automation.

En este artículo se muestra cómo agregar un desencadenador o una acción de Dataverse al flujo de trabajo y cómo funcionan las opciones de parámetro.

Referencia de conectores

Para obtener información técnica basada en la descripción de Swagger del conector, como operaciones, límites y otros detalles, consulte la página de referencia del conector administrado.

Prerrequisitos

• Una cuenta y una suscripción de Azure. Si no tiene una suscripción, regístrese para obtener una cuenta gratuita de Azure.

• Un entorno y una base de datos de Dataverse Data Service, que es donde su organización almacena, administra y comparte datos empresariales en una base de datos de Dataverse. Para obtener más información, consulte los siguientes recursos:

  • Más información: Creación y administración de entornos de Dataverse

  • Información general de Power Platform - Entornos

• Conocimientos básicos sobre Azure Logic Apps junto con el recurso y flujo de trabajo de la aplicación lógica de Consumo o Estándar desde donde desea acceder a su base de datos de Dataverse. Para usar un desencadenador de Dataverse, necesita un flujo de trabajo en blanco. Para usar una acción de Dataverse, necesita un flujo de trabajo que comience con cualquier desencadenador adecuado para su escenario.

  Para obtener más información, consulte los siguientes recursos:

  • Creación de un flujo de trabajo de aplicaciones lógicas de consumo de ejemplo

  • Creación de un flujo de trabajo de aplicación lógica estándar de ejemplo

Adición de un desencadenador de Dataverse

En función de si tiene un flujo de trabajo de aplicación lógica de Consumo o Estándar, siga los pasos correspondientes:

Agregar una acción de Dataverse

En función de si tiene un flujo de trabajo de aplicación lógica de Consumo o Estándar, siga los pasos correspondientes:

Prueba del flujo de trabajo

Para ejecutar el flujo de trabajo, siga estos pasos:

1. En la barra de herramientas del diseñador, seleccione Ejecutar>Ejecutar.

2. Reproduzca las condiciones que requiere el desencadenador para que se ejecute el flujo de trabajo.

Devolver filas basadas en un filtro

Para las acciones que devuelven filas, como la acción Enumerar filas , puede usar una consulta ODATA que devuelva filas basadas en el filtro especificado. Por ejemplo, puede configurar la acción para devolver solo las filas de las cuentas activas.

1. En el diseñador, en la acción, abra la lista Parámetros avanzados y seleccione el parámetro Filtrar filas .

   

2. En el parámetro Filtrar filas que aparece ahora en la acción, escriba una expresión de consulta ODATA, por ejemplo:

   statuscode eq 1

   

Para más información, consulte la siguiente documentación:

• Lista de filas
• $filter opciones de consulta del sistema

Devolver filas basadas en un criterio de ordenación

Para las acciones que devuelven filas, como la acción Enumerar filas , puede usar una consulta ODATA que devuelva filas en una secuencia específica, que varía en función de las filas que devuelve la acción. Por ejemplo, puede configurar la acción para devolver filas organizadas por el nombre de la cuenta.

1. En el diseñador, en la acción, abra la lista Parámetros avanzados y seleccione el parámetro Ordenar por .

   

2. En el parámetro Ordenar por que aparece ahora en la acción, escriba el nombre de columna que se usará para ordenar, por ejemplo, nombre:

   

Para más información, consulte la siguiente documentación:

• Lista de filas
• $orderby opciones de consulta del sistema

Tipos de datos de campo

En un desencadenador o una acción, el tipo de datos de un valor de campo debe coincidir con el tipo de datos necesario del campo. Este requisito se aplica si especifica manualmente el valor o selecciona el valor de la lista de contenido dinámico.

Por ejemplo, supongamos que tiene una tabla denominada Tasks. Esta tabla tiene campos que solo se aplican a esa tabla, mientras que otras tablas tienen sus propios campos. En la tabla Tasks de ejemplo, en la tabla siguiente se describen algunos tipos de campo de ejemplo y los tipos de datos que esos campos requieren para sus valores.

En la tabla Tasks de ejemplo, supongamos que usa la acción Agregar una nueva fila para crear una nueva fila asociada a otras filas de entidad, específicamente una fila de usuario y una fila de cuenta. Por lo tanto, en esta acción, debe especificar los identificadores y los tipos de búsqueda para esas filas de entidad mediante el uso de valores que coincidan con los tipos de datos esperados para las propiedades pertinentes.

• En función de la propiedad Owner , que especifica un identificador de usuario y la propiedad Owner Type , que especifica el systemusers tipo de búsqueda, la acción asocia la nueva fila con un usuario específico.

• En función de la propiedad Regarding , que especifica un identificador de fila y la propiedad Regarding Type , que especifica el accounts tipo de búsqueda, la acción asocia la nueva fila a una cuenta específica.

La acción resultante es similar al ejemplo siguiente:

Solución de problemas

Llamadas desde varios entornos

El conector de Dataverse almacena información sobre los flujos de trabajo de las aplicaciones lógicas que obtienen y requieren notificaciones sobre los cambios de entidad de base de datos mediante la entidad callbackregistrations en su base de datos de Dataverse. Si copia una organización de Dataverse, también se copian los webhooks. Si copia la organización antes de deshabilitar los flujos de trabajo que están asignados a esta, los webhooks copiados también apuntarán a los mismos flujos de trabajo de aplicaciones lógicas que, a su vez, recibirán notificaciones de varias organizaciones.

Para detener las notificaciones no deseadas, elimine la callbackregistrations entidad de la organización que envía esas notificaciones siguiendo estos pasos:

1. Identifique e inicie sesión en la organización de Dataverse desde donde desea quitar las notificaciones.

2. En el explorador Chrome, busque el registro de devolución de llamada que desea eliminar.

   1. Revise la lista genérica de todos los registros de devolución de llamada en el siguiente URI de OData para que pueda ver los datos dentro de la entidad callbackregistrations:

      https://{organization-name}.crm{instance-number}.dynamics.com/api/data/v9.0/callbackregistrations:

      Nota:

      Si no se devuelve ningún valor, es posible que no tenga permisos para ver este tipo de entidad o que no haya iniciado sesión en la organización correcta.

   2. Filtre por el nombre lógico de la entidad desencadenadora entityname y el evento de notificación que coincida con el flujo de trabajo de la aplicación lógica (mensaje). Cada tipo de evento se asigna al entero de mensaje de la siguiente manera:

      Tipo de evento	Mensaje entero
      Create	1
      Delete	2
      Update	3
      CreateOrUpdate	4
      CreateOrDelete	5
      ActualizarOEliminar	6
      CrearActualizarOEliminar	7

      En el siguiente ejemplo se muestra cómo filtrar por las notificaciones Create en una entidad llamada nov_validation mediante el siguiente URI de OData en una organización de ejemplo:

      https://fabrikam-preprod.crm1.dynamics.com/api/data/v9.0/callbackregistrations?$filter=entityname eq 'nov_validation' and message eq 1

      

      Nota:

      Si existen varios desencadenadores para la misma entidad o evento, puede filtrar la lista mediante filtros adicionales, como los createdon atributos y _owninguser_value . El nombre del usuario propietario aparece en /api/data/v9.0/systemusers({id}).

   3. Después de encontrar el identificador del registro de devolución de llamada que desea eliminar, siga estos pasos:

      1. En el explorador Chrome, abra Chrome Developer Tools (Teclado: F12).

      2. En la ventana, en la parte superior, seleccione la pestaña Consola .

      3. En el símbolo de la línea de comandos, escriba este comando, que envía una solicitud para eliminar el registro de devolución de llamada especificado:

         fetch('http://{organization-name}.crm{instance-number}.dynamics.com/api/data/v9.0/callbackregistrations({ID-to-delete})', { method: 'DELETE'})

         Importante

         Asegúrese de realizar la solicitud desde una página de interfaz de cliente no unificada (UCI), por ejemplo, desde la propia página de respuesta de OData o API. De lo contrario, la lógica del archivo app.js podría interferir con esta operación.

   4. Para confirmar que el registro de devolución de llamada ya no existe, consulte la lista de registros de devolución de llamada.

Entidad ‘callbackregistrations’ duplicada

En flujos de trabajo estándar, en condiciones específicas, como la reasignación de instancias o el reinicio de la aplicación, el desencadenador de Microsoft Dataverse inicia una ejecución duplicada, que crea una entidad duplicada callbackregistrations en la base de datos de Dataverse. Si edita un flujo de trabajo estándar que comienza con un desencadenador de Dataverse, compruebe si esta callbackregistrations entidad está duplicada. Si el duplicado existe, elimine manualmente la entidad duplicada callbackregistrations .

Contenido relacionado

• Conectores administrados para Azure Logic Apps
• Conectores integrados para Azure Logic Apps
• ¿Qué son los conectores en Azure Logic Apps?