entitySelection.{nomAttribut}

4D v19.8


entitySelection.{nomAttribut} -> Résultat

Paramètre	Type	Description
Résultat	Collection, EntitySelection	Projection des valeurs des attributs de la sélection d'entités

Description

Tout attribut de dataclass peut être utilisé en tant que propriété d'une sélection d'entités afin de retourner une "projection" des valeurs de l'attribut dans la sélection d'entités. Les valeurs projetés peuvent être une collection ou une nouvelle sélection d'entités, selon le kind (storage ou relation) de l'attribut.

si le kind de nomAttribut est storage :
entitySelection.nomAttribut retourne une collection de valeurs du même type que nomAttribut.

si le kind de nomAttribut est relatedEntity :
entitySelection.nomAttribut retourne une nouvelle sélection d'entités de valeurs liées du même type que nomAttribut. Les doublons sont supprimés (une sélection d'entités non ordonnée est retournée).

si le kind de nomAttribut est relatedEntities :
entitySelection.nomAttribut retourne une nouvelle sélection d'entités de valeurs liées du même type que nomAttribut. Les doublons sont supprimés (une sélection d'entités non ordonnée est retournée).

Lorsqu'un attribut relationnel est utilisé en tant que propriété d'une sélection d'entités, le résultat est toujours une autre sélection d'entités, même si une seule entité est retournée. Dans ce cas, si aucune entité n'est retounée, le résultat est une sélection d'entités vide.

Note : Pour plus d'informations sur le kind des attributs, reportez-vous à la description de la propriété dataClassAttribute.kind.

Si l'attribut n'existe pas dans la sélection d'entités, une erreur est retournée.

Exemple 1

Projection de valeurs storage (stockage) :

 C_COLLECTION(firstNames)

 $entitySelection:=ds.Employee.all()

 firstNames:=$entitySelection.firstName // firstName est une chaîne

Le résultat est une collection de chaînes, par exemple :

[
    "Joanna",
    "Alexandra",
    "Rick"
]

Exemple 2

Projection de related entity :

 C_OBJET($es;$entitySelection)

 $entitySelection:=ds.Employee.all()

 $es:=$entitySelection.employer // employer est lié à la dataclass Company

Le résultat est une sélection d'entités de la dataclass Company sans doublons (s'il y en a).

Exemple 3

Projection de related entities :

 C_OBJET($es)

 $es:=ds.Employee.all().directReports // directReports est récursif, lié à la dataclass Employee

Le résultat est une sélection d'entités de la dataclass Employee sans doublons (s'il y en a).

Voir aussi

entity.{nomAttribut}