Assistant "Lancement de scripts"


Definition

L'assistant Lancement de scripts permet d'exécuter des scripts (via des fichiers .vbs et .bat), d'ouvrir une URL dans une nouvelle page, d’exécuter une procédure stockée. Il peut être appelé depuis certaines fiches (Quick Call, Incidents, Actions, Employés, Matériels, Demandes de service, Demandes d'investissements) en passant des paramètres via des variables contextuelles.

EndDefinition

Remarques

  • Les scripts doivent être déposés sur un répertoire réseau partagé pour permettre à l'ensemble des techniciens du Service Desk d'y accéder. Ce répertoire est défini via les paramètres divers ({ADMIN} Répertoire des scripts) et doit être exprimé en UNC (ex. : 172.16.4.1\scripts).
  • L'exécution des scripts se fait en dehors de Product name - ev itsm.png, aucun fichier de log n'est généré.

Attention

  • L'exécution de fichiers .vbs et .bat ne peut se faire qu'avec le navigateur Internet Explorer Version 8 et inférieures. Des blocages de sécurité sur les navigateurs Firefox, Chrome et Internet Explorer Version 9 et supérieures empêchent en effet l'exécution de scripts.
  • Le développement des procédures stockées est du ressort de chaque client.
  • L'accès à distance via VNC nécessite une machine java virtuelle sur le poste à partir duquel le script est lancé.

Description de l'écran

   Scripts launch wizard.png

Accès menu : Administration > Paramétrages > Scripts

Description : Libellé du script.

Type : Indique le type de traitement effectué par le script.

  • Type = Script : Lance l'exécution d'un fichier .bat ou .vbs.
  • Type = URL : Ouvre l'adresse URL dans une fenêtre. Les champs ci-dessous sont alors affichés :
    • Window Width : Largeur de la fenêtre.
    • Window Height : Hauteur de la fenêtre.
    • Use POST Request Method : Indique si les informations sont transmises par la méthode POST (case cochée) ou par la méthode GET (case non cochée).
  • Type = Procédure stockée : Lance l'exécution d'un ensemble d'instructions SQL précompilées, stockées dans une base de données.

Contenu : Ligne de commande du script.
         Example documentation icon FR.png

  • Type = Script :   ping.bat @@AM_ASSET.NETWORK_IDENTIFIER@@
              ==>  exécution du script ping.bat, en passant le paramètre @@AM_ASSET.NETWORK_IDENTIFIER@@
             Open url.png  voir description des Outils d'administration
  • Type = URL :   http:>>@@AM_ASSET.NETWORK_IDENTIFIER@@:5800
              ==>  accès à la machine distante via VNC, en passant le paramètre @@AM_ASSET.NETWORK_IDENTIFIER@@
  • Type = Procédure stockée :   Execute 40000.My_procedure @@AM_ASSET.ASSET_TAG@@, @@AM_ASSET.SERIAL_NUMBER@@
              ==>  exécution de la procédure stockée My_procedure sur le compte utilisateur 40000, en passant les paramètres @@AM_ASSET.ASSET_TAG@@ et @@AM_ASSET.SERIAL_NUMBER@@

Liste des variables pouvant être passées en paramètre

  • @@TABLE.FIELDNAME@@ : Nom de la table suivi du nom du champ. La table peut être :
    • AM_ASSET : table des matériels ;
    • SD_REQUEST : table des demandes de service. Note : Uniquement lorsque le script est lancé depuis un incident, une demande, une action ou la prise d’appel (Quick Call).
      Example documentation icon FR.png  @@AM_ASSET.NETWORK_IDENTIFIER@@ : Identifiant réseau du matériel
  • @@CONNECTED@@ : Nom de l'utilisateur connecté.
  • @@CONNECTED.LOGIN@@ : Login de l'utilisateur connecté.
  • @@RECIPIENT@@ : Nom du bénéficiaire de l'incident/demande/action.
  • @@RECIPIENT.LOGIN@@ : Login du bénéficiaire de l'incident/demande/action.
  • @@REQUESTOR@@ : Nom du demandeur de l'incident/demande/action.
  • @@REQUESTOR.LOGIN@@ : Login du demandeur de l'incident/demande/action.
  • @@UID@@ : Identifiant unique des collections et publications SMS, généré lors de l'appel du script/URL.
  • @@COUNTER@@ : Compteur incrémenté à chaque appel du script/URL. Note : Commence à la valeur 1.

Procédure : Comment mettre en place les scripts

1. Définissez l'emplacement du répertoire des scripts :

  • allez sur l'écran Administration > Paramétrages > Paramètres divers ;
  • éditez le paramètre divers {ADMIN} Répertoire des scripts et renseignez le répertoire local ou l'emplacement réseau exprimé en UNC (ex. : 172.16.4.1\scripts).

2. Définissez et paramétrez les scripts :

  • allez sur l'écran Administration > Paramétrages > Scripts
  • cliquez sur Add icon.png ;
  • saisissez les éléments du script ;
  • cliquez sur [ TERMINER ].

3. Ajoutez un bouton de commande sur la fiche sur laquelle vous souhaitez implémenter l'assistant Lancement de scripts :

  • cliquez sur Tools icon.png > Edit icon Éditer pour passer en mode Édition de la fiche 
  • ajoutez un bouton de commande et configurez-le : associez l'assistant Exécuter un script et sélectionnez le script souhaité.
Tags:
Modifié par Utilisateur inconnu le 2019/04/26 13:33
Créé par Administrator XWiki le 2015/06/01 10:41

Raccourcis

L'actualité mensuelle
•  Newsletter

Tous les changements
•  Service Manager
•  Service Apps
•  Self Help

Glossaire

Powered by XWiki ©, EasyVista 2020