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.
    • Le répertoire est défini via le paramètre divers {ADMIN} Répertoire des scripts.
    • Il doit être exprimé en UNC.
  • L'exécution des scripts se fait en dehors de Service Manager. 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é.

Accès menu

Administration > Paramétrages > Scripts

Description de l'écran

    Scripts launch wizard.png

Description : Libellé du script.

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

  • Option Script : Lance l'exécution d'un fichier .bat ou .vbs.
  • Option 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).
  • Option 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.

Exemples de scripts

  • Option Script : Exécuter le script ping.bat, en passant le paramètre @@AM_ASSET.NETWORK_IDENTIFIER@@
             Open url.png  voir Outils d'administration
ping.bat @@AM_ASSET.NETWORK_IDENTIFIER@@
  • Option URL : Accéder à la machine distante via VNC, en passant le paramètre @@AM_ASSET.NETWORK_IDENTIFIER@@
http:>>@@AM_ASSET.NETWORK_IDENTIFIER@@:5800
  • Option Procédure stockée : Exécuter 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@@
Execute 40000.My_procedure @@AM_ASSET.ASSET_TAG@@, @@AM_ASSET.SERIAL_NUMBER@@

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

  • @@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).

      exemple  @@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 et Assistants

Comment mettre en place les scripts

Étape 1 : Renseignement du répertoire des scripts

1. Allez sur l'écran Administration > Paramétrages > Paramètres divers.

2. Éditez le paramètre {ADMIN} Répertoire des scripts.

3. Renseignez le répertoire local ou l'emplacement réseau exprimé en UNC.

exemple  172.16.4.1\scripts

 

Étape 2 : Paramétrage des scripts

1. Allez sur l'écran Administration > Paramétrages > Scripts.

2. Cliquez sur Add icon.png.

3. Renseignez les informations du script.

4. Cliquez sur Terminer.
 

Étape 3 : Ajout d'un bouton de commande sur la fiche

1. Allez sur la fiche souhaitée.

2. Cliquez sur Browse grey points icon.png dans le bandeau supérieur, puis sur Éditer la fiche.

L'éditeur de fiches est ouvert. La représentation principale de la fiche est affichée.

3. Ajoutez un bouton de commande.

4. Associez l'assistant Exécuter un script et sélectionnez le script souhaité.

5. Cliquez sur Enregistrer.
 

Étape 4 : Test de la bonne configuration de l'assistant

1. Cliquez sur Enregistrer et Fermer.

Vous revenez sur la fiche.

2. Contrôlez le bon fonctionnement du bouton pour exécuter le script.

Les assistants

Paramétrer

Tags :

Raccourcis

Portail client

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

Powered by XWiki © EasyVista 2022