Create entity selection

4D v19.8


Create entity selection ( tableds {; paramètres} ) -> Résultat

Paramètre	Type	Description
tableds	Table	Table de la base 4D dont la sélection courante doit être utilisée pour construire la sélection d'entités
paramètres	Objet	Option de création : contexte
Résultat	EntitySelection	Sélection d'entités liée à la dataclass de la table

Description

La commande Create entity selection construit et retourne une nouvelle sélection d'entités (entity selection) altérable liée à la dataclass correspondant à la table tableds, basée sur la sélection courante de cette table.

Note : Pour plus d'informations, reportez-vous à Sélections d'entité partageables et non partageables.

Si la sélection courante est triée, une sélection d'entités triée est créée (l'ordre de la sélection courante est conservé). Si la sélection courante n'est pas triée, une sélection d'entités non-triée est créée. Pour plus d'informations sur ce point, veuillez vous reporter au paragraphe Sélections d'entités triées vs Sélections d'entités non-triées dans le Guide du développeur 4D.

Si la table tableds n'est pas exposée dans ds, une erreur est retournée.
Cette commande ne peut pas être utilisée avec un Datastore distant.

Paramètres

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

 C_OBJECT($employees)

 ALL RECORDS([Employee])

 $employees:=Create entity selection([Employee])

  // la sélection d'entités $employees contient un ensemble de références vers toutes les entités de la dataclass Employee

Voir aussi

USE ENTITY SELECTION