Update

Syntaxe

Paramètres

Description

Cette fonction permet de modifier un ou plusieurs enregistrements dans une source de données.

Remarques

• La fonction Update permet de modifier directement un enregistrement spécifique dans une source de données connectée : Elle s'utilise pour remplacer une version existante d'un enregistrement par une version mise à jour, en gardant la structure d'origine de l'ensemble de données.
• Le paramètre OldRecord sert à identifier précisément l'enregistrement à modifier : Il est essentiel que ce paramètre corresponde exactement à un enregistrement existant dans la source de données, sinon l'opération échouera sans mise à jour effective.
• Le paramètre NewRecord contient les valeurs à insérer en remplacement : Seules les colonnes incluses dans ce nouvel enregistrement seront modifiées, les autres conserveront leurs valeurs précédentes si elles ne sont pas redéfinies.
• La fonction Update agit directement sur la source de données, ce qui peut déclencher des flux de travaux, règles métier ou notifications : Cela implique de bien tester son usage dans un environnement de développement avant de l'implémenter en production.
• L'ajout du paramètre optionnel RemoveFlags.All peut modifier le comportement de la fonction : Lorsque ce drapeau est utilisé, il supprime d'abord tous les enregistrements correspondants, ce qui est utile dans certains cas, mais potentiellement risqué s'il est mal utilisé.
• Update n'est pas une fonction pour insérer de nouveaux enregistrements ; elle suppose que l'élément ciblé existe déjà : Pour créer de nouveaux éléments, on doit utiliser la fonction Collect ou Patch selon le cas.
• Le fonctionnement de Update dépend de la connectivité avec la source de données : Avec certaines sources comme SharePoint, SQL Server ou Dataverse, la mise à jour se fait immédiatement, mais elle peut échouer si des verrous ou contraintes existent.
• Pour une meilleure fiabilité, il est recommandé d'utiliser une structure de données claire avec des identifiants uniques : Cela permet de garantir que OldRecord fait référence à un enregistrement unique, évitant les erreurs ou confusions lors de la mise à jour.