4D v14.3

Get 4D folder

Home

 
4D v14.3
Get 4D folder

Get 4D folder 


 

Get 4D folder ( {Ordner}{;}{*} ) -> Funktionsergebnis 
Parameter Typ   Beschreibung
Ordner  Lange Ganzzahl in Ordnertyp (ohne Angabe = aktiver 4D Ordner)
Operator in Gibt den Ordner der Host Datenbank zurück
Funktionsergebnis  String in Pfadname zu 4D Ordner

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
4D Client database folder Lange Ganzzahl 3
Active 4D Folder Lange Ganzzahl 0
Current resources folder Lange Ganzzahl 6
Database folder Lange Ganzzahl 4
Database folder Unix syntax Lange Ganzzahl 5
Extras folder Lange Ganzzahl 2
HTML Root folder Lange Ganzzahl 8
Licenses folder Lange Ganzzahl 1
Logs folder Lange Ganzzahl 7

Es folgt die Beschreibung der einzelnen Ordner

Definitionen

  • {Festplatte} ist die Platte, auf der das Betriebssystem installiert ist.
  • Benutzer ist der Name des Benutzers, der die aktuelle Sitzung geöffnet hat.

Die 4D Umgebung speichert im 4D Ordner folgende Information:

  • Dateien Preferences der Anwendungen der 4D Umgebung
  • Datei Shortcuts.xml (eigenen Tastenkürzel)
  • Ordner Macros v2 (Makro Befehle des Methodeneditors)
  • Ordner Favorites v11, Favorites v12 oder Favorites v13 (Pfadnamen für lokale und remote Datenbanken, die geöffnet wurden)

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.

Der 4D Ordner liegt standardmäßig an folgender Stelle:

  • Unter Windows 7 und höher: {Festplatte}\Users\Benutzername\AppData\Roaming\4D
  • Auf OS X: {Festplatte}:Benutzer:Benutzername:Library:Application Support:4D

Der Ordner enthält die Lizenzdateien des Rechners. Er liegt an folgender Stelle:

  • Unter Windows 7: {Festplatte}:\ProgramData\4D\Licenses
  • Auf OS X: {Festplatte}:Library:Application Support:4D:Licenses
Hinweise:
  • Bei einer Anwendung mit einkompilierter 4D Volume Desktop ist der Ordner Licenses im Paket der Anwendung enthalten.
  • Kann der Ordner Licenses nicht im System erstellt werden, weil die Authorisation dazu fehlt, wird er an folgender Stelle angelegt:
    • Unter Windows 7 und höher: {Festplatte}:\Users\Current user\AppData\Roaming\4D\Licenses
    • Auf OS X: {Festplatte}:Users:Current user:Library:Application Support:4D:Licenses

Ordner mit angepasstem Inhalt, der auf jeden Client-Rechner geladen wird.

Hinweis zur Kompatibilität: Ab 4D Version 11.2 SQL sollte der Ordner Extras nicht mehr für die angepasste Kommunikation zwischen Server und Remote-Rechnern verwendet werden. Wir empfehlen, dafür den Ordner Resources zu verwenden (Beschreibung siehe unten). 4D Server unterstützt zur Wahrung der Kompatibilität mit vorhandenen Anwendungen weiterhin den Ordner Extras.

Hinweis: Existiert der Ordner Extras nicht für die Datenbank, wird er angelegt, wenn Sie die Funktion Get 4D folder mit der Konstanten Extras Folder ausführen.

4D Datenbank Ordner, der auf jedem Client Rechner angelegt wird, zum Speichern von Dateien und Ordnern, die zur Datenbank gehören (Ressourcen, Plug-Ins, Ordner Resources, etc.).
Der Ordner liegt auf dem Client-Rechner an folgender Stelle:

  • Unter Windows 7 und höher: {Festplatte}:\Users\Benutzername\AppData\Local\4D\DatenbankName_Adresse
  • Auf OS X: {Festplatte}:Users:Benutzername:Library:Caches:4D:DatenbankName_Adresse:

Ordner mit der Strukturdatei der Datenbank. Der Pfadname wird in der standardmäßigen Syntax der aktuellen Plattform dargestellt.
In der Client-Anwendung entspricht diese Konstante exakt der bisherigen Konstante 4D Client Database Folder: Sie gibt den Pfadnamen des lokal erstellten Ordners zurück.

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 OS X zurückgegeben.

Ordner Resources der Datenbank. Dieser Ordner enthält zusätzliche Elemente (Bilder, Text) für die Datenbankoberfläche. Eine Komponente kann einen eigenen Ordner Resources haben. Der Ordner Resources liegt neben der Struktur der Datenbank.
Im Client/Server-Betrieb kann dieser Ordner zur Übertragung eigener Elemente zwischen Server- und Client-Rechner dienen. Der Inhalt dieses Ordners wird automatisch aktualisiert, wenn sich der Client-Rechner anmeldet. Im Client/Server-Betrieb werden alle diesem Ordner zugewiesenen Referenz-Mechanismen unterstützt(Ordner .lproj, XLIFF, Bilder, etc.) 4D bietet darüberhinaus verschiedene Tools, um diesen Ordner dynamisch zu verwalten und zu aktualisieren, insbesondere einen Ressourcen Explorer.

Hinweis: Existiert der Ordner Resources nicht für die Datenbank, wird er angelegt, wenn Sie die Funktion Get 4D folder mit der Konstanten CurrentResources Folder ausführen.

Ordner Logs der Datenbank mit den Logbüchern der aktuellen Datenbank. Er liegt auf derselben Ebene wie die Strukturdatei und enthält folgende Logbücher:

  • Datenbankkonvertierung,
  • Web Server Anfragen,
  • Überprüfung und Reparatur der Daten,
  • Überprüfung und Reparatur der Struktur,
  • Journal zu Backup/Wiederherstellen Aktivitäten,
  • Debugging der Befehle und Funktionen,
  • 4D Server Anfragen (auf Client-Rechnern und auf dem Server generiert).

Hinweis: Existiert der Ordner Logs nicht für die Datenbank, wird er angelegt, wenn Sie die Funktion Get 4D folder mit der Konstanten Logs Folder ausführen.

Aktueller HTML Root Ordner der Datenbank zurück. Der zurückgegebene Pfadname wird in der standardmäßigen Syntax der aktuellen Plattform dargestellt. Es ist der Ordner, in dem der 4D Web Server nach den angefragten Web Dateien und Seiten sucht. Der Ordner heißt standardmäßig WebFolder und liegt neben der Strukturdatei (oder eine lokale Kopie bei 4D im remote Modus). Sie können diesen Speicherort in den Einstellungen der Datenbank auf der Seite Web>Konfiguration oder dynamisch über den Befehl WEB SET ROOT FOLDER verändern.
Wird die Funktion Get 4D folder über ein Remote 4D aufgerufen, wird der Pfad des Remote Rechners und nicht der von 4D Server zurückgegeben.

Der optionale Parameter * ist hilfreich beim Arbeiten mit Komponenten. Damit können Sie die Datenbank (Host oder Komponente) bestimmen, für welche Sie den Pfadnamen des Ordners erhalten möchten. Dieser Parameter gilt nur für Database Folder, Database Folder Unix Syntax und Current Resources folder. In allen anderen Fällen hat er keine Auswirkung.

Wird die Funktion von einer Komponente aus aufgerufen:

  • Ist der Parameter * übergeben, gibt die Funktion den Pfadnamen der Host Datenbank zurück.
  • Ist der Parameter * nicht übergeben, gibt die Funktion den Pfadnamen des Ordners Components zurück.
    Der zurückgegebene Datenbankordner (Database Folder und Database Folder Unix Syntax) ist unterschiedlich, je nach der Art der Komponentenarchitektur:
    - Bei einem Ordner .4dbase/package gibt die Funktion den Pfadnamen des Ordners .4dbase/package zurück,
    - Bei einer Datei .4db oder .4dc gibt die Funktion den Pfadnamen des Ordners Components zurück,
    - Bei einem Alias oder einer Verknüpfung gibt die Funktion den Pfadnamen des Ordners mit der Original Matrix Datenbank zurück. Das Ergebnis ist unterschiedlich, je nach dem Format dieser Datenbank (Ordner .4dbase /package oder Datei .4db/.4dc), wie oben beschrieben.
    Wird der Befehl von der Host Datenbank aus aufgerufen, gibt er immer den Pfadnamen des Host Datenbankordners zurück, unabhängig ob der Parameter * übergeben ist oder nicht.

Sie wollen während dem Starten einer Datenbank im Einzelplatzbetrieb in eine Datei aus dem 4D Ordner eigene Einstellungen laden oder erstellen. Ihr Code in der Datenbankmethode On Startup könnte folgendermaßen aussehen:

 MAP FILE TYPES("PREF";"PRF";"Preferences file")
  ` Setze Dateityp PREF Mac OS 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

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: Auf 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.

Ist der Parameter Ordner ungültig oder wird der Pfadname leer zurückgegeben, wird die Systemvariable OK auf 0 (Null) gesetzt.

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: 4D Umgebung
Nummer: 485

Dieser Befehl ändert die Systemvariable OKIm remote Modus anderes Verhalten

 
GESCHICHTE 

Geändert: 4D v11 SQL Release 2
Geändert: 4D v13

 
SIEHE AUCH 

COMPONENT LIST
System folder
Temporary folder
Test path name
WEB SET ROOT FOLDER

 
SCHLÜSSELWÖRTER 

Folder

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)

Geerbt von : Get 4D folder ( 4D v11 SQL Release 6)
Gesplittet : Get 4D folder ( 4D v13.5)