Se connecter à Microsoft Dataverse à partir de flux de travail dans Azure Logic Apps

S’applique à : Azure Logic Apps (Consommation + Standard)

Pour automatiser les tâches qui fonctionnent avec votre base de données Microsoft Dataverse, vous pouvez utiliser le connecteur Microsoft Dataverse avec des flux de travail dans Azure Logic Apps.

Par exemple, vous pouvez créer des flux de travail qui créent des lignes, mettent à jour des lignes et effectuent d’autres opérations. Vous pouvez également obtenir des informations à partir de votre base de données Dataverse et rendre la sortie disponible pour d’autres actions à utiliser dans vos flux de travail. Par exemple, lorsqu’une ligne est ajoutée, mise à jour ou supprimée dans votre base de données Dataverse, vous pouvez envoyer un e-mail à l’aide du connecteur Office 365 Outlook.

Le connecteur Dataverse était précédemment appelé connecteur Common Data Service 2.0 et connu à l’origine comme connecteur Dynamics 365. Vous pouvez utiliser le connecteur Dataverse pour accéder à Microsoft Dataverse pour Microsoft Dynamics 365 Sales, Microsoft Dynamics 365 Customer Service, Microsoft Dynamics 365 Field Service, Microsoft Dynamics 365 Customer Insights - Journeys et Microsoft Dynamics 365 Project Service Automation.

Ce guide montre comment ajouter un déclencheur ou une action Dataverse à votre flux de travail et comment fonctionnent les options de paramètre.

Informations de référence sur les connecteurs

Pour obtenir des informations techniques basées sur la description Swagger du connecteur, telles que les opérations, les limites et d’autres détails, consultez la page de référence du connecteur managé.

Prerequisites

• Un compte et un abonnement Azure. Obtenez un compte Azure gratuit.

• Environnement et base de données Dataverse Data Service, où votre organisation stocke, gère et partage des données métier dans une base de données Dataverse.

  Pour plus d’informations, consultez :

  • Découvrir : Créer et gérer des environnements Dataverse
  • Power Platform - Présentation des environnements

  Note

  Certains scénarios peuvent nécessiter l’activation des restrictions d’accès sur votre ressource d’application logique pour contrôler l’accès entrant à partir de réseaux publics. Si vous autorisez la communication entrante à partir de Power Platform à déclencher votre flux de travail à l’aide de la balise de service PowerPlatformInfra , veillez à utiliser la version non régionale.

• Connaissance de base d’Azure Logic Apps, ainsi que de la ressource consommation ou de l’application logique standard et du flux de travail à partir duquel vous souhaitez accéder à votre base de données Dataverse. Pour utiliser un déclencheur Dataverse, vous avez besoin d’un flux de travail vide. Pour utiliser une action Dataverse, vous avez besoin d’un flux de travail qui commence par n’importe quel déclencheur approprié pour votre scénario.

  Pour plus d’informations, consultez :

  • Créer un workflow d’application logique de consommation
  • Créer un exemple de flux de travail d’application logique standard

Ajouter un déclencheur Dataverse

En fonction du flux de travail d’application logique dont vous disposez (Consommation ou Standard), suivez la procédure correspondante :

1. Sur le Portail Azure, ouvrez votre flux de travail d’application logique dans le Concepteur.

2. Suivez les étapes générales pour ajouter le déclencheur Microsoft Dataverse approprié pour votre scénario.

   Cet exemple continue avec le déclencheur nommé Lorsqu’une ligne est ajoutée, modifiée ou supprimée.

3. À l’invite, connectez-vous à votre environnement ou base de données Dataverse.

4. Dans la zone d’informations du déclencheur, fournissez les valeurs de paramètre nécessaires.

   L’exemple suivant montre l’exemple de déclencheur :

   

5. Lorsque vous avez terminé, enregistrez votre flux de travail. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.

6. Ajoutez maintenant au moins une action pour votre flux de travail à effectuer lorsque le déclencheur se déclenche.

   Par exemple, vous pouvez ajouter une action Dataverse ou une action qui envoie des e-mails en fonction des sorties du déclencheur.

Ajouter une action Dataverse

1. Sur le Portail Azure, ouvrez votre flux de travail d’application logique dans le Concepteur.

2. Suivez les étapes générales pour ajouter l’action Microsoft Dataverse appropriée pour votre scénario.

   Cet exemple continue avec l’action nommée Ajouter une nouvelle ligne.

3. À l’invite, connectez-vous à votre environnement ou base de données Dataverse.

4. Dans la zone d’informations d’action, fournissez les valeurs de paramètre nécessaires.

   L’exemple suivant montre l’exemple d’action :

   

5. Lorsque vous avez terminé, enregistrez votre flux de travail. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.

6. Ajoutez d’autres actions si vous le souhaitez.

Tester votre workflow

Pour exécuter votre flux de travail, procédez comme suit :

1. Dans la barre d’outils du concepteur, sélectionnez Exécuter>Exécuter.

2. Reproduire les conditions requises par le déclencheur pour que votre flux de travail s’exécute.

Retourner des lignes en fonction d’un filtre

Pour les actions qui retournent des lignes, telles que l’action Lister les lignes , utilisez une requête ODATA pour retourner des lignes en fonction du filtre spécifié. Par exemple, configurez l’action pour retourner uniquement des lignes pour les comptes actifs.

1. Dans le concepteur, dans l’action, ouvrez la liste des paramètres avancés , puis sélectionnez le paramètre Filtrer les lignes .

   

2. Dans le paramètre Filtrer les lignes qui apparaît maintenant dans l’action, entrez une expression de requête ODATA, par exemple :

   statuscode eq 1

   

Pour plus d’informations, consultez la documentation suivante :

• Lister les lignes
• $filter options de requête système

Retourner des lignes en fonction d’un ordre de tri

Pour les actions qui retournent des lignes, telles que l’action De lignes de liste , utilisez une requête ODATA pour retourner des lignes dans une séquence spécifique. La séquence varie en fonction des lignes retournées par l’action. Par exemple, vous pouvez configurer l’action pour retourner des lignes organisées par le nom du compte.

1. Dans le concepteur, dans l’action, ouvrez la liste des paramètres avancés , puis sélectionnez le paramètre Trier par .

   

2. Dans le paramètre Sort By qui apparaît maintenant dans l’action, entrez le nom de colonne à utiliser pour le tri, tel que le nom :

   

Pour plus d’informations, consultez la documentation suivante :

• Lister les lignes
• $orderby options de requête système

Types de données de champ

Dans un déclencheur ou une action, le type de données d’une valeur de champ doit correspondre au type de données requis du champ. Cette exigence s’applique si vous entrez manuellement la valeur ou sélectionnez-la dans la liste de contenu dynamique.

Par exemple, supposons que vous disposez d’une table nommée Tasks. Cette table comporte des champs qui s’appliquent uniquement à cette table, tandis que d’autres tables ont leurs propres champs. Pour l’exemple de tableau Tâches , le tableau suivant décrit certains exemples de types de champs et les types de données requis par ces champs pour leurs valeurs.

Pour l’exemple de table Tâches , supposons que vous utilisez l’action Ajouter une nouvelle ligne pour créer une ligne associée à d’autres lignes d’entité, en particulier une ligne utilisateur et une ligne de compte. Par conséquent, dans cette action, vous devez spécifier les ID et les types de recherche pour ces lignes d’entité à l’aide de valeurs qui correspondent aux types de données attendus pour les propriétés pertinentes.

• En fonction de la propriété Owner , qui spécifie un ID d’utilisateur et la propriété Owner Type , qui spécifie le systemusers type de recherche, l’action associe la nouvelle ligne à un utilisateur spécifique.

• En fonction de la propriété Regarding , qui spécifie un ID de ligne et la propriété Regarding Type , qui spécifie le accounts type de recherche, l’action associe la nouvelle ligne à un compte spécifique.

L’action résultante ressemble à l’exemple suivant :

Résolution des problèmes

Appels de plusieurs environnements

Le connecteur Dataverse stocke des informations sur les flux de travail de logic app qui requièrent des notifications concernant les modifications des entités de base de données en utilisant l’entité callbackregistrations dans votre base de données Dataverse. Si vous copiez une organisation Dataverse, tous les webhooks sont automatiquement copiés. Si vous copiez votre organisation avant de désactiver les flux de travail mappés à votre organisation, les webhooks copiés pointent vers les mêmes flux de travail d’application logique. Ces flux de travail reçoivent ensuite des notifications de plusieurs organisations.

Pour arrêter les notifications indésirables, supprimez l’entité callbackregistrations de l’organisation qui envoie ces notifications en procédant comme suit :

1. Identifiez et connectez-vous à l’organisation Dataverse à partir de laquelle vous souhaitez supprimer des notifications.

2. Dans le navigateur Chrome, recherchez l’inscription de rappel à supprimer.

   1. Passez en revue la liste générique de toutes les inscriptions de rappel au niveau de l’URI OData suivant, afin d’afficher les données à l’intérieur de l’entité callbackregistrations :

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

      Note

      Si aucune valeur n’est retournée, vous n’avez peut-être pas les autorisations nécessaires pour afficher ce type d’entité ou vous n’avez peut-être pas connecté à l’organisation appropriée.

   2. Filtrez selon le nom logique de l'entité déclencheuse entityname et sur l'événement de notification qui correspond à votre workflow Logic App (message). Chaque type d’événement est mappé à l’entier du message comme suit :

      Type d'événement	Entier du message
      Créer	1
      Supprimer	2
      Update	3
      CreateOrUpdate	4
      CréerOuSupprimer	5
      UpdateOrDelete	6
      CreateOrUpdateOrDelete	7

      L’exemple suivant montre comment filtrer les notifications Create selon une entité nommée nov_validation, en utilisant l’URI OData suivant pour un exemple d’organisation :

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

      

      Note

      Si plusieurs déclencheurs existent pour la même entité ou le même événement, vous pouvez filtrer la liste à l’aide de filtres supplémentaires tels que les attributs createdon et _owninguser_value. Le nom de l’utilisateur propriétaire apparaît sous /api/data/v9.0/systemusers({id}).

   3. Une fois que vous avez trouvé l’ID de l’inscription de rappel que vous souhaitez supprimer, procédez comme suit :

      1. Dans votre navigateur Chrome, ouvrez les outils de développement Chrome (clavier : F12).

      2. Dans la fenêtre, en haut, sélectionnez l’onglet Console .

      3. Dans l’invite de ligne de commande, entrez la commande suivante, qui envoie une demande de suppression de l’inscription de rappel spécifiée :

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

         Important

         Assurez-vous que vous effectuez la requête à partir d’une page d’interface client non unifiée (UCI), par exemple à partir de la page de réponse OData ou API elle-même. Sinon, la logique dans le fichier app.js peut interférer avec cette opération.

   4. Pour vérifier que l’enregistrement de rappel n’existe plus, examinez la liste des enregistrements de rappel.

Entité « callbackregistrations » dupliquée

Dans les flux de travail Standard, dans des conditions spécifiques telles que la réaffectation d’instance ou le redémarrage de l’application, le déclencheur Microsoft Dataverse démarre une exécution en double. Cette exécution en double crée une entité en double callbackregistrations dans votre base de données Dataverse. Si vous modifiez un flux de travail Standard qui commence par un déclencheur Dataverse, vérifiez si cette callbackregistrations entité est dupliquée. Si le doublon existe, supprimez manuellement l’entité dupliquée callbackregistrations .

Contenu connexe

• Connecteurs managés pour Azure Logic Apps
• Connecteurs intégrés pour Azure Logic Apps
• Qu’est-ce que des connecteurs dans Azure Logic Apps