4D v16.3

LAUNCH EXTERNAL PROCESS

Accueil

 
4D v16.3
LAUNCH EXTERNAL PROCESS

LAUNCH EXTERNAL PROCESS 


 

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

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é.

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")

(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


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

 
PROPRIÉTÉS 

Produit : 4D
Thème : Outils
Numéro : 811

Cette commande modifie la variable système OK

 
HISTORIQUE 

Créé : 4D 2004
Modifié : 4D v15 R4

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)