Objectifs de l’intégration

• Création et synchronisation des tickets depuis la supervision
• Création / liaison d’éléments de parc

Versions validées

Easyvista 2016.1.162.8

Proposition de valeur

Très simplement, le schéma ci-dessous décrit l’interaction de ces deux processus au travers du cycle de vie du changement des états d’un contrôle de supervision dans ServiceNav et du cycle de vie d’un incident dans EasyVista.

Ces deux cycles ne sont pas synchrones : fermer un ticket dans EasyVista ne provoquera pas le passage à l’état OK du contrôle. De la même manière, l’exploitant peut très bien effectuer une action sur le composant associé au contrôle, mais laisser le ticket en observation. La disparition de l’état d’alerte ne provoque pas automatiquement la fermeture du ticket.

La proposition de valeur métier de ce scénario fonctionnel est donc la suivante :

–      Qualité de service et Mesure de la charge d’exploitation liée à la supervision: favoriser la traçabilité des actions de production suite à l’acquittement d’un événement

–      Efficience renforcée : guider l’exploitant pour lui éviter de créer plusieurs fois le même ticket, et lui éviter un travail administratif intempestif.

Les sections suivantes détaillent l’intégration entre une EasyVista et ServiceNav pour mettre en œuvre ce scénario, dans un contexte de supervision d’une société comme dans celui de la supervision d’un parc d’équipements de plusieurs sociétés.

Scénarios d’usage

L’objectif de cette intégration consiste à réaliser les fonctions suivantes :

–      Sur acquittement d’un événement affiché dans ServiceNav, création d’un ticket dans EasyVista

–      Visualisation du ticket d’EasyVista avec informations sur son statut depuis le contrôle affiché dans ServiceNav

Les flux fonctionnels suivants sont implémentés au titre de l’intégration :

Détail des entités

Liste des sociétés EasyVista

Récupération de la liste des sociétés

Pour qu’un ticket puisse être ajouté sur l’équipement d’une société ou d’un site à travers ServiceNav, alors cette société/site doit être clairement identifiée sur l’intégration. Pour cela, chaque société/site possède un lien avec une société définie dans EasyVista.

Si ce lien est défini au niveau d’une société dans ServiceNav, les sites de cette société héritent de ce lien.

Autocomplete

Ajout d’un ticket

Pour un équipement ou un service dans un statut critique, via un clic sur la pastille de couleur ou la fiche de l’équipement/service il est possible d’ouvrir un ticket dans EasyVista

ServiceNav	EASYVISTA
Concaténation du champ Objet et Description	dans le champ description

Récupération des tickets

Configuration Easyvista

Eléments à fournir par le client

• URL webservices : https://<URL EASYVISTA>/WebService/SmoBridge.php?wsdl
  • Vérifier que les webservices sont présents et activés : https://<URL EASYVISTA>/WebService/SmoBridge.php
• Compte utilisateur possédant les droits Lecture/Modification sur les Tickets, langue FR : user/pass

Principe général

Webservices

L’intégration s’appuie sur 3 appels webservices standards :

• • EZV_CreateRequest : création d’un ticket
    • en retour le WebService renvoi le numéro de ticket crée en base
  • EZV_SYS_ExecuteInternalQuery : Récupération des tickets
  • EZV_SYS_ExecuteInternalQuery : Récupération des sites

Vues et filtres

L’intégrations s’appuie sur des vues et filtres, qu’il faut créer dans Easyvista et en récupérer ensuite les ID

• • EZV_SYS_ExecuteInternalQuery : Récupération des tickets
    • 1 filtre et 1 vue

• • EZV_SYS_ExecuteInternalQuery : Récupération des localisations
    • 1 filtre et 1 vue

Champs à créer

• Récupération des sites

Les localisations dans Easyvista concernent l’ensemble des localisations (autant les regroupements ‘type, Pays, Département, Ville’ que les niveaux de détail (étages, bureaux…).

Ainsi cette requête ne doit envoyer que les sites associés. Pour cela un nouveau booléen de type E_SITE doit être positionné sur la table des localisations (AM_LOCATION) afin de les filtrer.

ServiceNav  -Métadonnées de l’intégration

Un certain nombre de méta-données sont nécessaires pour permettre d’avoir une intégration correcte :

• Url de connexion (webservice)
• port
• Login
• Password
• Paramètres spécifiques

Account : id de l’account (base de prod/base de test, voir : https://wiki.easyvista.com/xwiki/bin/view/Documentation/Customize+differents+accounts?language=fr )

pour chacune des opérations :

requestguid : Identifiant (GUID) de la requête parent.

filterguid : Identifiant (GUID) du filtre. Si non renseigné, le filtre Par défaut est utilisé. Pour trouver le GUID d’un filtre : recopier dans un éditeur de texte l’adresse URL du filtre et récupérer la valeur du paramètre q2_f

viewguid : Identifiant (GUID) de la vue . Si non renseigné, la vue Par défaut est utilisée. Pour trouver le GUID d’une vue : recopier dans un éditeur de texte l’adresse URL de la vue et récupérer la valeur du paramètre q2_r

Documentation éditeur : https://wiki.easyvista.com/xwiki/bin/view/Documentation/EZV_SYS_ExecuteInternalQuery

« createticket » contient les valeurs par défaut à passer au ticket lors de création.

Exemple :

{     « account » : « 50016 »,

« companylist » : {         « requesterguid » : « {0C7F989D-3AB1-4372-BC25-CBF2A2C1BD00} »,

« filterguid » : « {6F1605EA-CE26-4E06-87DF-66F2B4D235E7} »,

« viewguid » : « {2A74F5A3-3B3D-4B7B-B8E4-5030A106FC01} »     },

« ticketlist » : {               « requesterguid » : « {6938436D-B024-4B9E-9815-A41C1D7C7A0E} »,

« filterguid » : « {0949BF14-5759-467E-B5CC-6940A305AA91} »,

« viewguid » : « {0D593DAF-69A1-4DD9-A328-3883EF495CAE} »     },

« createticket » : {          « catalog_code » : « WingooWM »,

« urgency_id » : « 1 »,

« origin » : « 9 »     } }