4D v18

entity.diff( )

Accueil

 
4D v18
entity.diff( )

entity.diff( )  


 

La méthode entity.diff( ) compare le contenu de deux entités et retourne leurs différences.

Dans le paramètre entitéAComparer, passez l'entité à comparer à l'entité d'origine.

Dans le paramètre attributsAComparer, vous pouvez désigner les attributs spécifiques à comparer. Si le paramètre est passé, la comparaison est effectuée uniquement sur les attributs spécifiés. S'il est omis, toutes les différences entre les entités sont retournées.

Les différences sont retournées sous forme de collection d'objets dont les propriétés sont :

Nom propriétéTypeDescription
attributeNameTexteNom de l'attribut
valueDépend du type d'attributValeur de l'attribut dans l'entité d'origine
otherValueDépend du type d'attributValeur de l'attribut dans entitéAcomparer

Seuls les attributs dont les valeurs diffèrent sont inclus dans la collection. Si aucune différence n'est trouvée, entity.diff( ) retourne une collection vide.

La méthode s'applique aux attributs dont le kind est storage ou relatedEntity (voir dataClassAttribute.kind). Dans le cas où une entité liée a été mise à jour (c'est-à-dire la clé étrangère), le nom de l'entité liée et de sa clé primaire sont retournés comme propriétés attributeName (value et otherValue sont vides pour le nom de l'entité liée).

Si l'une des entités comparées vaut Null, une erreur est retournée.



Voir aussi  

entity.touched( )

 
PROPRIÉTÉS 

Produit : 4D
Thème : ORDA - Entity

 
PAGE CONTENTS 
 
HISTORIQUE 

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v18)