dataClass.get( )

4D v19.8

dataClass.get( )


dataClass.get ( cléPrimaire {; paramètres} ) -> Résultat

Paramètre	Type	Description
cléPrimaire	Entier long, Texte	Valeur de la clé primaire de l'entité à récupérer
paramètres	Objet	Option de création : contexte
Résultat	Entity	Entité correspondant à la clé primaire indiquée

Description

La méthode dataClass.get( ) interroge la dataclass pour récupérer l'entité correspondant au paramètre cléPrimaire.

Dans cléPrimaire, passez la valeur de clé primaire de l'entité à récupérer. Le type de valeur doit correspondre au type de clé primaire définie dans le datastore (entier long ou texte). Vous pouvez également vous assurer que la valeur de la clé primaire est toujours renvoyée en tant que texte en utilisant la méthode entity.getKey( ) avec le paramètre dk key as string.

Si aucune entité n'est trouvée avec cléPrimaire, une entité Null est retournée.

Le chargement différé (lazy loading) est appliqué, ce qui signifie que les données associées sont chargées à partir du disque uniquement lorsque cela est nécessaire.

settings

Dans le paramètre optionnel paramètres, vous pouvez passer un objet contenant des options supplémentaires. La propriété suivante est prise en charge :

Propriété	Type	Description
context	Texte	Nom du contexte d'optimisation appliqué à la sélection d'entités. Ce contexte sera utilisé par le code qui gère la sélection d'entités afin de bénéficier de l'optimisation. Cette fonctionnalité est conçue pour le traitement client/serveur ORDA ; pour plus d'informations, veuillez consulter la section Optimisation client/serveur .

Exemple 1

 C_OBJECT($entity)

 $entity:=ds.Employee.get(167) // retourne l'entité dont la valeur de clé primaire est 167

 $entity:=ds.Invoice.get("DGGX20030") // retourne l'entité dont la valeur de clé primaire est "DGGX20030"

Exemple 2

Cet exemple illustre l'utilisation de la propriété context :

 C_OBJECT($e1;$e2;$e3;$e4;$settings;$settings2)

 

 $settings:=New object("context";"detail")

 $settings2:=New object("context";"summary")

 

 $e1:=ds.Employee.get(1;$settings)

 completeAllData($e1) // Dans la méthode completeAllData, une optimisation est lancée et associée au contexte "detail"

 

 $e2:=ds.Employee.get(2;$settings)

 completeAllData($e2) // Dans la méthode completeAllData, l'optimisation associée au contexte "detail" est appliquée

 

 $e3:=ds.Employee.get(3;$settings2)

 completeSummary($e3)  // Dans la méthode completeSummary, une optimisation est lancée et associée au contexte "summary"

 

 $e4:=ds.Employee.get(4;$settings2)

 completeSummary($e4)   // Dans la méthode completeSummary,  l'optimisation associée au contexte "summary" est appliquée

Voir aussi

entity.getKey( )
Find in field
QUERY