Consulter la fiche technique

Fiche technique AppliDis
Utilisation d’un lanceur
d’applications AppliDis
Fiche IS00128
Version document : 1.07
Diffusion limitée : Systancia, membres du programme Partenaires AppliDis et clients ou
prospects de Systancia ou des membres du programmes Partenaires AppliDis.
Objet du document
Cet utilitaire est recommandé lorsque l’on démarre l’application et que celle-ci se ferme
immédiatement sous AppliDis. Le lanceur permet deux types de lancements:
CreateProcess ou ShellExecute. Ces modes de lancements sont spécifiques aux
systèmes d’exploitation Microsoft.
Fichiers d’accompagnement
Cette fiche est fournie accompagnée de deux fichiers:
• WaitProcessEnded.exe, version 3.0.0.9
• WaitProcessEnded.ini
Fiche IS00128
Utilisation d’un lanceur d’applications AppliDis
Sommaire
1
Procédure ............................................................................................................ 3
1.1
Copie des fichiers sur le serveur d’Applications .................................................. 3
1.2
Paramétrage du fichier de configuration ............................................................ 3
1.3
Test du paramétrage ...................................................................................... 3
1.4
Référencement et publication dans AppliDis....................................................... 3
1.5
Test de l’application........................................................................................ 3
2
Paramétrages ....................................................................................................... 4
2.1
Syntaxe INI................................................................................................... 4
2.1.1
Section Init............................................................................................. 4
2.1.2
Utilisation de UniqueInstance .................................................................... 4
2.1.3
Section Launcher..................................................................................... 5
2.1.4
Section ExpandValue................................................................................ 5
2.1.5
Démarrage d’une application par « CreateProcess »..................................... 6
2.1.6
Démarrage d’une application par « ShellExecute »....................................... 6
2.1.7
Utilisation des variables d’environnement ................................................... 6
2.1.8
Ajouter ou modifier des variables d’environnement ...................................... 6
2.2
Exemple........................................................................................................ 7
Références ................................................................................................................. 9
IS00128-V1.07
Version de la fiche 1.07
09/11/2010
2/9
Fiche IS00128
Utilisation d’un lanceur d’applications AppliDis
1 Procédure
1.1 Copie des fichiers sur le serveur d’Applications
Copiez les deux fichiers WaitProcessEnded.exe et WaitProcessEnded.ini dans un
répertoire d’installation de votre choix et renommez ces fichiers avec un nom de votre
choix (les fichiers INI et EXE doivent porter le même nom).
1.2 Paramétrage du fichier de configuration
Paramétrez votre fichier de configuration comme spécifié plus loin, dans la section
paramétrages.
1.3 Test du paramétrage
Testez le fonctionnement de l’ensemble en démarrant le lanceur dans un interpréteur
de ligne de commande publié en TSE en vous connectant sous une autorité « utilisateur
standard ».
1.4 Référencement et publication dans AppliDis
Laissez fonctionner l’application plusieurs minutes
automatiquement ou bien référencez là manuellement.
pour
qu’elle
se
référence
1.5 Test de l’application
Faites tester l’application par vos utilisateurs.
IS00128-V1.07
Version de la fiche 1.07
09/11/2010
3/9
Fiche IS00128
Utilisation d’un lanceur d’applications AppliDis
2 Paramétrages
2.1 Syntaxe INI
2.1.1 Section Init
Dans la section (clé) Init, vous trouverez les valeurs suivantes:
Valeur
Exemple
Description
InitCommandLine
wscript C:\test.vbs Ligne de commande à démarrer avant lancement,
en tout début de script, paramètre optionnel.
InitCurrentDirectory c:\
Répertoire de démarrage du script d’initialisation,
paramètre optionnel.
ShowWindow
1
Mode de démarrage de la fenêtre de l’application:
SW_HIDE = 0
SW_SHOWNORMAL = 1
SW_NORMAL = 1
SW_SHOWMINIMIZED = 2
SW_SHOWMAXIMIZED = 3
SW_MAXIMIZE = 3
SW_SHOWNOACTIVATE = 4
SW_SHOW = 5
SW_MINIMIZE = 6
SW_SHOWMINNOACTIVE = 7
SW_SHOWNA = 8
SW_RESTORE = 9
SW_SHOWDEFAULT = 10
SW_FORCEMINIMIZE = 11
SW_MAX = 11
Sleep
10
Temporisation, en [ms]
ExitOnError
3
Code erreur retourné en cas d’échec
d’initialisation.
UniqueInstance
winword.exe
Si présente, chaque utilisateur ne peut exécuter
plus d’une instance du programme. La valeur
fournie doit correspondre au nom du processus
créé par le programme, qui ne doit pas être
présent pour autoriser le lancement. Cette valeur
insensible à la casse. (cf. SERVEUR pour la liste
des serveurs à vérifier)
2.1.2 Utilisation de UniqueInstance
Si UniqueInstance est défini, renseigner la section (clé) SERVEUR comme suivant :
Valeur
Exemple
Description
NbDeServeur
3
Nombre de serveurs à vérifier dans le cadre
d’une instanciation unique. Ce nombre définie
combien de sous-valeurs Server"X" sont
attendues.
IS00128-V1.07
Version de la fiche 1.07
09/11/2010
4/9
Fiche IS00128
Utilisation d’un lanceur d’applications AppliDis
Valeur
Server1
Exemple
NT_SERV01
Server2
NT_SERV02
…
…
Description
Nom d’un serveur sur lequel il faut vérifier si
une instance est déjà présente.
Nom d’un serveur sur lequel il faut vérifier si
une instance est déjà présente.
…
Les messages affichés en mode UniqueInstance sont personnalisables en renseignant la
section (clé) MessageUniqueInstance comme suit :
Valeur
TitreMessage
Exemple
Echec lancement
(%NomUtilisateur%,
%NomServeur%,
%NomInstance%)
ContenuMessage
%NomUtilisateur%
a déjà lancé
%NomInstance%
sur %NomServeur%
ErrTitreMessage
Lancement
impossible
Une erreur c'est
produite ; consulter
la sortie Debug
ErrContenuMessage
Description
Titre du message affiché en cas d’instance déjà
présente sur un serveur. Macros disponibles :
%NomUtilisateur% : nom de l'utilisateur
%NomServeur% : nom du serveur (ou une
autre instance est présente)
%NomInstance% : nom de l'instance
Corps du message affiché en cas d’instance
déjà présente sur un serveur. Macros
disponibles :
%NomUtilisateur% : nom de l'utilisateur
%NomServeur% : nom du serveur (ou une
autre instance est présente)
%NomInstance% : nom de l'instance
Titre du message affiché en cas d’échec lors de
la recherche d’instances.
Corps du message affiché en cas d’échec lors
de la recherche d’instances.
2.1.3 Section Launcher
Dans la section (clé) Launcher, vous trouverez les valeurs suivantes:
Valeur
Exemple
Description
Nom de l’application à démarrer (transmis à
ApplicationName C:\windows\notepad.exe
CREATE_PROCESS), paramètre optionnel.
Ligne de commande (transmise à
CREATE_PROCESS ou SHELL_EXECUTE),
CommandLine
notepad C:\cmd\test.txt
paramètre optionnel pour le mode
SHELL_EXECUTE.
Répertoire de travail (transmis à
CurrentDirectory C:\winnt
CREATE_PROCESS ou SHELL_EXECUTE),
paramètre optionnel.
Nom du fichier à ouvrir par le Shell (transmis à
ShellFileName
C:\cmd\start.bat
SHELL_EXECUTE).
2.1.4 Section ExpandValue
Dans la section (clé) ExpandValue, positionnez les valeurs ci-dessus à 1 pour convertir
les valeurs d’environnement, par ex:
[ExpandValues]
ApplicationName=1
IS00128-V1.07
Version de la fiche 1.07
09/11/2010
5/9
Fiche IS00128
Utilisation d’un lanceur d’applications AppliDis
2.1.5 Démarrage d’une application par « CreateProcess »
Lorsque la valeur ShellFileName n’est pas utilisée (en commentaire « ; »), le mode de
démarrage par défaut est « CreateProcess ». L’exemple ci-dessous démarre
l’application Notepad en ouvrant le document readme.txt.
[Launcher]
;ApplicationName=C:\windows\notepad.exe
CommandLine=notepad C:\mydoc\readme.txt
CurrentDirectory=c:\
2.1.6 Démarrage d’une application par « ShellExecute »
Lorsque la valeur ShellFileName est utilisée, le mode de démarrage par défaut est
« ShellExecute ». L’exemple ci-dessous ouvre le document readme.txt avec
l’application par défaut (sur le système).
[Launcher]
ShellFileName=C:\temp\readme.txt
L’exemple ci-dessous montre le démarrage d’un script.
[Launcher]
ShellFileName=C:\temp\commande.cmd
2.1.7 Utilisation des variables d’environnement
Dans la section ExpandValues, positionnez à 1 les variables pour lesquelles les variables
d’environnement seront traduites avant utilisation par CreateProcess ou ShellExecute.
Par exemple, le script ci-dessous exécutera le script:
C:\temp\r.murgante\commande.bat
[Launcher]
ShellFileName=C:\temp\%USERNAME%\commande.bat
[ExpandValues]
ShellFileName=1
2.1.8 Ajouter ou modifier des variables d’environnement
Il y a trois façons de mettre en place cet utilitaire :
• Ajouter ou modifier une variable d’environnement directement dans le processus
• Ajouter ou modifier une variable Windows pour l’utilisateur
• Ajouter ou modifier une variable Windows quelque soit l’utilisateur
Par exemple, le script ci-dessous modifie la variable %REFSTATION% pour l’utilisateur
en donnant comme valeur celle du poste client qui se connecte :
;=================================================
; Change ou force les variable d'environnement
;=================================================
;la variable est positionner que pour le processus
[VariablesEnvironnement]
;COMPUTERNAME = VAL_WTSCLIENTNAME
;la variable est positionner dans le registre pour le User
[VariablesEnvironnement\User]
REFSTATION = VAL_WTSCLIENTNAME
;la variable est positionner dans le registre pour le User
IS00128-V1.07
Version de la fiche 1.07
09/11/2010
6/9
Fiche IS00128
Utilisation d’un lanceur d’applications AppliDis
[VariablesEnvironnement\System]
;REFSTATION = VAL_WTSCLIENTNAME
2.2 Exemple
Le listing ci-dessous est fourni à titre d’exemple:
;=================================================
; Init Programme d’initialisation
;=================================================
[Init]
InitCommandLine=wscript C:\test.vbs
ExitOnError=3
;=================================================
; Launcher Paramètres de lancement de l’appli
;=================================================
[Launcher]
CommandLine=notepad
WaitFirstProcess=1
;=================================================
; valeurs à expander ( %TOTO% => C:\toto\ par ex)
;=================================================
[ExpandValues]
ApplicationName=0
CommandLine=0
CurrentDirectory=0
ShellFileName=0
InitApplicationName=0
InitCommandLine=0
InitCurrentDirectory=0
;=================================================
; Valeurs pour la variable ShowWindow
;=================================================
; SW_HIDE = 0
; SW_SHOWNORMAL = 1
; SW_NORMAL = 1
; SW_SHOWMINIMIZED = 2
; SW_SHOWMAXIMIZED = 3
; SW_MAXIMIZE = 3
; SW_SHOWNOACTIVATE = 4
; SW_SHOW = 5
; SW_MINIMIZE = 6
; SW_SHOWMINNOACTIVE = 7
; SW_SHOWNA = 8
; SW_RESTORE = 9
; SW_SHOWDEFAULT = 10
; SW_FORCEMINIMIZE = 11
; SW_MAX = 11
;=================================================
; Les Serveurs à contrôler
;=================================================
;[SERVEUR]
;NbDeServeur=3
;Server1=NT_SERV01
;Server2=NT_SERV02
;Server3=NT_SERV03
;=================================================
; Message unique instance
;=================================================
[MessageUniqueInstance]
; Message affiché lorsqu'une instance est déjà présente sur un serveur
; Macros disponibles
;
%NomUtilisateur% : nom de l'utilisateur
IS00128-V1.07
Version de la fiche 1.07
09/11/2010
7/9
Fiche IS00128
Utilisation d’un lanceur d’applications AppliDis
;
%NomServeur%
: nom du serveur (ou une autre instance est présente)
;
%NomInstance%
: nom de l'instance
;TitreMessage=Echec lancement (%NomUtilisateur%,%NomServeur%,%NomInstance%)
;ContenuMessage=%NomUtilisateur% a déjà lancé %NomInstance% sur %NomServeur%
; Message affiché lors d'un echec de recherche d'instance
;ErrTitreMessage=Lancement impossible
;ErrContenuMessage=Une erreur c'est produite ; consulter la sortie Debug
IS00128-V1.07
Version de la fiche 1.07
09/11/2010
8/9
Fiche IS00128
Utilisation d’un lanceur d’applications AppliDis
Références
Mots clés :
AppliDis
Référence :
WaitProcessEnded.exe version 3.0.0.9, WaitProcessEnded.ini
Date de création : 19/07/2004
Dernière révision : 09/11/2010
Pour tout commentaire sur cette fiche, merci d’envoyer un mail à [email protected] en précisant
le numéro de la fiche et votre commentaire
Copyright © Systancia 2008 – Tous droits réservés
Les informations fournies dans le présent document sont fournies à titre d’information, et de
ce fait ne font l’objet d’aucun engagement de la part de Systancia. Ces informations peuvent
être modifiées sans préavis de la part de Systancia.
Ce document est à destination d’utilisateurs avertis, disposant de notions de base du
système d’exploitation Windows Server de Microsoft. Systancia ne saurait être tenu pour
responsable des erreurs de manipulation dans le cadre de l’utilisation de cette
documentation. L’utilisation liée à ce document se fait sous votre entière responsabilité.
Marques de sociétés tierces : toutes les autres marques, noms de produits et de sociétés
précisés dans ce document sont cités à fins d’explications et sont la propriété de leurs
détenteurs respectifs. A ce titre, notamment Microsoft, Windows, Windows 2000, Windows
2003, Windows 2008 Server sont des marques de Microsoft Corporation aux Etats-Unis et
dans d’autres pays.
Systancia
Actipolis 3, Bât C11
3, rue Paul Henri Spaak
68 390 SAUSHEIM
France
Téléphone :
Fax :
site web :
03 89 33 58 20
03 89 33 58 21
http://www.systancia.fr
IS00128-V1.07
Version de la fiche 1.07
09/11/2010
9/9