Consulter la fiche technique
Transcription
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