USE ENTITY SELECTION
USE ENTITY SELECTION ( entitySelection : 4D.EntitySelection )
| Paramètres | Type | Description | |
|---|---|---|---|
| entitySelection | 4D.EntitySelection | → | Une entity selection |
Description
The USE ENTITY SELECTION command updates the current selection of the table matching the dataclass of the entitySelection parameter, according to the content of the entity selection.
Cette commande ne peut pas être utilisée avec un datastore distant.
Cette commande est conçue pour permettre aux sélections courantes 4D de bénéficier de la puissance des requêtes ORDA. Pour des raisons de performance, dans 4D monoposte et 4D Server, la commande connecte directement entitySelection à la sélection courante. Par conséquent, une fois que entitySelection a été utilisée, elle ne doit pas être réutilisée ou modifiée.
Après un appel à USE ENTITY SELECTION, le premier enregistrement de la sélection courante mise à jour (s'il n'est pas vide) devient l'enregistrement courant, mais il n'est pas chargé en mémoire. Si vous avez besoin d'utiliser les valeurs des champs de l'enregistrement courant, utilisez la commande LOAD RECORD après la commande USE ENTITY SELECTION.
Exemple
var $entitySel : cs.EmployeeSelection
$entitySel:=ds.Employee.query("lastName = :1";"M@") //$entitySel est associée à la dataclass Employee
REDUCE SELECTION([Employee];0)
USE ENTITY SELECTION($entitySel) //La sélection courante de la table Employee est mise à jour