Version 2004.5 (Geändert)
Get 4D folder {(Ordner)} alphanumerisch
Parameter | Typ | Beschreibung | |
Ordner | Lange Ganzzahl | Ordnertyp (ohne Angabe = aktiver 4D Ordner) | |
Funktionsergebnis | alphanumerisch | Pfadname zu 4D Ordner |
Beschreibung
Die Funktion Get 4D folder gibt den Pfadnamen zum aktiven 4D Ordner zurück, bzw. zum Ordner der 4D Umgebung, wenn der Parameter Ordner übergeben wurde. Über diese Funktion erhalten Sie den aktuellen Pfadnamen der Ordner, welche die 4D Anwendung verwendet. Mit dieser Funktion stellen Sie sicher, dass Ihr Code auf jeder Plattform funktioniert, die mit einem lokalisierten System läuft.
In Ordner übergeben Sie eine der folgenden Konstanten unter dem Thema "4D Umgebung":
Konstante | Typ | Wert |
Active 4D Folder | Lange Ganzzahl | 0 (Standard) |
Licenses Folder | Lange Ganzzahl | 1 |
Extras Folder | Lange Ganzzahl | 2 |
4D Client Database Folder | Lange Ganzzahl | 3 |
Database Folder | Lange Ganzzahl | 4 |
Database Folder Unix Syntax | Lange Ganzzahl | 5 |
Active 4D Folder
Die 4D Umgebung speichert im 4D Ordner folgende Information:
Dateien zur Registrierung der Benutzer
Dateien Voreinstellungen der 4D Umgebung, Programme, Tools und Hilfsprogramme
Datei mit TCP/IP Netzwerkprotokoll
Lokale Datenbankordner, die 4D Client zum Speichern von Elementen erstellt, die vom Server geladen wurden (Ressourcen, Plug-Ins, Ordner, Extras, etc.).
Sie können im 4D Ordner auch Ihre eigenen online-Hilfedateien, Dateien mit eigenen Einstellungen, etc. speichern. Verwenden Sie Get 4D folder, um den Pfadnamen auf diesen Ordner zu erhalten, stellen Sie auch sicher, dass Ihr Code auf jeder Plattform mit einem beliebigen lokalisierten System läuft.
Definitionen
Festplatte ist die Platte, auf der das Betriebssystem installiert ist.
Benutzer ist der Name des Benutzers, der die aktuelle Sitzung geöffnet hat.
Der 4D Ordner liegt standardmäßig an folgender Stelle:
Unter Windows: {Festplatte}:\Dokumente und Einstellungen\All Users\Anwendungsdaten\4D
Mit der 4D Client Anwendung bzw. bei gesperrtem Ordner All Users wird der aktive 4D Ordner an folgender Stelle erstellt:
Unter Windows: {Festplatte}:\Dokumente und Einstellungen\Benutzer\Anwendungsdaten\4D
Auf Mac OS: {Festplatte}:Benutzer:Benutzer.Library:Application Support:4D
Licenses Folder
Der Ordner enthält die Lizenzdateien des Rechners.
Er liegt an folgender Stelle:
Unter Windows: {Festplatte}:\Dokumente und Einstellungen\
AllUsers\Anwendungsdaten\4D\Licenses
Auf Mac OS : {Festplatte}:Library:Application Support:4D:Licenses
Extras Folder (Client Rechner)
Ordner mit angepasstem Inhalt, der auf jeden Rechner mit 4D Client geladen wird. Sie verwenden diesen Ordner, um eigene Elemente vom Server auf die Client Rechner zu übertragen (Datei Ressourcen, Textdokumente, Datei mit XML Voreinstellungen, etc.). Die Originalhierarchie des Ordners wird auf jedem Client-Rechner wiedergegeben.
4D Server verwaltet automatisch die Änderungen in diesem Ordner und überträgt nur das, was erforderlich ist. Darüberhinaus wird der Inhalt des Ordners komprimiert, um die Übertragungszeit über das Netzwerk zu optimieren.
Auf 4D Server oder in 4th Dimension Einzelplatz muss der Originalordner Extras neben der Strukturdatei der Datenbank liegen.
Auf jedem 4D Client wird der Ordner Extras an folgende Stelle geladen:
Unter Windows: {Festplatte}:\Dokumente und Einstellungen\Aktueller Benutzer\
Anwendungsdaten\4D\DatenbankName_Adresse\Extras
Auf Mac OS: {Festplatte}:Benutzer:Benutzer.Library:
Application Support:4D:DatenbankName_Adresse:Extras
4D Client Database Folder (Client Rechner)
4D Datenbank Ordner, der auf jedem 4D Client Rechner angelegt wird, zum Speichern von Dateien und Ordnern, die zur Datenbank gehören (Ressourcen, Plug-Ins, OrdnerExtras, etc.).
Der Ordner liegt auf dem Client Rechner an folgender Stelle:
Unter Windows: {Festplatte}:\Dokumente und Einstellungen\Benutzer\Anwendungsdaten\4D\DatenbankName_Adresse
Auf Mac OS: {Festplatte}:Library:Application Support:4D:DatenbankName_Adresse:
Database Folder
Ordner mit der Strukturdatei der Datenbank. Der Pfadname wird in der standardmäßigen Syntax der aktuellen Plattform dargestellt.
In der 4D Client-Anwendung entspricht diese Konstante exaxt der bisherigen Konstante 4D Client Database Folder: Sie gibt den Pfadnamen des lokal erstellten Ordners zurück.
Database Folder Unix Syntax
Ordner mit der Strukturdatei der Datenbank. Diese Konstante bezeichnet denselben Ordner wie die vorige, der Pfadname wird jedoch in der Unix Syntax (Posix) vom Typ /Users/... dargestellt. Diese Syntax wird hauptsächlich mit dem Befehl LAUNCH EXTERNAL PROCESS unter Mac OS oder dem Befehl SET CGI EXECUTABLE zurückgegeben.
Beispiele
1. Sie wollen während dem Starten einer Datenbank im Einzelplatzbetrieb in eine Datei aus dem 4D Ordner eigene Einstellungen laden oder erstellen. Ihr Code könnte folgendermaßen aussehen:
MAP FILE TYPES("PREF";"PRF";"Preferences file") ` Setze Dateityp PREF MacOS auf .PRF Windows Dateierweiterung $vsPrefDocName:=Get 4D folder+"MyPrefs" ` Erstelle Pfadname zur Datei Voreinstellungen ` Prüfe, ob die Datei existiert If (Test path name($vsPrefDocName+(".PRF"*Num(On Windows)))#Is a document) $vtPrefDocRef:=Create document($vsPrefDocName;"PREF") ` Falls nein, erstelle sie Else $vtPrefDocRef:=Open document($vsPrefDocName;"PREF") ` Falls ja, öffne sie End if If (OK=1) ` Inhalt der Prozessdokumente CLOSE DOCUMENT($vtPrefDocRef) Else ` Verwalte Fehler End if
2. Dieses Beispiel zeigt die Verwendung der Konstanten Database Folder Unix Syntax unter Mac OS, um den Inhalt des Datenbankordners anzuzeigen:
$posixpath:="\""+Get 4D folder(Database Folder Unix Syntax)+"\"" $myfolder:="ls -l "+$posixpath $in:="" $out:="" $err:="" LAUNCH EXTERNAL PROCESS($myfolder;$in;$out;$err)
Hinweis: Unter Mac OS müssen Sie die Pfadnamen in Anführungszeichen setzen, wenn sie Datei- oder Ordnernamen mit Leerzeichen enthalten. Über das Sonderzeichen "\"oder die Anweisung Char(Double quote) können Sie Anführungszeichen in den String einfügen.
Referenz
System folder, Temporary folder, Test path name.