4D über Befehlszeilen verwenden

Home

4D v20 R7

Sie können Ihre 4D Programme über Befehlszeilen im macOS Terminal oder in der Windows Konsole steuern (4D und 4D Server). Sie können folgendes ausführen:

Eine Datenbank remote starten. Das ist insbesondere beim Verwalten von Web Servern hilfreich.
Automatische Tests für Ihre Anwendungen durchführen
Automatische Deployments/Updates steuern

Grundlagen

Sie können Befehlszeilen für 4D Programme im macOS Terminal oder in der Windows Konsole ausführen:

Auf macOS müssen Sie den Befehl Öffnen verwenden
Unter Windows können Sie die Argumente direkt übergeben

Hinweis: Auf macOS können Sie die Parameter direkt übergeben, wenn Sie zum Ordner gehen, in dem das Programm innerhalb des Pakets abgelegt ist (Contents/MacOS Pfad). So können Sie auf den stderr Stream zugreifen. Liegt das 4D Paket z.B. im Ordner MeinOrdner, schreiben Sie die Befehlszeile wie folgt: /MeinOrdner/4D.app/Contents/MacOS/4D &. Müssen Sie dagegen nicht auf den stderr Stream zugreifen, empfehlen wir, immer den Befehl Öffnen zu verwenden.

Eine 4D Applikation starten

Es folgt die Beschreibung der Befehlszeilen und Argumente zum Starten einer 4D Applikation.

Syntax

<applicationPath> [--structure] [<structurePath | packagePath | 4dlinkPath> [--data <dataPath>]] [--opening-mode interpreted | compiled] [--create-data] [--user-param <user string>] [--headless] [--version] [--help]

Argument	Wert	Beschreibung
applicationPath	Pfad der 4D, 4D Server oder Anwendung mit einkompilierter Engine	Startet die Applikation. Identisch mit Doppelklick auf die 4D Applikation. Bei Aufruf ohne das Argument Strukturdatei wird die Anwendung ausgeführt und das Dialogfenster zum Auswählen der Datenbank erscheint.
--structure	Strukturpfad \| Packagepfad \| 4dlinkpfad	Strukturdatei zum Öffnen mit der aktuellen Datendatei. Es erscheint kein Dialogfenster.
--data	Datenpfad	Datendatei zum Öffnen mit der zugewiesenen Strukturdatei. Ist sie nicht angegeben, verwendet 4D die zuletzt geöffnete Datendatei.
--opening-mode	interpretiert \| kompiliert	Fragt an, die Anwendung im interpretierten oder kompilierten Modus zu öffnen. Ist der angefragte Modus nicht verfügbar, erscheint kein Fehler.
--create-data		Erstellt automatisch eine neue Datendatei, wenn keine gültige Datendatei gefunden wird. Es erscheint kein Dialogfenster. 4D verwendet den im Parameter "--data" übergebenen Namen, wenn vorhanden (generiert einen Fehler, wenn es bereits eine Datei mit demselben Namen gibt).
--user-param	Eigener Benutzer String	Text, der in der 4D Anwendung über den Befehl Get database parameter ausgelesen werden kann (String darf nicht mit "-" beginnen, da dieses Zeichen reserviert ist.)
--headless		Startet 4D, 4D Server oder Anwendung mit einkompilierter Engine ohne Oberfläche (headless Modus). Dann gilt folgendes: Werkzeugleiste, Menüleiste, MDI Fenster oder Startbildschirm werden nicht angezeigt In der Adress- oder Task-Leiste erscheinen keine Icons Die geöffnete Datenbank wird nicht im Menü "Öffne zuletzt verwendet" registriert Das Diagnoseprotokoll wird automatisch gestartet (siehe SET DATABASE PARAMETER, Selector 79) Jeder Aufruf eines Dialogfensters wird aufgefangen und eine automatische Antwort geliefert (z.B. OK für den Befehl ALERT, Abort für eine Fehlermeldung...). Alle aufgefangenen Befehle (*) werden im Diagnoseprotokoll mitgeschrieben Für Wartungszwecke können Sie über den Befehl LOG EVENT jeden Text an Standard Ausgabe-Streams senden. Beachten Sie, dass sich 4D Applikationen im headless Modus nur über den Befehl QUIT 4D oder den Taskmanager des Betriebssystems schließen lassen
--version		Zeigt die Version der Applikation und beendet
--help		Zeigt die Hilfe und beendet. Alternative Argumente: -?, -h

(*) Einige Dialoge erscheinen vor dem Öffnen der Anwendung, so dass es unmöglich ist, sie im Diagnoseprotokoll mitzuschreiben (Lizenzwarnung, Konvertierungsdialog, Auswahl der Strukturdatei, Auswahl der Datendatei). In solchen Fällen wird im stderr Stream und im System Event Log eine Fehlermeldung generiert.

Beispiele

Diese Beispiele gehen davon aus, das Ihr 4D Programm auf dem Desktop gespeichert ist und die zu öffnende Anwendung im Ordner Documents liegt.

Hinweis: Der aktuelle Ordner des Benutzers wird auf macOS über "~" aufgerufen, unter Windows über "%HOMEPATH%"

Programm starten
macOS:
open ~/Desktop/4D.app

Beispiel für Windows:
%HOMEPATH%\Desktop\4D\4D.exe

Programm mit Package Datei auf macOS starten:
open ~/Desktop/4D.app --args ~/Documents/myDB.4dbase

Programm mit einer Projektdatei starten
macOS:
open ~/Desktop/4D.app --args ~/Documents/myProj/Project/myProj.4DProject

Windows:
%HOMEPATH%\Desktop\4D\4D.exe %HOMEPATH%\Documents\myProj\Project\myProj.4DProject

Programm mit Projektdatei und Datendatei starten
macOS:
open ~/Desktop/4D.app --args --project ~/Documents/myProj/Project/myProj.4DProject --data ~/Documents/data/myData.4DD

Windows:
%HOMEPATH%\Desktop\4D\4D.exe --project %HOMEPATH%\Documents\myProj\Project\myProj.4DProject --data %HOMEPATH%\Documents\data\myData.4DD oder: %HOMEPATH%\Desktop\4D\4D.exe /project %HOMEPATH%\Documents\myProj\Project\myProj.4DProject /data %HOMEPATH%\Documents\data\myData.4DD

Programm mit einer Datei .4DLink starten
macOS:
open ~/Desktop/4D.app ~/Desktop/MyDatabase.4DLink

open "~/Desktop/4D Server.app" ~/Desktop/MyDatabase.4DLink

Windows:
%HOMEPATH%\Desktop\4D.exe %HOMEPATH%\Desktop\MyDatabase.4DLink

"%HOMEPATH%\Desktop\4D Server.exe" %HOMEPATH%\Desktop\MyDatabase.4DLink

Programm im kompilierten Modus starten und Datendatei anlegen, falls keine vorhanden ist
macOS:
open ~/Desktop/4D.app ~/Documents/myBase.4dbase --opening-mode compiled --create-data true

Windows:
%HOMEPATH%\Desktop\4D\4D.exe %HOMEPATH%\Documents\myBase.4dbase\myDB.4db --opening-mode compiled --create-data true

Programm mit Projektdatei und Datendatei starten und einen String als Benutzerparameter übergeben
macOS:
open ~/Desktop/4D.app --args --project ~/Documents/myProj/Project/myProj.4DProject --data ~/Documents/data/myData.4DD --user-param "Hello world"

Windows:
%HOMEPATH%\Desktop\4D\4D.exe --project %HOMEPATH%\Documents\myProj\Project\myProj.4DProject --data %HOMEPATH%\Documents\data\myData.4DD --user-param "Hello world"

Programm ohne Oberfläche starten (headless Modus)
macOS:
open ~/Desktop/4D.app --args --structure ~/Documents/myBase.4dbase --data ~/Documents/data/myData.4DD --headless

Windows:
%HOMEPATH%\Desktop\4D\4D.exe --structure %HOMEPATH%\Documents\myBase.4dbase\myDB.4db --data %HOMEPATH%\Documents\data\myData.4DD --headless

Siehe auch

Headless 4D applications (blog post)