entitySelection.distinct()

Home

4D v19.8


entitySelection.distinct() ( attributePath {; option} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
attributePath	Text	Pfad des Attributs zum Erhalten der nicht-wiederholten Werte
option	Lange Ganzzahl	dk diacritical: diakritische Bewertung, dann ist z.B. "A" # "a"
Funktionsergebnis	Collection	Collection nur mit nicht-wiederholten Werten

Beschreibung

Die Methode entitySelection.distinct() gibt eine Collection nur mit nicht-wiederholten (unterschiedlichen) Werten von attributePath in der Entity-Selection zurück.

Die zurückgegebene Collection ist automatisch sortiert. Es werden keine Null Werte zurückgegeben.

Im Parameter attributePath übergeben Sie das Entity Attribut, dessen nicht-wiederholte Werte Sie erhalten wollen. Das ist nur für skalare Werte möglich, also Text, Zahl, Boolean oder Datum. Ist attributePath ein Objektattribut mit Werten unterschiedlichen Typs, werden sie erst nach Typ gruppiert und anschließend sortiert. Typen werden in folgender Reihenfolge zurückgegeben:

Boolean
String
Zahl
Datum

Standardmäßig wird die Bewertung ohne diakritische Zeichen durchgeführt. Sollen Klein- und Großschreibung und Akzente berücksichtigt werden, übergeben Sie im Parameter option die Konstante dk diacritical.

Ein Fehler wird zurückgegeben, wenn:

attributePath ein verknüpftes Attribut ist
attributePath nicht in der Dataclass der Entity-Selection gefunden wird.

Beispiel

Eine Collection mit einem einzigen Element pro Ländername erhalten:

 C_COLLECTION($countries)

 $countries:=ds.Employee.all().distinct("address.country")

Siehe auch

entitySelection.count