Befehle für Zugriff auf Designobjekte

Home

4D v20 R7

In 4D können Sie in Ihren Anwendungen per Programmierung auf den Inhalt von Methoden zugreifen. Das Source Toolkit vereinfacht die Integration von Werkzeugen zur Code-Kontrolle und insbesondere zur Versionskontrolle (VCS). Sie können auch ausgeklügelte Systeme einrichten, um Code zu dokumentieren, einen eigenen Explorer anzulegen oder geplante Backups des Code zu organisieren, die als Datei gesichert werden.

Es wurden folgende Prinzipien integriert:

Jede Methode und jedes Formular in einer 4D Anwendung hat eine eigene Adresse in Form eines Pfadnamens. So liegt beispielsweise die Triggermethode für Tabelle 1 unter "[trigger]/tabelle_1". Jeder Pfadname eines Objekts ist einmalig in der Anwendung.
Hinweis: Damit die Einmaligkeit von Pfadnamen sichergestellt ist, erlaubt 4D nicht länger, auf verschiedenen Formularseiten Objekte mit demselben Namen zu erstellen. In konvertierten Datenbanken vor 4D v13 findet das MSC diese doppelten Namen und repariert sie.
Über die Befehle dieses Kapitels können Sie auf Objekte in der 4D Anwendung zugreifen, z.B. METHOD GET NAMES oder METHOD GET PATHS.
Die meisten Befehle dieses Kapitels funktionieren im interpretierten und kompilierten Modus. Befehle, die Eigenschaften verändern oder auf über Methoden ausführbaren Inhalt zugreifen sind nur im interpretierten Modus verwendbar (siehe Tabelle unten)
Sie können einige Befehle dieses Kapitels mit 4D im lokalen oder im remote Modus verwenden.
Beachten Sie jedoch, dass Sie diese Befehle nicht im kompilierten Modus verwenden können. Sie dienen vielmehr dazu, eigene Werkzeuge zur Entwicklungsunterstützung zu erstellen. Sie dürfen sie nicht einsetzen, um die Funktionsweise der Anwendung im laufenden Betrieb dynamisch zu verändern. Sie können z.B. nicht den Befehl METHOD SET ATTRIBUTE verwenden, um je nach Status des aktuellen Benutzers ein Attribut der Methode zu ändern.
Wird ein Befehl dieses Kapitels von einer Komponente aufgerufen, greift er standardmäßig auf die Objekte der Komponente zu. Wollen Sie jedoch auf Objekte der Host Datenbank zugreifen, übergeben Sie den * als letzten Parameter. Beachten Sie, dass nur diese Syntax für Befehle möglich ist, die Objekte ändern, z.B. METHOD SET ATTRIBUTE, da Komponenten immer im Nur-Lesen Modus ausgeführt werden.

Pfad-Syntax

Here is the syntax of paths to different methods and forms in the 4D application:

Path	Description
class	Pfad der Klassendefinition. Beispiel: [class]/MyClass
class function	Pfad der Klassenfunktion. Beispiel: [class]/MyClass/myFunction
database method	Pfad der angegebenen Datenbankmethoden. Liste dieser Methoden: [databaseMethod]/onStartup [databaseMethod]/onExit [databaseMethod]/onDrop [databaseMethod]/onBackupStartup [databaseMethod]/onBackupShutdown [databaseMethod]/onWebConnection [databaseMethod]/onWebAuthentication [databaseMethod]/onWebSessionSuspend [databaseMethod]/onServerStartup [databaseMethod]/onServerShutdown [databaseMethod]/onServerOpenConnection [databaseMethod]/onServerCloseConnection [databaseMethod]/onSystemEvent [databaseMethod]/onSqlAuthentication [databaseMethod]/onHostDatabaseEvent [databaseMethod]/onRESTAuthentication [databaseMethod]/onMobileAppAuthentication [databaseMethod]/onMobileAppAction
project form	Pfad der Projektformmethoden und aller ihrer Objektmethoden. Beispiele: [projectForm]/myForm/{formMethod} [projectForm]/myForm/button1 [projectForm]/myForm/my list [projectForm]/myForm/button1
project method	Name der Methode. Beispiel: MyProjectMethod
table form	Pfad der Tabellenformmethoden und aller ihrer Objektmethoden. Beispiele: [tableForm]/table_1/Form1/{formMethod} [tableForm]/table_1/Form1/button1 [tableForm]/table_1/Form1/my list [tableForm]/table_2/Form1/my list
trigger	Pfad der Datenbank-Trigger. Beispiele: [trigger]/table_1 [trigger]/table_2

Pfadnamen erstellen

4D erstellt standardmäßig keine Datei auf der Festplatte. Pfadnamen für Objekte sind jedoch kompatibel mit der Dateiverwaltung des jeweiligen Betriebssystems; d.h. es kann Dateien über Ihre eigenen Import- bzw. Exportmethoden direkt auf der Festplatte erzeugen.
Insbesondere verbotene Zeichen, wie "?" werden in Methodennamen codiert. Bei Bedarf lassen sich generierte Dateien automatisch in ein System zur Versionskontrolle integrieren.
Es folgt die Liste der codierten Zeichen:

Zeichen	Codierung
"	%22
*	%2A
/	%2F
:	%3A
<	%3C
>	%3E
?	%3F
\|	%7C
\	%5C
%	%25

Beispiele:
Form?1 wird codiert als Form%3F1
Button/1 wird codiert als Button%2F1

Verwendung im kompilierten Modus

Es liegt in der Natur des Kompilierungsprozesses, dass nur bestimmte Befehle dieses Kapitels im kompilierten Modus verwendbar sind. Nachfolgende Tabelle zeigt, für welche Befehle das gilt:

Befehl	Im kompilierten Modus verwendbar
Current method path	Ja
FORM EDIT	Nein (*)
FORM GET NAMES	Ja
METHOD Get attribute	Ja
METHOD GET ATTRIBUTES	Ja
METHOD GET CODE	Nein (*)
METHOD GET COMMENTS	Ja
METHOD GET FOLDERS	Ja
METHOD GET MODIFICATION DATE	Ja
METHOD GET NAMES	Ja
METHOD Get path	Ja
METHOD GET PATHS	Ja
METHOD GET PATHS FORM	Ja
METHOD OPEN PATH	Nein (*)
METHOD RESOLVE PATH	Ja
METHOD SET ACCESS MODE	Ja
METHOD SET ATTRIBUTE	Nein (*)
METHOD SET ATTRIBUTES	Nein (*)
METHOD SET CODE	Nein (*)
METHOD SET COMMENTS	Nein (*)

(*) Bei Ausführung im kompilierten Modus wird der Fehler -9762 generiert: "Der Befehl lässt sich nicht in einer kompilierten Datenbank verwenden."