Get 4D folder

4D - Documentation   Français   English   German   4D Programmiersprache, Befehle nach Themen   4D Programmiersprache, Befehle alphabetisch   4D Programmiersprache, Konstanten nach Themen   Back   Previous   Next

Version 2004.5 (Geändert)


Get 4D folder {(Ordner)} alphanumerisch

ParameterTypBeschreibung
OrdnerLange GanzzahlOrdnertyp (ohne Angabe = aktiver 4D Ordner)
FunktionsergebnisalphanumerischPfadname 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":

KonstanteTypWert
Active 4D FolderLange Ganzzahl0 (Standard)
Licenses FolderLange Ganzzahl1
Extras FolderLange Ganzzahl2
4D Client Database FolderLange Ganzzahl3
Database FolderLange Ganzzahl4
Database Folder Unix SyntaxLange Ganzzahl5

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.

Anwendung des Befehls

Wo ist der 4D Ordner


4D - Documentation   Français   English   German   4D Programmiersprache, Befehle nach Themen   4D Programmiersprache, Befehle alphabetisch   4D Programmiersprache, Konstanten nach Themen   Back   Previous   Next