Créer, mettre à jour, supprimer et associer des actions
Les actions du connecteur Dataverse vous permettent de créer des lignes, de modifier des lignes existantes et d’associer des données entre elles à l’aide des relations définies. Si nécessaire, vous pouvez supprimer des lignes à l’aide de l’action Supprimer. Les actions Dataverse vous permettent également de cibler un environnement spécifié avec des actions à partir de l’environnement sélectionné supplémentaires.
Créer des lignes
Créez des lignes dans une table Dataverse à l’aide de l’action Ajouter une nouvelle ligne. Vous devez choisir un nom de table, puis l’action affiche dynamiquement les premières colonnes de cette table. Les colonnes obligatoires sont indiquées par un astérisque rouge en regard du nom de la colonne. Vous ne pouvez pas enregistrer le flux sans fournir une entrée dans chaque colonne obligatoire. Une colonne obligatoire désigne toute colonne de la table configurée comme Champ commercial obligatoire. Si vous marquez d’autres colonnes comme Champ commercial obligatoire dans votre table après avoir créé un flux, vous devrez mettre à jour votre action de flux la prochaine fois que vous mettrez à jour la colonne.
Seules certaines colonnes s’affichent automatiquement dans l’onglet Paramètres de l’action. Les colonnes restantes se trouvent dans les Paramètres avancés.
Mettre à jour des lignes
Mettez à jour une ligne de données existante à l’aide de l’action Mettre à jour une ligne. En outre, l’action vous permet d’effectuer une opération upsert (mise à jour ou insertion) lorsque l’ID ne correspond pas à une ligne existante ; l’action peut créer une ligne à la place.
L’ID de ligne est requis dans l’action Mettre à jour une ligne et il vous suffit de mettre à jour le GUID de la ligne de données. Si vous obtenez l’ID de ligne à partir d’un autre déclencheur ou d’une autre action de connecteur Dataverse, l’ID de ligne doit porter le même nom que la table et la description de la colonne doit être l’identificateur unique de la table. N’utilisez pas la colonne OData ID, qui est différente.
Contrairement à l’action Ajouter une nouvelle ligne qui nécessite des colonnes, l’action Mettre à jour une ligne ne nécessite pas de colonnes. Cependant, vous devez modifier les valeurs des colonnes seulement si les données changent. Par exemple, transmettre la colonne Nom du compte alors qu’elle n’est pas modifiée entraînerait d’autres automatisations recherchant des modifications sur la table Compte à exécuter.
Pour effacer une valeur de colonne existante, modifiez la colonne de l’action pour utiliser une expression Null.
Associer des données
Dataverse vous permet de créer des relations un-à-plusieurs (ou plusieurs-à-un, si vous envisagez la relation dans l’autre sens) et plusieurs-à-plusieurs entre des lignes de table. Deux options permettent d’associer des lignes de données, en fonction du type de relation et de la ligne de la relation que vous utilisez.
Lorsque vous utilisez l’action Ajouter une nouvelle ligne ou Mettre à jour une ligne, vous pouvez mettre à jour les colonnes de recherche sur la ligne de données que vous ajoutez ou mettez à jour. Par exemple, la table Compte comporte une colonne de recherche de contact principal qui représente une relation plusieurs-à-un avec la table Contact. Lorsque vous ajoutez ou mettez à jour un compte, vous pouvez également établir la relation avec le contact dans la même action. Vous ne pouvez pas établir cette relation si vous ajoutez ou mettez à jour la ligne Contact, car elle ne comporte pas de colonne de recherche. L’autre option consiste à établir la relation séparément à l’aide de l’action Associer des lignes.
Vous pouvez établir des relations plusieurs-à-plusieurs uniquement à l’aide de l’action Associer des lignes. En effet, aucune des lignes de la relation ne comporte de colonne de recherche dans laquelle vous pouvez définir la valeur dans l’action Ajouter une nouvelle ligne ou Mettre à jour une ligne.
Spécifier l’ID pour chaque ligne
Lorsque vous associez des lignes de données, vous devez fournir l’identificateur global unique (GUID) de la ligne ou une URL de ligne. Veillez à noter la différence, car donner un GUID ou une URL incorrect(e) entraîne une erreur.
Vous pouvez obtenir le GUID (par exemple fd140aaf-4df4-11dd-bd17-0019b9312238) pour une ligne figurant dans la sortie d’une étape antérieure de votre flux. Pour ce faire, sélectionnez le GUID à partir du contenu dynamique en recherchant la colonne portant le même nom que votre table et une description indiquant Identificateur unique pour tablename.
Pour obtenir l’URL de la ligne, recherchez dans la liste de contenu dynamique l’OData ID avec une description de l’ID de la ligne OData. Vous pouvez composer manuellement une URL de ligne en combinant le nom de l’ensemble d’entités OData de la table avec le GUID. Le nom de l’ensemble d’entités est généralement le nom logique de la table auquel est ajouté la lettre « s ». Ainsi, le nom logique de la table Compte est account, donc le nom de l’ensemble d’entités serait accounts. Un moyen rapide de trouver le nom d’une table consiste à ajouter une action Dataverse, définir la table avec le nom de table dont vous souhaitez connaître le nom de l’ensemble d’entités, puis passer en mode Code. En mode Code, la valeur EntityName est le nom de l’ensemble d’entités nécessaire pour créer une URL de ligne OData. Votre URL de ligne OData devrait ressembler à l’exemple suivant :
contoso_projects(fd140aaf-4df4-11dd-bd17-0019b9312238)
Utiliser l’action Ajouter ou mettre à jour une ligne
Lorsque vous utilisez l’action Ajouter ou mettre à jour une ligne, vous devez spécifier l’URL de la ligne avec laquelle vous créez la relation.
La capture d’écran suivante montre comment définir le contact principal sur une ligne de compte à l’aide de l’OData ID :
La capture d’écran suivante montre comment définir le contact principal sur une ligne de compte à l’aide de l’ID de ligne :
Établir une relation un-à-plusieurs à l’aide de l’action Associer des lignes
Lorsque vous établissez une relation entre deux lignes à l’aide de l’action Associer des lignes, vous devez déterminer la table à sélectionner dans l’action. Dans une relation un-à-plusieurs, vous allez utiliser la table d’un côté de la relation. Par exemple, considérons une situation dans laquelle les lignes Compte comportent un contact principal. La ligne Compte ne peut être associée qu’à une seule ligne Contact pour cette relation, ce qui place la ligne Contact d’un côté de la relation.
Ensuite, fournissez l’ID de ligne pour la table que vous avez configurée. Cette valeur est un ID de ligne, et non une URL. Vous devez donc fournir uniquement le GUID (par exemple fd140aaf-4df4-11dd-bd17-0019b9312238).
Les tables peuvent avoir plusieurs relations, donc vous devez choisir la relation que vous établirez ensuite. Si vous avez besoin d’aide avec le nom, vous pouvez consulter les propriétés de table de la relation afin de trouver le nom de la relation.
Votre dernière étape consiste à configurer la propriété Associer avec. Cette propriété est une URL de ligne. Vous pouvez donc utiliser la colonne OData ID d’une étape précédente ou fournir l’URL complète manuellement, par exemple contoso_projects(fd140aaf-4df4-11dd-bd17-0019b9312238).
Établir une relation plusieurs-à-plusieurs à l’aide de l’action Associer des lignes
Lorsque vous utilisez une relation plusieurs-à-plusieurs, vous pouvez déterminer la table à spécifier dans l’action en examinant les propriétés de table de la relation. La table qui se trouve dans la colonne Associer de la liste des relations est le nom de table que vous devez choisir lors de l’établissement d’une relation plusieurs-à-plusieurs entre deux lignes.
Pour l’option Associer avec, utilisez l’URL de ligne de l’autre ligne de table.
