LAUNCH EXTERNAL PROCESS

4D v16.3


LAUNCH EXTERNAL PROCESS ( nomFichier {; fluxEntrée {; fluxSortie {; fluxErreur}}}{; pid} )

Paramètre	Type	Description
nomFichier	Chaîne	Chemin d’accès et arguments du fichier à lancer
fluxEntrée	Chaîne, BLOB	Flux d’entrée (stdin)
fluxSortie	Chaîne, BLOB	Flux de sortie (stdout)
fluxErreur	Chaîne, BLOB	Flux d’erreur (stderr)
pid	Entier long	Identifiant unique du process externe

Description

La commande LAUNCH EXTERNAL PROCESS permet de lancer un process externe depuis 4D, sous Mac OS X et Windows.
Sous Mac OS X, cette commande donne accès à toutes les applications exécutables pouvant être lancées depuis le Terminal.

Passez dans le paramètre nomFichier le chemin d’accès absolu de l’application à exécuter ainsi que les arguments nécessaires, le cas échéant.
Sous Mac OS X, vous pouvez également passer uniquement le nom de l’application à exécuter, 4D utilisera alors la variable d’environnement PATH pour localiser l’exécutable.

Attention : Cette commande permet uniquement de lancer des applications exécutables, elle ne peut pas exécuter d'instructions dépendantes du shell (l'interpréteur de commandes). Par exemple, sous Mac OS il n'est pas possible d'utiliser cette commande pour exécuter l'instruction echo ou des indirections.

Le paramètre fluxEntrée (facultatif) contient le stdin du process externe. Après l’exécution de la commande, les paramètres fluxSortie et fluxErreur (s’ils sont passés) retournent respectivement le stdout et le stderr du process externe. Vous pouvez utiliser des paramètres de type BLOBs au lieu de chaînes de caractères si vous traitez des données binaires (telles que des images).

Note : Si vous utilisez la variable d'environnement _4D_OPTION_BLOCKING_EXTERNAL_PROCESS via la commande SET ENVIRONMENT VARIABLE (exécution asynchrone), les paramètres fluxSortie et fluxErreur ne sont pas retournés.

Lorsqu'il est passé, le paramètre pid (entier long) retourne l'identifiant unique du process (PID) affecté au niveau de l'OS, quel que soit le statut de l'option _4D_OPTION_BLOCKING_EXTERNAL_PROCESS. Avec cette information, il est plus facile d'interagir avec les process externes créés par la commande, par exemple pour les stopper. Si le lancement du process externe échoue, le paramètre pid n'est pas retourné.

Exemples sous Mac OS X

Tous les exemples suivants utilisent le Terminal de Mac OS X, accessible dans le dossier Applications/Utilitaires.

(1) Pour modifier les accès à un fichier (chmod est la commande Mac OS X permettant de modifier les accès des fichiers) :

LAUNCH EXTERNAL PROCESS("chmod +x /dossier/monfichier.txt")

(2) Pour éditer un fichier texte (cat est la commande Mac OS X permettant d’éditer les fichiers). Dans cet exemple, le chemin d’accès absolu de la commande est passé :

 C_TEXT(vtentrée;vtsortie)

 vtentrée:=""

 LAUNCH EXTERNAL PROCESS("/bin/cat /dossier/monfichier.txt";vtentrée;vtsortie)

(3) Pour récupérer la liste du contenu du dossier “Users” (ls -l est semblable à la commande dir du DOS) :

 C_TEXT($In;$Out)

 LAUNCH EXTERNAL PROCESS("/bin/ls -l /Users";$In;$Out)

(4) Pour lancer une application "graphique" indépendante, il est préférable d'utiliser la commande système open (dans ce cas l'instruction LAUNCH EXTERNAL PROCESS a le même effet qu'un double-clic sur l'application) :

LAUNCH EXTERNAL PROCESS("open /Applications/Calculator.app")

Exemples sous Windows

(5) Pour lancer l’application NotePad :

LAUNCH EXTERNAL PROCESS("C:\\WINDOWS\\notepad.exe")

(6) Pour lancer l’application NotePad et ouvrir un document spécifique :

LAUNCH EXTERNAL PROCESS("C:\\WINDOWS\\notepad.exe C:\\Docs\\nouveau dossier\\res.txt")

(7) Pour lancer l’application Microsoft® Word® et ouvrir un document spécifique (à noter l’emploi de deux "") :

 $mondoc:="C:\\Program Files\\Microsoft Office\\Office10\\WINWORD.EXE \"C:\\Documents and

 Settings\\JeanMarc\\Bureau\\MesDocs\\Nouveau dossier\\essai.xml\""

 LAUNCH EXTERNAL PROCESS($mondoc;$tIn;$tOut)

(8) Pour exécuter un script Perl (requiert l’installation préalable d’ActivePerl) :

 C_TEXT($entrée;$sortie)

 SET ENVIRONMENT VARIABLE("mavariable";"valeur")

 LAUNCH EXTERNAL PROCESS("D:\\Perl\\bin\\perl.exe D:\\Perl\\eg\\cgi\\env.pl";$entrée;$sortie)

(9) Pour lancer une commande avec un répertoire courant défini et sans afficher la console :

 SET ENVIRONMENT VARIABLE("_4D_OPTION_CURRENT_DIRECTORY";"C:\\4D_VCS")

 SET ENVIRONMENT VARIABLE("_4D_OPTION_HIDE_CONSOLE";"true")

 LAUNCH EXTERNAL PROCESS("C:\\MesApplis\\macommande.exe")

(10) Pour permettre à l'utilisateur d'ouvrir un document externe sous Windows :

 $nomdoc:=Select document("";"*.*";"Choisissez le fichier à ouvrir";0)

 If(OK=1)

    SET ENVIRONMENT VARIABLE("_4D_OPTION_HIDE_CONSOLE";"true")

    LAUNCH EXTERNAL PROCESS("cmd.exe /C start \"\" \""+$nomdoc+"\"")

 End if

(11) Les exemples suivants récupèrent la liste des process sous Windows :

 C_LONGINT($pid)

 C_TEXT($stdin;$stdout;$stderr)

 

 LAUNCH EXTERNAL PROCESS("tasklist";$pid) //obtenir uniquement le PID

 LAUNCH EXTERNAL PROCESS("tasklist";$stdin;$stdout;$stderr;$pid) //obtenir toutes les informations

Variables et ensembles système

Si la commande a été exécutée correctement, la variable système OK prend la valeur 1. Sinon (fichier non trouvé, mémoire insuffisante, etc.), elle prend la valeur 0.

Voir aussi

SET ENVIRONMENT VARIABLE