Create entity selection
*Create entity selection ( dsTable : Table { ; settings : Object } ) : 4D.EntitySelection
| Paramètres | Type | Description | |
|---|---|---|---|
| dsTable | Table | → | Table de la base 4D dont la sélection courante doit être utilisée pour construire l'entity selection |
| settings | Object | → | Option de création : contexte |
| Résultat | 4D.EntitySelection | ← | Nouvelle entity selection liée à la dataclass de la table |
Description
The Create entity selection command builds and returns a new, alterable entity selection related to the dataclass matching the given dsTable, according to the current selection of this table.
If the current selection is sorted, an ordered entity selection is created (the order of the current selection is kept). Si la sélection courante n'est pas triée, une entity selection non-triée est créée.
If the dsTable is not exposed in ds, an error is returned. Cette commande ne peut pas être utilisée avec un datastore distant.
Dans le paramètre optionnel settings, vous pouvez passer un objet contenant la propriété suivante :
| Propriété | Type | Description |
|---|---|---|
| context | Text | Nom du contexte d'optimisation appliqué à l'entity selection. |
Exemple
var $employees : cs.EmployeeSelection
ALL RECORDS([Employee])
$employees:=Create entity selection([Employee])
// L'entity selection $employees contient maintenant un ensemble de
// références vers toutes les entités de la dataclass Employee