Interface de ligne de commande
Vous pouvez utiliser le terminal macOS ou la console Windows pour piloter vos applications 4D (4D et 4D Server) à l'aide de lignes de commande. Cette fonctionnalité vous permet notamment :
- de lancer une base de données à distance, ce qui peut être particulièrement utile pour administrer des serveurs Web.
- d'exécuter des tests automatiques pour vos applications.
Informations de base
Vous pouvez exécuter des lignes de commande pour les applications 4D à l'aide du terminal macOS ou de la console Windows.
- Sous macOS, vous devez utiliser la commande
open. - Sous Windows, vous pouvez simplement passer les arguments directement.
Sous macOS, vous pouvez passer les arguments directement en allant dans le dossier contenant l'application, à l'intérieur du package (Contents/MacOS), ce qui permet d'adresser le flux stderr. Par exemple, si le package 4D se trouve dans le dossier
MyFolder, vous devez écrire la ligne de commande comme suit :/MyFolder/4D.app/Contents/MacOS/4D. Nous vous recommandons cependant d'utiliser la commandeopenchaque fois que vous n'avez pas besoin d'accéder au flux stderr.
Lancer une application 4D
Voici une description des lignes de commande et des arguments pris en charge pour le lancement d'applications 4D.
Syntaxe :
<applicationPath> [--version] [--help] [--project] [<projectPath | packagePath | 4dlinkPath> [--data <dataPath>]]
[--opening-mode interpreted | compiled] [--create-data] [--user-param <user string>] [--headless] [--dataless]
[--webadmin-settings-file] [--webadmin-access-key] [--webadmin-auto-start] [--webadmin-store-settings]
| Argument | Valeur | Description |
|---|---|---|
applicationPath | Chemin de 4D, 4D Server ou de l'application fusionnée | Lance l'application. Identique au double-clic sur l'application 4D. Lorsqu'elle est appelée sans argument de fichier de structure, l'application est exécutée et la boîte de dialogue «sélectionner la base de données» apparaît. |
--version | Affiche la version de l'application et quitte | |
--help | Affiche le message d'aide et quitte. Autres arguments : -?, -h | |
--project | projectPath | packagePath | 4dlinkPath | Fichier de projet à ouvrir avec le fichier de données courant. Aucune boîte de dialogue n'apparaît. |
--data | dataPath | Fichier de données à ouvrir avec le fichier de projet désigné. S'il n'est pas indoqué, 4D utilise le dernier fichier de données ouvert. |
--opening-mode | interpreted | compiled | Base de données de requêtes à ouvrir en mode interprété ou compilé. Aucune erreur n'est générée si le mode demandé n'est pas disponible. |
--create-data | Crée automatiquement un nouveau fichier de données si aucun fichier de données valide n'est trouvé. Aucune boîte de dialogue n'apparaît. 4D utilise le nom de fichier passé dans l'argument "--data" s'il en exise un (génère une erreur si un fichier du même nom existe déjà). | |
--user-param | Chaîne utilisateur personnalisée | Une chaîne qui sera disponible dans l'application 4D via la commande Get database parameter (la chaîne ne doit pas commencer par un caractère "-", qui est réservé). |
--headless | Lance 4D, 4D Server ou l'application fusionnée sans interface (mode headless). In this mode: Pour les besoins de maintenance, vous pouvez envoyer n'importe quel texte aux 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 QUIT 4D ou en utilisant le gestionnaire de tâches du système d'exploitation. | |
--dataless | Lance 4D, 4D Server ou une application fusionnée en mode headless. Le mode Dataless est utile lorsque 4D exécute des tâches sans données (compilation de projet par exemple). In this mode: .4DLink, ou lors de l'utilisation des commandesCREATE DATA FILE et OPEN DATA FILE.Note : .4DLink, le mode dataless ne s'applique qu'à la base de données spécifiée dans le fichier.4DLink. Pour plus d'informations sur les fichiers .4DLink, voir [Raccourcis d'ouverture de projet] (../Project/creation.md#project-opening-shortcuts). | |
--webadmin-settings-file | Chemin de fichier | Chemin du fichier WebAdmin .4DSettings personnalisé pour le serveur Web WebAdmin |
--webadmin-access-key | Chaine | Clé d'accès au serveur Web WebAdmin |
--webadmin-auto-start | Booléen | Statut du démarrage automatique du serveur Web WebAdmin |
--webadmin-store-settings | Stocke la clé d'accès et les paramètres de démarrage automatique dans le fichier de paramètres courant (c'est-à-dire le fichier WebAdmin.4DSettings par défaut ou un fichier personnalisé désigné par le paramètre --webadmin-settings-path). Utilisez l'argument --webadmin-store-settings pour sauvegarder ces paramètres si nécessaire |
fichier journal de diagnostic (alerte de licence, boîte de dialogue de conversion, sélection de base de données, sélection du fichier de données). Dans ce cas, un message d'erreur est envoyé à la fois dans le flux stderr et dans le journal d'événements système, puis l'application se ferme.
Exemples
Ces exemples supposent que votre application 4D est stockée sur le bureau et que la base de données à ouvrir se trouve dans le dossier "Documents".
Le dossier courant de l'utilisateur est atteint à l'aide de la commande "~" sous macOS et de la commande "%HOMEPATH%" sous Windows.
Ces exemples supposent que votre application 4D est stockée sur le bureau et que la base de données à ouvrir se trouve dans le dossier "Documents".
- Sous macOS :
open ~/Desktop/4D.app
- Sous Windows :
%HOMEPATH%\Desktop\4D\4D.exe
Lancer l'application :
yarn open ~/Desktop/4D.app --args ~/Documents/myDB.4dbase
Lancer l'application avec un fichier de package sur macOS :
- Sous macOS :
yarn open ~/Desktop/4D.app --args ~/Documents/myProj/Project/myProj.4DProject
- Sous Windows :
%HOMEPATH%\Desktop\4D\4D.exe %HOMEPATH%\Documents\myProj\Project\myProj.4DProject
Lancer l'application avec un fichier projet :
- Sous macOS :
open ~/Desktop/4D.app --args --project ~/Documents/myProj/Project/myProj.4DProject --data ~/Documents/data/myData.4DD
- Sous 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 projet et un fichier de données :
- Sous macOS :
open ~/Desktop/4D.app MyDatabase.4DLink
open "~/Desktop/4D Server.app" MyDatabase.4DLink
- Sous Windows :
%HOMEPATH%\Desktop\4D.exe MyDatabase.4DLink
%HOMEPATH%\Desktop\4D Server.exe" MyDatabase.4DLink
Lancer l'application avec un fichier .4DLink :
- Sous macOS :
open ~/Desktop/4D.app ~/Documents/myBase.4dbase --args --opening-mode compiled --create-data true
- Sous Windows :
%HOMEPATH%\Desktop\4D\4D.exe %HOMEPATH%\Documents\myBase.4dbase\myDB.4db --opening-mode compiled --create-data true
Lancez l'application en mode compilé et créer un fichier de données s'il n'est pas disponible :
- Sous macOS :
open ~/Desktop/4D.app --args --project ~/Documents/myProj/Project/myProj.4DProject --data ~/Documents/data/myData.4DD --user-param "Hello world"
- Sous 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 avec un fichier projet et un fichier de données et passer une chaîne comme paramètre utilisateur :
- Sous macOS :
open ~/Desktop/4D.app --args --project ~/Documents/myProj/Project/myProj.4DProject --data ~/Documents/data/myData.4DD --headless
open ~/Desktop/MyBuiltRemoteApp −−headless
- Sous 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