4D Doc Center : FIRST SUBRECORD

Home

4D v14.3

FIRST SUBRECORD


FIRST SUBRECORD ( Untertabelle )

Parameter	Typ	Beschreibung
Untertabelle	Untertabelle	Untertabelle, deren erster Unterdatensatz ausgewählt werden soll

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 FIRST SUBRECORD wählt den ersten Unterdatensatz der aktuellen Unterauswahl von Untertabelle aus und bestimmt ihn zum aktuellen Unterdatensatz. Ist die Unterauswahl leer oder kein aktueller Datensatz in der dazugehörigen Tabelle vorhanden, wird FIRST SUBRECORD nicht ausgeführt. Die Befehle QUERY SUBRECORDS und ORDER SUBRECORDS BY machen diesen automatisch zum aktuellen Unterdatensatz. Es ist also nicht nötig, FIRST SUBRECORD nach einem dieser Befehle aufzurufen.

Beispiel

Folgendes Beispiel führt die Vor- und Nachnamen von Schülern, die in einer Untertabelle gespeichert sind, zusammen. Die Namen werden in ein Array atNames kopiert:

  ` Array für die Namen erstellen

 ARRAY TEXT(atNames;Records in subselection([People]Children))

 FIRST SUBRECORD([People]Children) ` Beginne mit dem ersten Unterdatensatz und durchlaufe einmal für jedes Kind

 For($vlSub;1;Records in subselection([People]Children))

    atNames{$vlSub}:=[People]Children'First Name+" "+[People]Children'Last Name

    NEXT SUBRECORD([People]Children)

 End for