Annexe B : Command Line Interface (CLI) sous Mac OS

Vous pouvez utiliser une ligne de commande dans le Terminal de Mac OS X afin de piloter vos applications 4D (4D et 4D Server). Cette fonction permet de quitter ou d’ouvrir une base de données à distance, ce qui est particulièrement utile pour les administrateurs de serveurs Web.

Pour pouvoir exécuter la plupart des commandes relatives aux applications 4D à l’aide du Terminal de Mac OS X, vous devez au préalable accéder au dossier dans lequel se trouve l’application, à l’intérieur du progiciel (chemin Contents/MacOS).
Par exemple, si le progiciel 4D se trouve dans le dossier MonDossier, vous devez écrire la ligne de commande ainsi :

Note : Vous pouvez également insérer la ligne de commande via un glisser-déposer de l’icône de l’application dans votre Terminal. 

Il est préférable de passer le caractère & à la fin de la ligne de commande afin que l’application soit exécutée en tâche de fond dans un process séparé. Par exemple :

Voici la description des lignes de commandes et de leurs arguments pris en charge par les applications 4D :

• Lancer l’application
  Syntaxe : Chemin/NomApplication
  Exemple :
  
  4D.app/Contents/MacOS/4D &
  
  L’action de cette commande est identique à un double-clic sur l’application 4D. L’application s’exécute et la boîte de dialogue de sélection de base de données s’affiche.

• Lancer l’application avec un fichier de structure
  Syntaxe : Chemin/NomApplication CheminStructure
  Exemple :
  
  4D.app/Contents/MacOS/4D /Users/Roger/Bases/MaBase/MaBase.4DB
  
  Cette commande lance l’application et ouvre le fichier de structure désigné avec le fichier de données courant. Aucune boîte de dialogue n’apparaît.

• Lancer l’application avec un fichier de structure et un fichier de données
  Syntaxe : Chemin/NomApplication -d CheminDonnées CheminStructure
  Exemple :
  
  4D.app/Contents/MacOS/4D -d /Users/Roger /Bases/MaBase/MaBase.4DD /Users/Roger/Bases/MaBase/MaBase.4DB
  
  Cette commande lance l’application et ouvre le fichier de structure désigné avec le fichier de données désigné. Aucune boîte de dialogue n’apparaît.

• Quitter l’application
  Syntaxe : kill -s INT process_ID
  Exemple :
  
  Kill -s INT 323
  
  L’action de cette commande est identique à la sélection de la commande Quitter dans le menu Fichier. Les process sont refermés un à un, le cache est enregistré et l’application quitte.
  Note : Le numéro de process de l’application 4D (process_ID) peut être obtenu à l’aide de commandes telles que ps ou top.

• Aide
  Syntaxe : Chemin/NomApplication -h
  Exemple :
  
  4D.app/Contents/MacOS/4D -h
  
  Cette commande affiche un résumé des commandes utilisables avec 4D dans le Terminal de Mac OS X.

• Lancer l’application dans une session utilisateur différente de la session courante
  Syntaxe : Chemin/NomApplication -u NomUtilisateur -g NomGroupe
  Exemple :
  
  4D.app/Contents/MacOS/4D -u john -g compta
  
  Cette commande force le lancement de l’application au sein de la session utilisateur spécifiée (par défaut, la session utilisateur courante est utilisée).