4D Doc Center : APPLY TO SELECTION

Home

4D v14.3

APPLY TO SELECTION


APPLY TO SELECTION ( Tabellenname ; Anweisung )

Parameter	Typ	Beschreibung
Tabellenname	Tabelle	Tabelle für die Anweisung
Anweisung	Anweisung	Eine Code-Zeile oder eine Methode

Beschreibung

Der Befehl APPLY TO SELECTION wendet für den laufenden Prozess eine Formel auf alle Datensätze der aktuellen Auswahl der Tabelle Tabellenname an. Anweisung kann eine Zeile Code oder eine Methode sein. Ändert Anweisung nur einen Wert in einem Datenfeld der Tabelle Tabellenname, werden die Datensätze automatisch gesichert. Werden keine Datenfelder geändert, werden die Datensätze nur sequentiell gelesen. Sie sind dann für andere Prozesse nicht gesperrt.
Ist die aktuelle Auswahl leer, hat APPLY TO SELECTION keine Auswirkung. Bei einer automatischen Verknüpfung kann Anweisung auch ein Datenfeld aus einer verknüpften Tabelle enthalten.

Die Ausführung von APPLY TO SELECTION wird in einem gesonderten Fenster durch einen Ablaufbalken angezeigt. Der Benutzer kann die Operation in diesem Fenster abbrechen. Rufen Sie vor diesem Befehl den Befehl MESSAGES OFF auf, wird der Ablaufbalken nicht angezeigt.

Mit APPLY TO SELECTION können Sie Information von einer Auswahl an Datensätzen sammeln, z.B. eine Summe oder eine Auswahl ändern. Sie können beispielsweise den ersten Buchstaben eines Datenfeldes in Großschreibung umwandeln. Verwenden Sie diesen Befehl innerhalb einer Transaktion, können Sie alle Änderungen durch Abbrechen der Transaktion rückgängig machen.

4D Server: Der Server führt in Anweisung übergebene Befehle nicht aus. Jeder Datensatz der Auswahl wird zum Ändern zur Arbeitsstation zurückgesendet.

Beispiel 1

Folgendes Beispiel wandelt alle Namen der Tabelle [Employees] in Großbuchstaben um:

 APPLY TO SELECTION([Employees];[Employees]Last Name

 :=Uppercase([Employees]Last Name))

Beispiel 2

Ist ein Datensatz während der Ausführung von APPLY TO SELECTION gesperrt und wird geändert, wird er nicht gesichert. Alle gesperrten Datensätze werden in der Menge LockedSet abgelegt. Prüfen Sie diese Menge nach der Ausführung von APPLY TO SELECTION auf gesperrte Datensätze. Folgende Schleife wird ausgeführt, bis alle Datensätze geändert sind:

 Repeat

    APPLY TO SELECTION([Employees];[Employees]Last Name:=Uppercase([Employees]Last Name))

    USE SET("LockedSet") ` Wähle nur die gesperrten Datensätze

 Until(Records in set("LockedSet")=0)

  ` Beende, wenn es keine gesperrten Datensätze mehr gibt

Beispiel 3

Dieses Beispiel verwendet eine Methode:

 ALL RECORDS([Employees])

 APPLY TO SELECTION([Employees];M_Cap)

Systemvariablen und Mengen

Klickt der Benutzer im Ablaufbalken auf die Schaltfläche Stop, hat die Systemvariable OK den Wert 0 (Null), sonst den Wert 1.