entitySelection.{attributeName}

Home

4D v19.8


entitySelection.{attributeName} -> Funktionsergebnis

Parameter	Typ	Beschreibung
Funktionsergebnis	Collection, EntitySelection	Projektion der Attributwerte für die Entity-Selection

Beschreibung

Jedes Attribut der Dataclass lässt sich als Eigenschaft einer Entity-Selection verwenden, um eine "Projektion" von Werten für die Attribute in der Entity-Selection zurückzugeben. Die abgebildeten Werte können je nach Art des Attributs (Speicher oder Verknüpfung) eine Collection oder eine neue Entity-Selection sein.

Ist attributeName vom Typ storage:
gibt entitySelection.attributeName eine Collection mit Werten vom gleichen Typ wie attributeName zurück.

Ist attributeName vom Typ relatedEntity:
gibt entitySelection.attributeName eine neue Entity-Selection der verknüpften Werte vom gleichen Typ wie attributeName zurück. Duplikationen werden entfernt. Es wird eine unsortierte Entity-Selection zurückgegeben.

Ist attributeName vom Typ relatedEntities:
gibt entitySelection.attributeName eine neue Entity-Selection der verknüpften Werte vom gleichen Typ wie attributeName zurück. Duplikationen werden entfernt. Es wird eine unsortierte Entity-Selection zurückgegeben.

Wird ein Verknüpfungsattribut als Eigenschaft einer Entity-Selection verwendet, ist das Ergebnis immer eine andere Entity-Selection, selbst wenn nur eine Entity zurückgegeben wird. Werden keine Entities zurückgegeben, ist das Ergebnis eine leere Entity-Selection.

Weitere Informationen dazu finden Sie im Abschnitt dataClassAttribute.kind.

Existiert das Attribut nicht in der Entity-Selection, wird ein Fehler zurückgegeben.

Beispiel 1

Projektion der Speicherwerte:

 C_COLLECTION(firstNames)

 $entitySelection:=ds.Employee.all()

 firstNames:=$entitySelection.firstName // firstName ist vom Typ String

Das ergibt eine Collection von Strings, zum Beispiel:

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

Beispiel 2

Projektion der verknüpften Entity:

 C_OBJECT($es;$entitySelection)

 $entitySelection:=ds.Employee.all()

 $es:=$entitySelection.employer // employer ist mit der Dataclass Company verknüpft

Das ergibt eine Entity-Selection von Company; evtl. vorhandene Duplikationen werden entfernt.

Beispiel 3

Projection der verknüpften Entities:

 C_OBJECT($es)

 $es:=ds.Employee.all().directReports // directReports ist mit der Dataclass Employee verknüpft

Das ergibt eine Entity-Selection von Employee; evtl. vorhandene Duplikationen werden entfernt.

Siehe auch

entity.{attributeName}