Interface ligne de commande

4D v20 R7

Vous pouvez utiliser le Terminal de macOS ou la console de Windows afin de piloter vos applications 4D (4D et 4D Server) par lignes de commande. Cette fonctionnalité permet notamment :

d’ouvrir une base de données à distance, ce qui est particulièrement utile pour les administrateurs de serveurs Web.
d'exécuter des tests automatiques pour vos applications.

Principes d’utilisation

Vous pouvez exécuter les lignes de commande relatives aux applications 4D à l’aide du Terminal de macOS ou de la console de Windows.

Sous macOS, vous devez utiliser la commande open.
Sous Windows, il suffit de passer directement les arguments.

Note : Sous macOS, vous pouvez passer directement les arguments en accédant au dossier dans lequel se trouve l’application, à l’intérieur du progiciel (chemin Contents/MacOS), qui permet de gérer le flux stderr. Par exemple, si le progiciel 4D se trouve dans le dossier MonDossier, vous devez écrire la ligne de commande ainsi : /MonDossier/4D.app/Contents/MacOS/4D &. Il est cependant recommandé d'utiliser la commande open lorsque vous n'avez pas besoin d'accéder au flux stderr.

Lancer une application 4D

Voici une description des lignes de commandes et de leurs arguments pris en charge pour le lancement d'une application 4D.

Syntaxe

<cheminApplication> [--project] [<cheminProjet | cheminPackage | chemin4Dlink> [--data <cheminDonnées>]] [--opening-mode interpreted | compiled] [--create-data] [--user-param <chaîne utilisateur>] [--headless][--version] [--help]

Argument	Valeur	Description
applicationPath	Chemin de l'application 4D, 4D Server ou de l'application fusionnée	Lance l'application. Identique à un double-clic sur l'application 4D. Lorsque l'application est appelée sans l'argument fichier de projet, elle est exécutée et la boite de dialogue de sélection de base apparaît.
--project	cheminProjet \| cheminPackage \| chemin4Dlink	Fichier projet à ouvrir avec le fichier de données courant. Aucune boîte de dialogue n'apparaît.
--structure	cheminStructure \| cheminPackage \| chemin4Dlink	Fichier de structure à ouvrir avec le fichier de données courant. Aucune boite de dialogue n'apparait.
--data	cheminDonnées	Fichier de données à ouvrir avec le fichier de structure désigné. S'il n'est pas précisé, 4D utilise le dernier fichier de données ouvert.
--opening-mode	interpreted \| compiled	Demande à la base de données de s'ouvrir en mode interprété ou compilé. Aucune erreur n'est générée si le mode requis est indisponible.
--create-data		Crée automatiquement un nouveau fichier de données si aucun fichier de données valide n'est trouvé. Aucune boite de dialogue n'apparaît. 4D utilise le nom du fichier passé dans l’argument "--data" le cas échéant (génère une erreur si un fichier portant le même nom existe déjà).
--user-param	Chaîne utilisateur personnalisée	Une chaîne qui sera disponible dans l'application 4D à travers la commande Get database parameter (la chaîne ne doit pas démarrer par un caractère "-", qui est réservé)
--headless		Lance l'application 4D, 4D Server ou l'application fusionnée sans interface (mode headless). Dans ce mode : Le mode Développement n'est pas disponible, la base démarre en mode Application Aucune barre d'outils, barre de menu, fenêtre MDI ou fenêtre d'accueil (splash screen) n'est affichée Aucune icône n'est affichée dans le dock ou dans la barre des tâches La base de données ouverte n'est pas enregistrée dans le menu "Ouvrir bases récentes" Le fichier de diagnostic est lancé automatiquement (voir SET DATABASE PARAMETER, sélecteur 79) Chaque appel vers une boîte de dialogue est intercepté et une réponse automatique est fournie (ex : OK pour la commande ALERT, Arrêter pour un dialogue d'erreur, etc.). Toutes les commandes interceptées(*) sont enregistrées dans le fichier de diagnostic. Pour les besoins de maintenance, vous pouvez envoyer n'importe quel texte vers des flux de sortie standard à l'aide de la commande LOG EVENT. A noter que les applications 4D headless ne peuvent être fermées qu'en appelant la commande QUIT 4D ou à l'aide du gestionnaire des tâches du système d'exploitation.
--version		Affiche la version de l'application puis quitte
--help		Affiche l'aide puis quitte. Autres arguments : -?, -h

(*) Certains dialogues s'affichent avant l'ouverture de la base, afin qu'il soit impossible d'écrire dans le fichier de diagnostic (alerte de licence, dialogue de conversion, sélection de la base, sélection du fichier de données). Dans ce cas, un message d'erreur est lancé à la fois dans flux stderr et dans le journal d'événement système, puis l'application est quittée.

Exemples

Ces exemples supposent que votre application 4D est stockée sur le bureau et que la base de données à ouvrir est située dans le dossier "Documents".

Note : Le dossier courant de l'utilisateur est atteint à l'aide des commandes "~ " sous macOS et "%HOMEPATH%" sous Windows.

Lancer l’application
Exemple macOS :
open ~/Desktop/4D.app

Exemple Windows :
%HOMEPATH%\Desktop\4D\4D.exe

Lancer l’application avec un fichier de package sur macOS
open ~/Desktop/4D.app --args ~/Documents/myDB.4dbase
Lancer une application avec un fichier de projet
Exemple macOS :
open ~/Desktop/4D.app --args ~/Documents/myProj/Project/myProj.4DProject

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

Lancer l’application avec un fichier de structure et un fichier de données
Exemple macOS :
open ~/Desktop/4D.app --args --project ~/Documents/myProj/Project/myProj.4DProject --data ~/Documents/data/myData.4DD

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

Lancer l’application avec un fichier .4DLink
Exemple macOS :
open ~/Desktop/4D.app ~/Desktop/MyDatabase.4DLink

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

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

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

Lancer l’application en mode compilé et créer un fichier de données si indisponible
Exemple macOS :
open ~/Desktop/4D.app ~/Documents/myBase.4dbase --args --opening-mode compiled --create-data true

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

Lancer l’application avec un fichier de structure et un fichier de données et passer une chaîne en tant que paramètre utilisateur
Exemple macOS :
open ~/Desktop/4D.app --args --project ~/Documents/myProj/Project/myProj.4DProject --data ~/Documents/data/myData.4DD --user-param "Hello world"

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

Lancer l’application sans interface (mode headless)
Exemple macOS:
open ~/Desktop/4D.app --args --project ~/Documents/myProj/Project/myProj.4DProject --data ~/Documents/data/myData.4DD --headless

open ~/Desktop/MyBuiltRemoteApp −−headless

Exemple Windows:
%HOMEPATH%\Desktop\4D\4D.exe --project %HOMEPATH%\Documents\myProj\Project\myProj.4DProject --data %HOMEPATH%\Documents\data\myData.4DD --headless %HOMEPATH%\Desktop\4D\MyBuiltRemoteApp.exe --headless

Voir aussi

Headless 4D applications (blog post)