Unrelate

Syntaxe

Paramètres

Description

Cette fonction permet de supprimer une relation entre deux enregistrements.

Remarques

• La fonction Unrelate est utilisée pour dissocier un enregistrement d'une table liée à une autre : Elle intervient dans le contexte de relations définies entre entités dans Dataverse ou d'autres sources de données relationnelles, permettant de rompre un lien sans supprimer les données elles-mêmes.
• Cette fonction est utile lorsqu'on souhaite retirer une association logique entre deux entités tout en conservant leur intégrité individuelle : Par exemple, on peut détacher un contact d'un compte sans effacer ni le contact ni le compte.
• Le paramètre Table1RelatedTable doit correspondre à la collection représentant la relation, et non à la table d'origine : Il est important de bien cibler la table liée pour que l'opération de dissociation s'applique correctement.
• L'enregistrement passé dans Table2Record doit exister et être valide dans la table liée : Sinon, la fonction échouera silencieusement ou générera une erreur selon le contexte d'exécution.
• Unrelate est l'inverse logique de la fonction Relate, qui permet d'établir une relation entre deux enregistrements : L'utilisation combinée de ces deux fonctions donne un contrôle total sur la gestion dynamique des relations dans les applications Power Apps.
• La fonction modifie les relations au niveau de la source de données, ce qui peut déclencher des règles métier ou des automatisations associées : Il est donc conseillé de l'utiliser avec précaution, notamment dans les environnements de production.
• L'opération de dissociation n'est pas destructive : les enregistrements concernés restent accessibles et intacts : Cela en fait un outil idéal pour reconfigurer des liens entre entités sans perte d'information.
• Dans les scénarios complexes, Unrelate permet de gérer manuellement la cardinalité des relations (un-à-plusieurs, plusieurs-à-plusieurs) : Elle offre ainsi une grande flexibilité pour les applications personnalisées nécessitant une gestion fine des connexions entre données.