DISTINCT ATTRIBUTE VALUES

Home

4D v16.3


DISTINCT ATTRIBUTE VALUES ( ObjektFeld ; Pfad ; WerteArray )

Parameter	Typ	Beschreibung
ObjektFeld	Feld	Objektfeld, aus dem Sie die Liste der verschiedenen Attributwerte erhalten wollen
Pfad	Text	Pfad des Attributs, dessen verschiedene Werte Sie erhalten wollen
WerteArray	Array Text, Array Lange Ganzzahl, Array Boolean, Array Datum, Time array	Verschiedene Werte im Attributpfad

Beschreibung

Der Befehl DISTINCT ATTRIBUTE VALUES erstellt und füllt den Parameter WerteArray mit nicht-wiederholten (einmaligen) Werten aus dem Attribut Pfad im Feld ObjektFeld für die aktuelle Auswahl der dazugehörigen Tabelle. Bitte beachten Sie, dass ObjektFeld indiziert und vom Typ Objekt sein muss, andernfalls wird ein Fehler zurückgegeben. Der Befehl ist mit indizierten und nicht-indizierten Feldern verwendbar.

In Pfad übergeben Sie einen gültigen Attributpfad. Definieren Sie Pfade zu eingebundenen Objektattributen mit der Standard Notation mit Punkt, z.B. "company.address.number". Beachten Sie, dass Namen von Objektattributen zwischen Groß- und Kleinschreibung unterscheiden.

Das in WerteArray übergebene Array muss vom gleichen Typ sein wie das als Parameter übergebene Attribut Pfad. Die Werte müssen skalar sein und können vom Typ Zahl, Text, Datum und Zeit sein (Zeiger, Objekte, Blobs oder Bilder werden nicht unterstützt). Stellen Sie sicher, dass alle Werte für Feldattribute vom gleichen Typ sind; sonst wird ein Fehler zurückgegeben. Beispiel: Enthält das Attribut Pfad in einem Datensatz den Text Montag und in einem anderen die Zahl 10125, wird ein Fehler zurückgegeben.

Nach dem Aufruf ist das Array genauso groß wie die Anzahl der verschiedenen Werte in der Auswahl. Der Befehl verändert nicht die aktuelle Auswahl bzw. den aktuellen Datensatz.

Die virtuelle Eigenschaft .length verwenden

Mit diesem Befehl können Sie die virtuelle Eigenschaft "length" verwenden. Sie ist für alle Attribute vom Typ Array automatisch verfügbar und liefert die Größe des Array, z.B. die Anzahl der darin enthaltenen Elemente. Diese Eigenschaft wurde für Suchläufe eingerichtet (siehe QUERY BY ATTRIBUTE). Sie können sie auch mit dem Befehl DISTINCT ATTRIBUTE VALUES verwenden, um die verschiedenen Array Größen für ein Attribut zu erhalten

Beispiel

Ihre Anwendung enthält ein Objektfeld [Customer]full_Data (indexed) mit 12 Datensätzen:

Führen Sie folgende Anweisung aus:

 ARRAY LONGINT(aLAges;0)

 ALL RECORDS([Customer])

  //erhält die verschiedenen Werte für das Attribut "age"

 DISTINCT ATTRIBUTE VALUES([Customer]full_Data;"age";aLAges)

erhält das Array aLAges folgende 9 Elemente:

  //aLAges{1}=33

  //aLAges{2}=35

  //aLAges{3}=36

  //aLAges{4}=40

  //aLAges{5}=42

  //aLAges{6}=44

  //aLAges{7}=52

  //aLAges{8}=54

  //aLAges{9}=60

Siehe auch

DISTINCT ATTRIBUTE PATHS