4D Doc Center : QUERY SUBRECORDS

Home

4D v14.3

QUERY SUBRECORDS


QUERY SUBRECORDS ( Untertabelle ; Formel )

Parameter	Typ	Beschreibung
Untertabelle	Untertabelle	Untertabelle, in der gesucht werden soll
Formel	Boolean	Formel

Hinweis zur Kompatibilität

Untertabellen werden ab 4D Version 11 nicht mehr unterstützt. Ein Kompatibilitätsmechanismus sorgt dafür, dass dieser Befehl in konvertierten Datenbanken weiter funktioniert. Wir raten jedoch dringend, alle Untertabellen durch verknüpfte Standardtabellen zu ersetzen.

Beschreibung

Der Befehl QUERY SUBRECORDS führt eine Suche in Untertabelle durch. Der Befehl überprüft das Ergebnis von Formel für jeden Unterdatensatz. Gibt Formel TRUE zurück, wird der Unterdatensatz in die Unterauswahl übernommen.

Die Suche erfolgt nur in den Unterdatensätzen des aktuellen Datensatzes, zu der Untertabelle gehört. Ist die erhaltene Unterauswahl nicht leer, wird der erste Unterdatensatz dieser Auswahl der aktuelle Unterdatensatz. Gibt es in der betreffenden Tabelle keinen aktuellen Datensatz, wird QUERY SUBRECORDS nicht ausgeführt.

Beachten Sie, dass QUERY SUBRECORDS nur in den Unterdatensätzen der Untertabelle des aktuell ausgewählten Hauptdatensatzes sucht, und nicht in allen Unterdatensätzen, die zur Haupttabelle gehören. QUERY SUBRECORDS ändert nicht den aktuellen Hauptdatensatz.

Für Formel gelten dieselben Regeln wie für den Befehl QUERY BY FORMULA. So kann Formel mit Vergleichsoperatoren ein Unterdatenfeld mit einer Variablen oder Konstanten vergleichen, mehrteilige Vergleiche enthalten, die durch UND (&) bzw. ODER ( | ) verbunden sind oder eine Funktion erhalten bzw. selbst eine Funktion sein. In Textargumenten kann auch der Joker eingesetzt werden.

Beispiel

Folgendes Beispiel sucht nach Kindern, die älter als 10 sind:

QUERY SUBRECORDS([People]Children;[People]Children'Age>10)

Folgendes Beispiel sucht nach Kindern, die älter als 10 und jünger als 20 sind:

 QUERY SUBRECORDS([People]Children;(([People]Children'Age>10)

 &([People]Children'Age<20)))