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
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.
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 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 angezeigtIn der Adress- oder Task-Leiste erscheinen keine IconsDie geöffnete Datenbank wird nicht im Menü "Öffne zuletzt verwendet" registriertDas Diagnoseprotokoll wird automatisch gestartet (siehe , Selector 79)Jeder Aufruf eines Dialogfensters wird aufgefangen und eine automatische Antwort geliefert (z.B. OK für den Befehl , Abort für eine Fehlermeldung...). Alle aufgefangenen Befehle (*) werden im Diagnoseprotokoll mitgeschriebenFür Wartungszwecke können Sie über den Befehl jeden Text an Standard Ausgabe-Streams senden. Beachten Sie, dass sich 4D Applikationen im headless Modus nur über den Befehl 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.
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 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