File

Home

4D v19.8

File


File ( path \| 4Dfile {; pathType \| *} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
path \| 4Dfile	Text, Lange Ganzzahl	File-Pfad oder 4D File Konstante
pathType \| *	Lange Ganzzahl, Operator	Ist path übergeben: fk posix path (Standard) oder fk platform path Ist 4Dfile übergeben: * zur Rückgabe von File der Host Datenbank
Funktionsergebnis	Objekt	Neues Objekt File

Beschreibung

Der Befehl File erstellt und gibt ein neues Objekt vom Typ File zurück. Der Befehl akzeptiert zwei Syntaxarten.

File (path{; pathType})

Im Parameter path übergeben Sie den String eines Dateipfads. Sie können einen eigenen String oder ein Filesystem übergeben (z.B., "/DATA/myfile.txt").

Hinweis: Der Befehl File unterstützt nur absolute Pfadnamen. Weitere Informationen dazu finden Sie auf der Seite Pfadnamen für File und Folder als Objekte.

4D erwartet standardmäßig einen Pfad in POSIX Syntax. Arbeiten Sie mit plattformspezifischen Pfadnamen (Windows oder macOS), müssen Sie diese mit dem Parameter pathType deklarieren. Es gibt folgende Konstanten unter dem Thema File and Folder:

Konstante	Typ	Wert	Kommentar
fk platform path	Lange Ganzzahl	1	Pfad in plattformspezifischer Syntax (zwingend bei Pfadname einer Plattform)
fk posix path	Lange Ganzzahl	0	Pfad in POSIX Syntax (Standard)

File (4Dfile{; *})

Im Parameter 4Dfile übergeben Sie eine Datei, integriert in 4D oder vom System. Dazu verwenden Sie eine der folgenden Konstanten:

Konstante	Wert	Kommentar
Backup history file	19	Datei mit Backup Historie (siehe unter Konfiguration und Dateien verfolgen). Wird im Zielordner für Backup gespeichert.
Backup log file	13	Logbuch des aktuellen Backup. Wird im Ordner Logs neben der Strukturdatei der Anwendung gespeichert. Wurde kein Logbuch angelegt oder existiert es nicht, wird ein leerer Pfad zurückgegeben. Es erscheint keine Fehlermeldung.
Backup settings file	18	Aktuell von der Anwendung genutzte Datei backup.4DSettings (xml.-Format). Das kann die Datei mit den Backup-Einstellungen (Standard) sein oder eine Datei mit eigenen Benutzereinstellungen für Backup, die für die Datendatei definiert wurde.
Backup settings file for data	17	Datei backup.4Dsettings (xml Format) für die Datendatei. Wird im Ordner Settings der Datendatei gespeichert
Build application log file	14	Aktuelles Logbuch im xml Format des Application Builder. Wird im Ordner Logs neben der Strukturdatei der Anwendung gespeichert. Wurde kein Logbuch angelegt oder existiert es nicht, wird ein leerer Pfad zurückgegeben. Es erscheint keine Fehlermeldung.
Build application settings file	20	Datei mit Standardeinstellungen des Application Builder ("buildApp.4DSettings"). Wird im Ordner Settings der Anwendung gespeichert.
Compacting log file	6	Logbuch der letzten Komprimierung der Anwendung, die mit dem Befehl Compact data file oder über das Maintenance und Security-Center (MSC) ausgeführt wurde. Wird im Ordner Logs neben der Strukturdatei der Anwendung gespeichert. Wurde kein Logbuch angelegt oder existiert es nicht, wird ein leerer Pfad zurückgegeben. Es erscheint keine Fehlermeldung.
Current backup settings file	1	Standardmäßige Datei Backup.4DSettings (xml Format). Wird im Ordner Settings der Anwendung gespeichert.
Debug log file	12	Mit dem Befehl SET DATABASE PARAMETER(Debug log recording) erstelltes Logbuch. Wird im Ordner Logs neben der Strukturdatei der Anwendung gespeichert. Wurde kein Debug Loguch angelegt oder existiert es nicht, wird ein leerer Pfad zurückgegeben. Es erscheint keine Fehlermeldung.
Diagnostic log file	11	Mit dem Befehl SET DATABASE PARAMETER(Diagnostic log recording) erstelltes Logbuch. Wird im Ordner Logs neben der Strukturdatei der Anwendung gespeichert. Wurde keine Diagnose ausgeführt oder existiert kein Logbuch, wird ein leerer Pfad zurückgegeben. Es erscheint keine Fehlermeldung.
Directory file	16	Datei directory.json mit der Beschreibung von Benutzern und Gruppen (wenn vorhanden) für die Anwendung im Projektmodus. Sie kann im Ordner user settings der Anwendung liegen (Standard, global für das Projekt), oder im Ordner data settings (spezifisch für eine Datendatei).
HTTP debug log file	9	Mit dem Befehl WEB SET OPTION(Web debug log) erstelltes Logbuch. Wird im Ordner Logs neben der Strukturdatei der Anwendung gespeichert. Wurde kein Debug Logbuch angelegt oder existiert es nicht, wird ein leerer Pfad zurückgegeben. Es erscheint keine Fehlermeldung.
HTTP log file	8	Mit dem Befehl WEB SET OPTION(Web log recording) erstelltes Logbuch. Wird im Ordner Logs neben der Strukturdatei der Anwendung gespeichert. Wurde kein Logbuch angelegt oder existiert es nicht, wird ein leerer Pfad zurückgegeben. Es erscheint keine Fehlermeldung.
IMAP Log file	23	Mit dem Befehl SET DATABASE PARAMETER(IMAP Log) erstelltes Logbuch. Wird im Ordner "Logs" der Datenbank gespeichert
Last backup file	2	Letzte Backup Datei mit Namen <baseName>[bkpNum].4BK, an einem eigenen Ort gespeichert
Last journal integration log file	22	Vollständiger Pfadname des Logbuchs mit dem zuletzt integrierten Journal (gespeichert im Ordner Logs der wiederhergestellten Anwendung), falls vorhanden. Diese Datei wird im automatischen Reparaturmodus erstellt, sobald die Integration des Logbuch ausgeführt ist. Weitere Informationen dazu finden Sie im Abschnitt Automatische Wiederherstellung.
Repair log file	7	Protokoll der ausgeführten Reparaturen der Datenbank im Maintenance und Security Center (MSC). Wird im Ordner Logs neben der Strukturdatei der Anwendung gespeichert. Wurde keine Reparatur ausgeführt oder existiert kein Logbuch, wird ein leerer Pfad zurückgegeben. Es erscheint keine Fehlermeldung.
Request log file	10	Logbuch mit standardmäßigen Client-/Server Anfragen (ohne Web Anfragen). das mit SET DATABASE PARAMETER(4D Server log recording) oder SET DATABASE PARAMETER(Client log recording) erstellt wurde. Bei Ausführung auf dem Server wird das Server Log zurückgegeben (gespeichert im Ordner Logs auf dem Server). Bei Ausführung auf dem Client wird das Client Log zurückgegeben (gespeichert im lokalen Ordner Logs des Clients). Existiert kein Logbuch, wird ein leerer Pfad zurückgegeben.
SMTP log file	15	Mit dem Befehl SET DATABASE PARAMETER(SMTP Log) erstelltes Logbuch. Wird im Ordner Logs neben der Strukturdatei der Anwendung gespeichert. Wurde kein SMTP Logbuch angelegt oder existiert es nicht, wird ein leerer Pfad zurückgegeben. Es erscheint keine Fehlermeldung.
User settings file	3	Datei Settings.4DSettings für alle Datendateien, falls aktiviert, im Ordner Settings neben der Strukturdatei der Anwendung gespeichert
User settings file for data	4	Datei Settings.4DSettings für aktuelle Datendatei, im Ordner Settings neben der Datendatei der Anwendung gespeichert
Verification log file	5	Logbücher, die mit den Befehlen VERIFY CURRENT DATA FILE und VERIFY DATA FILE oder über das Maintenance und Security Center (MSC) erstellt wurden. Werden im Ordner Logs neben der Strukturdatei der Anwendung gespeichert. Wurde keine Überprüfung ausgeführt oder existiert kein Logbuch, wird ein leerer Pfad zurückgegeben. Es erscheint keine Fehlermeldung.

Existiert das Ziel 4Dfile nicht, wird ein Objekt Null zurückgegeben. Es erscheint keine Fehlermeldung.

Wird der Befehl über eine Komponente aufgerufen, übergeben Sie den optionalen Parameter *, um den Pfad der Host Datenbank zu erhalten. Ohne den Parameter * wird immer ein Objekt Null zurückgegeben.