Déclencheurs Dataverse

Effectué

Avec Power Automate, vous pouvez créer des flux de cloud automatisés avec un déclencheur et plusieurs actions. Un déclencheur est un événement qui démarre un flux de cloud. Le connecteur Dataverse prend en charge quatre déclencheurs qui permettent le démarrage de flux basés sur des événements de données Dataverse.

Voici les déclencheurs sur le connecteur Dataverse :

  • Lorsqu’une ligne est ajoutée, modifiée ou supprimée : ce déclencheur vous permet de démarrer un flux lorsqu’une ligne est ajoutée, modifiée ou supprimée dans une table Dataverse. Par exemple, lorsque vous ajoutez une nouvelle ligne à la table Projet, le système doit exécuter un flux.

  • Lorsqu’une action est effectuée : ce déclencheur se produit lorsqu’une action Dataverse est effectuée. Par conséquent, le système déclenche des flux à partir d’événements commerciaux personnalisés que vous définissez. Par exemple, vous pouvez créer un événement EmployeeOnboarded, puis déclencher des flux à son aide.

  • Lorsqu’une étape du flux est exécutée à partir d’un flux de processus métier : ce déclencheur vous permet de démarrer un flux en cas de clic sur le bouton Exécuter le flux à une étape de flux de processus métier. Par exemple, dans une application Microsoft Power Apps pilotée par modèle qui utilise un flux de processus métier, vous pouvez créer une étape qui démarre un flux pour obtenir l’approbation d’un responsable.

  • Lorsqu’une ligne est sélectionnée : ce déclencheur démarre un flux lorsqu’un utilisateur d’une application Power Apps pilotée par modèle sélectionne une ligne et exécute le flux.

Chaque déclencheur comporte différentes options que vous devez configurer. Certains déclencheurs disposent d’options avancées qui offrent davantage de contrôle sur les comportements du déclencheur. Le reste de cette rubrique met en évidence certaines des options les plus courantes que vous pouvez configurer.

Lorsqu’une ligne est ajoutée, modifiée ou supprimée

Pour utiliser le déclencheur Lorsqu’une ligne est ajoutée, modifiée ou supprimée, vous devez configurer les options de type de modification, de table et d’étendue sur le déclencheur. Tous les autres paramètres sont facultatifs.

Type de modification

Le déclencheur Type de modification vous permet de configurer un ou plusieurs événements de ligne de données avec lesquels vous souhaitez déclencher le flux. Par exemple, vous pouvez choisir d’exécuter le flux lorsqu’une ligne est ajoutée, modifiée ou supprimée ou une combinaison de ces actions. Ces événements de ligne de données déclenchent le flux après que la modification de la ligne se produit dans l’environnement Dataverse.

Si vous ajoutez ou modifiez le type de modification, la ligne de table Dataverse actuelle est disponible en sortie, afin que vous puissiez l’utiliser aux étapes suivantes à partir de la zone de contenu dynamique. Si vous supprimez le type de modification, seul l’ID de ligne de la ligne Dataverse est disponible.

Si vous déclenchez votre flux sur plusieurs types de modification et si vous avez besoin d’une logique conditionnelle en fonction du type, l’expression suivante vous permet d’obtenir le type de modification qui a déclenché le flux. La propriété SdkMessage comporte la valeur create, update ou delete.

triggerBody()?['SdkMessage'] 

Si vous effectuez plusieurs mises à jour pour une ligne, votre flux peut se déclencher pour chaque mise à jour, même si les valeurs de colonne de ligne ne changent pas. Cette situation se produit, car vous avez effectué plusieurs fois la mise à jour de la ligne. La logique de votre flux doit prendre en considération ce facteur.

Nom de la table

Vous pouvez choisir le nom de la table dans la liste complète ou filtrer la liste en commençant à le saisir. Les noms de table ne sont pas présentés par ordre alphabétique. L’utilisation du filtre peut donc s’avérer utile dans les environnements comportant de nombreuses tables.

Étendue

Lorsque vous créez une table Dataverse, vous spécifiez le type de propriété des lignes. L’organisation, un utilisateur ou une équipe peut être propriétaire des lignes.

L’option d’étendue vous permet de spécifier les lignes éligibles pour déclencher le flux en fonction du propriétaire de la ligne en cours de modification. Si le propriétaire de la ligne de table est l’organisation, la seule option d’étendue est organisation. Pour les tables autorisant la propriété d’un utilisateur ou d’une équipe, vous pouvez choisir l’une des options d’étendue suivantes :

  • Organisation : il s’agit de l’option par défaut. Tout utilisateur possédant une ligne et la modifiant peut déclencher votre flux. De plus, toute personne modifiant les tables appartenant à l’organisation peut déclencher votre flux.

  • Utilisateur : cette option est la plus restrictive ; votre flux s’exécute seulement si vous possédez la ligne modifiée.

  • Centre de profit : cette option déclenche votre flux si un utilisateur de votre centre de profit possède la ligne modifiée. Par exemple, imaginez un scénario dans lequel vous travaillez dans le centre de profit Marketing avec 16 utilisateurs. Chaque fois que l’un de ces 16 utilisateurs effectue une action, il peut déclencher votre flux si un autre utilisateur du centre de profit possède la ligne modifiée.

  • Divis. mère : sous-division : cette option comprend tous les utilisateurs de la sous-division dans la détermination des actions qui peuvent déclencher votre flux. Par conséquent, si le centre de profit Marketing avait les sous-divisions Marketing - USA et Marketing - EMEA, le système inclut ces utilisateurs pour déterminer si votre flux doit s’exécuter.

L’organisation et l’utilisateur sont les configurations les plus courantes. L’étendue d’organisation est optimale si vous créez un flux pour tous les utilisateurs. L’étendue utilisateur est optimale si vous créez votre propre automatisation et souhaitez réduire le volume de données aléatoires ou non pertinentes saisies par d’autres utilisateurs.

Bien que vous puissiez configurer l’étendue pour inclure plus de lignes de données que vous n’avez de privilèges de lecture, votre flux est déclenché uniquement pour les lignes pour lesquelles vous disposez de privilèges de lecture.

Outre les choix requis, le déclencheur propose les Options avancées suivantes pour toute modification ultérieure :

  • Sélectionner des colonnes

  • Filtrer les lignes

  • Différer jusqu’à

  • Exécuter en tant que

Sélectionner des colonnes

L’option Sélectionner des colonnes s’applique seulement si vous définissez le type de modification pour inclure les lignes modifiées. Vous pouvez fournir une liste de colonnes de table qui, si elles sont incluses dans la modification de la ligne de données, sont exécutées par votre flux.

Cette option est une fonctionnalité utile pour réduire le nombre d’exécutions de vos flux. Par exemple, si vous souhaitez exécuter un flux seulement si les colonnes Prénom et Nom de la table Contact sont en cours de modification, vous devez définir l’option Sélectionner des colonnes comme suit :

firstname,lastname

Il est également important d’utiliser cette fonctionnalité si votre flux a l’intention de mettre à jour ultérieurement les colonnes de la ligne qui a déclenché le flux à l’aide d’une action de mise à jour de ligne. Pour éviter une boucle infinie, veillez à ne pas inclure les colonnes que vous mettez à jour dans l’option Sélectionner des colonnes.

Filtrer les lignes

L’option Filtrer les lignes vous permet de filtrer les lignes qui déclenchent votre flux en fonction des valeurs des colonnes de la ligne. Par exemple, vous pouvez filtrer les lignes de la table Projet pour inclure uniquement les lignes dépassant le budget. Bien que l’ajout d’une vérification de condition à vos actions de flux puisse accomplir la même tâche, cela est moins efficace que l’utilisation d’une expression de lignes de filtre.

Vous pouvez spécifier des lignes de filtre à l’aide d’une expression OData. Le flux s’exécute seulement si le système évalue l’expression comme true une fois que vous enregistrez la modification dans Dataverse.

contoso_amountoverbudget gt 10000

Ce module explore les expressions OData courantes plus loin dans la rubrique relative à l’interrogation de données.

Différer jusqu’à

L’option Différer jusqu’à vous permet de spécifier une heure spécifique afin de différer l’évaluation du déclencheur. À l’aide d’un timestamp de type OData, vous pouvez différer le déclencheur du flux jusqu’à une heure UTC spécifique.

L’un des principaux avantages d’utiliser cette option au lieu de l’action standard Différer jusqu’à est que la propriété Dataverse Différer jusqu’à de ce déclencheur n’expire jamais, ce qui permet à l’exécution du flux d’attendre pendant de longues périodes.

Exécuter en tant que

L’option Exécuter en tant que vous permet de définir chaque action Dataverse dans le flux à effectuer à l’aide du contexte d’un utilisateur autre que le propriétaire du flux. Le propriétaire du flux doit avoir le privilège Dataverse Agir au nom d’un autre utilisateur. Le rôle de sécurité Délégué comprend ce privilège par défaut, mais vous pouvez l’ajouter à tout rôle de sécurité.

Vous pouvez définir la fonctionnalité Exécuter en tant que avec les options suivantes :

  • Propriétaire du flux : créateur du flux.

  • Propriétaire de la ligne : utilisateur propriétaire de la ligne Dataverse qui a déclenché le flux. Si une équipe possède une ligne, cette option revient à exécuter en tant que propriétaire du flux.

  • Modification de l’utilisateur : utilisateur qui a effectué l’action sur la ligne Dataverse, provoquant le déclenchement ou la modification du flux.

Pour chaque action Dataverse que vous souhaitez exécuter en tant qu’utilisateur différent, sélectionnez Utiliser la connexion de l’appelant dans l’onglet Paramètres de l’action.

Prenons l’exemple suivant : John crée un flux qui ajoute des tâches aux nouvelles lignes de la table Projet. Si Mary crée une ligne Projet, le flux s’exécute et le système ajoute de nouvelles tâches. Ensuite, John peut visualiser ces tâches nouvellement ajoutées.

Si John redéfinit l’option Exécuter en tant que sur Modification de l’utilisateur, puis la fonctionnalité Ajouter une ligne des tâches sur Utiliser la connexion de l’appelant, les lignes de tâche affichent Mary comme créatrice au lieu de John.