FINDFIRST

Die Funktion FINDFIRST springt zum ersten Datensatz einer Record-Variable. Gesetzte Filter und der gesetzte Tabellenschlüssel werden dabei berücksichtigt.

[OK :=] FINDFIRST;

Rückgabewert

Als Rückgabewert liefert die Funktion entweder TRUE (zum ersten Datensatz gesprungen) oder FALSE (es konnte nicht zum ersten Datensatz gesprungen werden). Wird der Rückgabewert nicht abgefragt und es konnte nicht zum ersten Datensatz gesprungen werden, bricht Dynamics NAV den Vorgang mit einer Fehlermeldung ab.

Hinweise

Immer, wenn nur der erste Datensatz benötigt wird – egal ob lesend oder schreibend –, nutze FINDFIRST anstatt FINDSET. Soll dagegen anschließend per REPEAT-UNTIL und NEXT zu den nächsten Datensätze gesprungen werden, sollte FINDSET genutzt werden.

Beispiel

Zunächst wird die folgende neue Variable hinterlegt.

Name Datentyp Subtyp
Item Record Item

Anschließend wird folgender C/AL-Code eingefügt.

Item.RESET;
IF Item.FINDFIRST THEN
  MESSAGE('%1 %2',
    Item."No.",
    Item.Description);

Sobald der Code ausgeführt wird, erscheint das folgende Ergebnis.

1000 Tourenrand