4D Doc Center : METHOD GET PATHS FORM

Home

4D v14.3

METHOD GET PATHS FORM


METHOD GET PATHS FORM ( {Tabellenname ;} arrPfade {; Filter}{; Zeitstempel}{; *} )

Parameter	Typ	Beschreibung
Tabellenname	Tabelle	Referenz der Tabelle
arrPfade	Array Text	Array mit Methodenpfaden und Namen
Filter	Text	Namen filtern
Zeitstempel	Variable Lange Ganzzahl	Mindestwert des Zeitstempel
		Neuer aktueller Wert
*	Operator	Mit Stern: Befehl gilt für Host Datenbanken, wenn er von einer Komponente ausgeführt wird. (außerhalb dieses Kontexts wird der Parameter ignoriert.)

Beschreibung

Der Befehl METHOD GET PATHS FORM füllt das Array arrPfade mit den internen Pfadnamen und Namen aller Formularobjektmethoden sowie Formularmethoden. Formularmethoden werden bezeichnet mit {formMethod}.
Nur Objekte mit Code werden aufgelistet. So erscheinen beispielsweise keine Schaltflächen, denen nur eine Standardaktion zugeordnet ist.

Übergeben Sie den Parameter Tabellenname, gibt der Befehl die Objekte der Tabellenformulare zurück, die dieser Tabelle zugeordnet sind. Lassen Sie diesen Parameter weg, gibt er die Objekte der Projektformulare der Datenbank zurück.
Sie können die Liste der Formulare begrenzen, wenn Sie im Parameter Filter einen Vergleichsstring übergeben: Dann erscheinen nur Formulare, deren Namen zum Filter passen. Mit dem Jokerzeichen @ können Sie Filter vom Typ "beginnt mit", "endet mit" oder "enthält" übergeben. Übergeben Sie einen leeren String, wird der Parameter Filter ignoriert. Mit dem Parameter Zeitstempel werden nur Pfade von Methoden zurückgegeben, die nach einem bestimmten Zeitpunkt geändert wurden. Als Teil eines Systems zur Versionskontrolle bedeutet dies, dass Sie nur Methoden updaten müssen, die seit dem letzten Backup geändert wurden.
Es funktioniert folgendermaßen: 4D verwaltet einen Zähler für Methodenänderungen, d.h. immer wenn eine Methode erstellt oder erneut gesichert wird, erhöht sich der Zähler und sein aktueller Wert wird im internen Stempel der Methode gespeichert.
Übergeben Sie den Parameter Zeitstempel, gibt der Befehl nur Methoden zurück, deren Stempel größer oder gleich dem hier übergebenen Wert ist. Außerdem gibt der Befehl in Zeitstempel den neuen aktuellen Wert des Zählers der Änderung zurück, z.B. den höchsten Wert. Sichern Sie diesen Wert, können Sie ihn beim nächsten Aufrufen des Befehls übergeben, so dass Sie nur neue bzw. geänderte Methoden erhalten.

Wird der Befehl in einer Komponente ausgeführt, gibt er standardmäßig die Pfade der Komponentenmethoden zurück. Übergeben Sie den Parameter *, enthält das Array die Pfade der Methoden in der Host Datenbank.

Hinweis: Der Befehl listet keine Objekte von vererbten Formularen bzw. Unterformularen.

Findet der Befehl einen duplizierten Methodennamen, wird der Fehler -9802 generiert (Objektpfad ist nicht einmalig). In diesem Fall empfehlen wir, das MSC aufzurufen und die Datenbankstruktur zu überprüfen.

Beispiel 1

Liste aller Objekte des Eingabeformulars zur Tabelle [Employees]. Beachten Sie, dass Tabellenformularmethoden und Projektformularmethoden als Objekte bearbeitet werden, die zu einem Formular gehören:

 METHOD GET PATHS FORM([Employees];arrPaths;"input")

  // Inhalt von arrPaths (zum Beispiel)

  // [tableForm]/input/{formMethod} -> Formularmethode

  // [tableForm]/input/bOK -> Objektmethode

  // [tableForm]/input/bCancel -> Objektmethode

Beispiel 2

Liste der Objekte zum Projektformular "dial":

METHOD GET PATHS FORM(arrPaths;"dial")

Beispiel 3

Liste aller Objekte zum Eingabeformular der Tabelle [Employees] in einer Komponente:

METHOD GET PATHS FORM(([Employees];arrPaths;"input@";*)