Intégration EV Reach (via Talend)

Modifié le 11/08/2022 19:35

Attention : Effectuez toujours une sauvegarde de la base Service Manager avant l'exécution de cette intégration. Les impacts que la mise à jour / suppression de données peut avoir au sein de votre plateforme ne sont pas pris en charge par le Support EasyVista.

Note : La mise en oeuvre de cette intégration nécessite que l'agent EV Reach soit déployé et installé sur les postes de travail afin de remonter des données d'inventaire. Pour de plus amples informations, veuillez contacter votre interlocuteur EasyVista.

Synthèse de l'intégration

EV Reach (anciennement Goverlan) est un logiciel EasyVista permettant la prise de contrôle à distance, l'automatisation des processus informatiques, l'inventaire, ...

Cette intégration vous permet d'importer dans Service Manager des données techniques Matériels, Logiciels et Caractéristiques remontées par inventaire dans la base EV Reach, en exécutant des jobs Talend et des modèles d'intégration dédiés.
Le catalogue des matériels et le catalogue des logiciels sont mis à jour dans Service Manager après des traitements de transcodage. La table de référence Caractéristiques est mise à jour dans Service Manager après un traitement de restructuration des données.

  • L'intégration est disponible en téléchargeant un package de fichiers.
  • Les jobs Talend sont exécutables de façon autonome.
  • Les jobs Talend et les modèles d'intégration EV Reach dédiés peuvent être planifiés pour s'exécuter régulièrement, via un planificateur Windows ou Linux.
  • Une fois l'intégration planifiée, le suivi régulier des données extraites par EV Reach est nécessaire pour les intégrer dans les bases Service Manager.
     

Notes

  • L'intégration repose sur les principes fondamentaux du préimport : stockage, traitement des données externes dans des tables Service Manager, transcodage pour homogénéiser les données avec celles du référentiel existant.
  • Talend est l'outil tiers qui est utilisé pour construire cette mécanique de préimport via des jobs.
     
Flux d’intégration des données (sens) Type d'authentification Options du connecteur d'intégration

Favicon EasyVista - 32.png EV Reach

Down arrow.png

Logo - Talend.png

Down arrow.png

Favicon EasyVista - 32.png Service Manager

N/A
Versions disponibles
SaaS On Premise
Service Manager Check icon.png Check icon.png
Produit tiers Check icon.png Check icon.png

Quelques définitions sur Talend

Talend est un ETL (Extract Transform and Load) qui permet d'extraire des informations d'une source de données, de modifier ces données puis de les recharger vers une destination. La source et la destination des données peuvent être une base de données, un service web, un fichier csv, ...
   Open url.png voir Documentation de Talend

  • Un job contient un ensemble de composants reliés entre eux permettant à Talend d'exécuter un processus de flux de données.
  • La fonction Build Job de Talend permet de créer des archives comprenant tous les fichiers nécessaires à l'exécution des jobs, y compris les fichiers .bat, .ps1 et .sh, ainsi que tous les fichiers de paramètres de contextes. 
  • Les jobs compilés peuvent être exécutés de façon autonome à partir de n'importe quel serveur, en dehors de la console Talend Open Studio. Leur exécution peut également être planifiée depuis un fichier batch, powershell ou un shell linux, via le planificateur de tâches Windows ou via un cron Linux.

Remarques

  • L'agent EV Reach doit être installé sur tous les postes de travail à inventorier.
  • Java Runtime Environment (JRE) doit être installé sur le poste de travail depuis lequel est lancée l'intégration EV Reach.
  • Les paramétrages dans les bases de production Service Manager nécessaires pour réaliser cette intégration sont configurés en standard à partir de la version 2022.
    • Vous êtes client On-Premise et votre version Service Manager est antérieure à 2022 : vous devez effectuer les paramétrages signalés dans la procédure.
    • Vous êtes client SaaS et votre version Service Manager est antérieure à 2022 : vous devez effectuer une demande auprès de l'équipe CMC EasyVista.
  • Les jobs Talend fournis avec l'intégration sont exécutables de façon autonome.
    • Aucune licence Talend n'est nécessaire.
    • La console Talend Open Studio n'est pas nécessaire.
  • Un exemple de planification des modèles d'intégration EV Reach dédiés est indiqué dans la procédure, en utilisant l'outil smoIntegration.
    • Cet outil est accessible uniquement aux clients OnPremise.
    • Si vous êtes client SaaS, vous pouvez planifier les modèles d'intégration via les tâches planifiées (i.e., via l'ordonnanceur smoScheduler de Service Manager) ou utiliser un ordonnanceur externe (tel le planificateur de tâches de Windows) ou une application tierce.
         Open url.png voir Comment automatiser une intégration
  • Chaque client doit renseigner les variables propres à son environnement via un fichier de propriétés recensant le chemin d'accès aux fichiers Excel nécessaires pour l'intégration, et les paramètres d'accès aux serveurs SQL EV Reach et Service Manager.
  • Règles de rapprochement entre les données EV Reach et les données Service Manager :
    • Pour les matériels : La correspondance s'effectue via la clé d'unicité Catégorie / Marque / Modèle.
    • Pour les logiciels : La correspondance s'effectue via la clé d'unicité Logiciel / Éditeur.
    • Pour les caractéristiques : La correspondance s'effectue via la clé d'unicité Caractéristique.
  • Intégration des données dans les bases Service Manager :
    • Pour des raisons de sécurité, un utilisateur GOVERLAN_READER dédié doit être créé dans les bases de production Service Manager. Cet utilisateur dispose uniquement des droits d'accès qui sont nécessaires pour réaliser l'intégration EV Reach : droits d'accès limités à certaines tables Service Manager et pour réaliser certains types d'opérations.
    • Une liste d'exclusion permet à chaque client de suivre les références logiciels qu'il souhaite en fonction de la politique adoptée par son organisation.
    • Pour garantir les performances de la plateforme et limiter les traitements de transcodage, seules les données nouvelles / modifiées par rapport à la dernière exécution du processus sont extraites. Les références qui n'existent pas dans Service Manager sont automatiquement créées.

Attention

  • Ne modifiez aucun des fichiers contenus dans le package, sous peine de ne plus pouvoir exécuter l'intégration. Les impacts que la modification des fichiers peut avoir au sein de votre plateforme ne sont pas pris en charge par le Support EasyVista.
  • Dans les fichiers de configuration DefaultProperties.txt, n'insérez pas d'espace ou de tabulation dans les valeurs. Ne saisissez pas de guillemets.
  • Effectuez toujours une sauvegarde de la base Service Manager avant l'exécution de cette intégration. Les impacts que la mise à jour / suppression de données peut avoir au sein de votre plateforme ne sont pas pris en charge par le Support EasyVista.
  • Pour les clients SaaS, un tunnel VPN est indispensable pour réaliser la connexion entre les bases de données EV Reach et Service Manager.

Bonnes pratiques

  • Planifiez un inventaire régulier sur les postes de travail via l'agent EV Reach pour remonter régulièrement les données techniques des matériels, logiciels et caractéristiques dans la base EV Reach.
  • Planifiez et définissez la fréquence d'exécution des jobs Talend et des modèles d'intégration en fonction de la fréquence de votre suivi des données extraites par EV Reach.
  • Effectuez toujours une sauvegarde des fichiers Excel de transcodage avant de les modifier. Vous pourrez ainsi revenir en arrière si besoin.

Principe de fonctionnement

Représentation Étapes
Goverlan integration - Operating principle.png

Dans EV Reach

  • (1) Connexion à la base EV Reach via Talend. Extraction des données Matériels, Logiciels et Caractéristiques, via 3 vues SQL EV Reach dédiées.

Dans Service Manager, via Talend

  • Données Matériels et Logiciels
    • (2) Stockage des données dans des tables Service Manager E_GOVERLAN_..._VIEW.
    • (3) Transcodage des données pour les normaliser avec les catalogues Service Manager, via des tables E_GOVERLAN_..._TRANSCO.
    • (4) Stockage des données transcodées dans des tables E_GOVERLAN_..._TO_EZV.
  • Données Caractéristiques
    • (4) Changement de la structure des données pour les normaliser avec la table de référence Service Manager, et stockage des données restructurées dans une table E_GOVERLAN_..._TO_EZV.

Dans Service Manager, via des modèles d'intégration

  • (5) Exécution de 6 modèles d'intégration dédiés pour intégrer les données finales des tables E_GOVERLAN_..._TO_EZV dans les bases de production Service Manager (tables AM_ASSET, AM_SOFTWARE, AM_CHARACTERISTICS).

Processus d'intégration

L'intégration entre EV Reach et Service Manager s'effectue en 7 grandes étapes.

Étape 1 : Note : Uniquement si votre version Service Manager est antérieure à la version 2022 Création des tables Service Manager dédiées à l'intégration EV Reach

Étape 2 : Note : Uniquement si votre version Service Manager est antérieure à la version 2022 Ajout de l'utilisateur GOVERLAN_READER dans les bases de production Service Manager

Étape 3 : Configuration des jobs Talend suivant l'environnement client

Étape 4 : Première exécution de l'intégration entre EV Reach et Service Manager

Étape 5 : Configuration des modèles d'intégration EV Reach

Étape 6 : Planification de l'exécution des jobs Talend et de l'exécution des modèles d'intégration EV Reach

Étape 7 : Suivi régulier des données Matériels et Logiciels extraites par EV Reach

Processus d'intégration pas à pas

Prérequis

1. Installez l'agent EV Reach sur les postes de travail à inventorier.

2. Importez le package EV Reach sur votre ordinateur et dézippez-le.

          Download icon.png  Package EV Reach

          Package content.png

Création des tables Service Manager dédiées à l'intégration EV Reach

Note :
  • Effectuez cette étape uniquement si votre version de Service Manager est antérieure à la version 2022.
  • Si vous êtes client SaaS, vous devez effectuer une demande auprès de l'équipe CMC EasyVista.

Étape 1 : Création des tables Service Manager pour les données Matériels

1. Allez sur le serveur SQL Service Manager.

2. Exécutez les 3 scripts SQL situés dans le répertoire 1.create tables in evo_backoffice (sql) du package EV Reach que vous avez dezippé, pour créer les tables Service Manager dédiées aux matériels dans la base EVO_BACKOFFICE.

Script SQL Table créée dans Service Manager Données stockées Structure de la table
goverlan_asset_view.sql E_GOVERLAN_ASSET_VIEW Stockage des données extraites de la base EV Reach, via la vue EV Reach dédiée vSystemView E_GOVERLAN_ASSET_VIEW table structure.png
goverlan_asset_transco.sql E_GOVERLAN_ASSET_TRANSCO Stockage des données transcodées pour mettre à jour le catalogue des matériels (Catégorie, Marque, Modèle) E_GOVERLAN_ASSET_TRANSCO table structure.png
goverlan_asset_to_ezv.sql E_GOVERLAN_ASSET_TO_EZV Stockage des données finales, prêtes à être intégrées dans la base de production Service Manager E_GOVERLAN_ASSET_TO_EZV table structure.png

Étape 2 : Création des tables Service Manager pour les données Logiciels

1. Allez sur le serveur SQL Service Manager.

2. Exécutez les 3 scripts SQL situés dans le répertoire 1.create tables in evo_backoffice (sql) du package EV Reach que vous avez dezippé, pour créer les tables Service Manager dédiées aux logiciels dans la base EVO_BACKOFFICE.

Script SQL Table créée dans Service Manager Données stockées Structure de la table
goverlan_software_view.sql E_GOVERLAN_SOFTWARE_VIEW Stockage des données extraites de la base EV Reach, via la vue EV Reach dédiée vSoftwareInventory E_GOVERLAN_SOFTWARE_VIEW table structure.png
goverlan_software_transco.sql E_GOVERLAN_SOFTWARE_TRANSCO Stockage des données transcodées pour mettre à jour le catalogue des logiciels (Nom du logiciel, Éditeur) E_GOVERLAN_SOFTWARE_TRANSCO table structure.png
goverlan_software_to_ezv.sql E_GOVERLAN_SOFTWARE_TO_EZV Stockage des données finales, prêtes à être intégrées dans la base de production Service Manager E_GOVERLAN_SOFTWARE_TO_EZV table structure.png

Étape 3 : Création des tables Service Manager pour les données Caractéristiques

1. Allez sur le serveur SQL Service Manager.

2. Exécutez le script SQL situé dans le répertoire 1.create tables in evo_backoffice (sql) du package EV Reach que vous avez dezippé, pour créer la table Service Manager dédiée aux caractéristiques dans la base EVO_BACKOFFICE.

Script SQL Table créée dans Service Manager Données stockées Structure de la table
goverlan_attributes_to_ezv.sql E_GOVERLAN_ATTRIBUTES_TO_EZV
  • Stockage des données extraites de la base EV Reach, via la vue EV Reach dédiée vSystemAttributes
  • Stockage des données restructurées, prêtes à être intégrées dans la base de production Service Manager
E_GOVERLAN_ATTRIBUTES_TO_EZV table structure.png

Ajout de l'utilisateur GOVERLAN_READER dans les bases de production Service Manager

Note :
  • Effectuez cette étape uniquement si votre version de Service Manager est antérieure à la version 2022.
  • Si vous êtes client SaaS, vous devez effectuer une demande auprès de l'équipe CMC EasyVista.

1. Allez sur le serveur SQL Service Manager.

2. Ouvrez le dossier Sécurité > Utilisateurs.

3. Exécutez la requête create user 'goverlan_reader' (50004).sql située dans le répertoire 2.create user goverlan_reader (sql) du package EV Reach que vous avez dezippé.

L'utilisateur est ajouté sur le compte Service Manager 50004 de la base EVO_DATA.

4. Exécutez la requête create user 'goverlan_reader' (50005).sql située dans le répertoire 2.create user goverlan_reader (sql) du package EV Reach que vous avez dezippé.

L'utilisateur est ajouté sur le compte Service Manager 50005 de la base EVO_DATA.

Configuration des jobs Talend suivant l'environnement client

Prérequis : Installation de Java Runtime Environment (JRE)

1. Téléchargez la dernière version du fichier d'installation de Java Runtime Environment (version 64 bits) sur votre ordinateur depuis le site Java.

          Download icon.png  Java Runtime Environment (JRE) - Sélectionnez la version Windows Offline (64-bit)

2. Lancez le fichier exécutable et effectuez l'installation de Java Runtime Environment (JRE) sur votre poste de travail.
 

Étape 1 : Configuration du job Talend GOVERLAN_GET_DATA_CATALOG

1. Allez dans le répertoire 3.standalone jobs (engine)\goverlan_get_data_catalog_1.0\GOVERLAN_GET_DATA_CATALOG\local_project\goverlan_get_data_catalog_1_0\contexts du package EV Reach que vous avez dezippé.

2. Ouvrez le fichier Default.properties.
        File Default properties.png

3. Renseignez les paramètres selon votre environnement.

Attention : N'insérez pas d'espace ou de tabulation dans les valeurs. Ne saisissez pas de guillemets.

  • filePath : Chemin d'accès aux fichiers Excel et au fichier d'exclusion des logiciels
  • EZV_sql... : Adresse IP, port, login / mot de passe du serveur SQL de votre environnement Service Manager.
  • GOVERLAN_sql... : Adresse IP, port, login / mot de passe du serveur SQL de votre environnement EV Reach.

4. Sauvegardez le fichier.
 

Étape 2 : Configuration du job Talend GOVERLAN_LOAD_DATA_TO_EZV

1. Allez dans le répertoire 3.standalone jobs (engine)\goverlan_get_data_catalog_1.0\GOVERLAN_LOAD_DATA_CATALOG\local_project\goverlan_load_data_catalog_1_0\contexts du package EV Reach que vous avez dezippé.

2. Ouvrez le fichier Default.properties.

3. Renseignez les paramètres selon votre environnement.

4. Sauvegardez le fichier.

Première exécution de l'intégration entre EV Reach et Service Manager

Étape 1 (optionnelle) : Paramétrage de la liste des logiciels à ne pas extraire de la base EV Reach

But : Cette étape vous permet de renseigner les logiciels non suivis au niveau des licences, tels les plugins, runtimes, sdk, ..., afin qu'ils ne soient pas remonter dans les fichiers Excel de transcodage. Vous pouvez adapter la liste fournie par défaut en fonction de la politique de suivi des logiciels adoptée par votre organisation.

1. Allez dans le répertoire 3.standalone jobs (engine) du package EV Reach que vous avez dezippé 

2. Ouvrez le fichier Excel software_exclusion_list.xls contenant la liste d'exclusion des logiciels.

3. Ajoutez une ligne pour chaque logiciel à exclure.

          Software - Exclusion list.png

  • Vous pouvez utiliser le caractère joker % pour remplacer n'importe quelle chaîne de caractères.

    exemple  

    • Exclure tous les logiciels commençant par Aeon : Aeon%
    • Exclure tous les logiciels se terminant par Aeon : %Aeon
    • Exclure tous les logiciels contenant  : %Aeon%
  • Attention : Soyez vigilant dans l'utilisation du caractère joker %

    exemple  %A% : Exclut tous les logiciels contenant le caractère A (Adobe, Amazon, ...)

4. Sauvegardez le fichier.

Étape 2 : Extraction des données de la base EV Reach

1. Exécutez le script GOVERLAN_GET_DATA_CATALOG_run.xx situé dans le répertoire 3.standalone jobs (engine)/goverlan_get_data_to_ezv_1.0\GOVERLAN_GET_DATA_TO_EZV du package EV Reach que vous avez dezippé (suivant votre système d'exploitation, fichier batch .bat, powershell .ps1 ou shell linux .sh).

  • Le job GOVERLAN_GET_DATA_CATALOG est exécuté.
  • Les fichiers Excel de transcodage contenant les données Matériels et Logiciels extraites de la base EV Reach sont créés.
  • Les données Caractéristiques extraites de la base EV Reach sont restructurées pour être normalisées avec la table de référence Service Manager, puis stockées dans une table E_GOVERLAN_..._TO_EZV.

Étape 3 : Transcodage des données Matériels et Logiciels

But : Les étapes de transcodage vous permettent de normaliser les données Matériels et Logiciels extraites de la base EV Reach avec celles de vos référentiels Matériels et Logiciels de Service Manager.

Note : Aucun transcodage n'est à réaliser sur les données Caractéristiques.

Transcodage des données Matériels

1. Allez dans le répertoire contenant les fichiers Excel (répertoire renseigné dans le fichier DefaultProperties.txt via la variable filePath).

2. Ouvrez le fichier Excel catalog_asset.xls.
        Asset - Before Excel file.png

3. Renseignez les 3 colonnes CATEGORY_TRANSCODED, MAKE_TRANSCODED et MODEL_TRANSCODED, en indiquant la catégorie, la marque et le nom du modèle de matériel respectant les normes de votre référentiel Matériels dans Service Manager.
        Asset - After Excel file.png

4. Sauvegardez le fichier.

Transcodage des données Logiciels

1. Allez dans le répertoire contenant les fichiers Excel (répertoire renseigné dans le fichier DefaultProperties.txt via la variable filePath).

2. Ouvrez le fichier Excel catalog_software.xls.
        Software - Before Excel file.png

3. Renseignez les 2 colonnes SOFTWARE_NAME_TRANSCODED et SOFTWARE_PUBLISHER_TRANSCODED, en indiquant le nom du logiciel et le nom de l'éditeur respectant les normes de votre référentiel.
        Software - After Excel file.png

4. Indiquez dans la colonne FOLLOW_SOFTWARE si vous souhaitez suivre le logiciel dans votre référentiel (valeur 1) ou non (valeur 0).

Note : Cette colonne vous permet d'affiner la liste des logiciels à exclure, si vous ne les avez pas paramétrés dans la liste d'exclusion renseignée à l'étape 1.a.

5. Sauvegardez le fichier.

Étape 4 : Intégration des données transcodées Matériels et Logiciels dans les tables E_GOVERLAN_..._TO_EZV de Service Manager

1. Exécutez le script GOVERLAN_LOAD_DATA_CATALOG_run.xx situé dans le répertoire 3.standalone jobs (engine)/goverlan_load_data_to_ezv_1.0\GOVERLAN_LOAD_DATA_TO_EZV du package EV Reach que vous avez dezippé (suivant votre système d'exploitation, fichier batch .bat, powershell .ps1 ou shell linux .sh).

  • Le job GOVERLAN_LOAD_DATA_CATALOG est exécuté.
  • Les fichiers Excel contenant les données transcodées Matériels et Logiciels sont intégrés dans les tables E_GOVERLAN_..._TO_EZV  Service Manager.
  • Les fichiers Excel de contrôle sont générés.

Étape 5 : Vérification des données intégrées dans les tables E_GOVERLAN_..._TO_EZV de Service Manager

But : Cette étape vous permet de vous assurer de l'intégrité des données qui ont été intégrées dans les tables E_GOVERLAN_..._TO_EZV, et de les corriger si nécessaire.

1. Allez dans le répertoire contenant les fichiers Excel (répertoire renseigné dans le fichier DefaultProperties.txt via la variable filePath).

Contrôle des données Matériels

1. Contrôlez le contenu du fichier Excel output_asset_to_ezv.xls.

2. Si vous constatez des erreurs de transcodage :

  • Ouvrez le fichier Excel catalog_asset.xls contenant les références que vous avez transcodées à l'étape 3.

    Best Practice icon.png  Effectuez une sauvegarde du fichier avant d'effectuer vos corrections. Vous pourrez ainsi revenir en arrière si besoin.

  • Corrigez les colonnes CATEGORY_TRANSCODED, MAKE_TRANSCODED et MODEL_TRANSCODED pour les références Matériels en anomalie.
  • Sauvegardez le fichier.
  • Relancez l'intégration des données via le script GOVERLAN_LOAD_DATA_CATALOG_run.xx.

Contrôle des données Logiciels

1. Contrôlez le contenu du fichier Excel output_software_to_ezv.xls.

2. Si vous constatez des erreurs de transcodage :

  • Ouvrez le fichier Excel catalog_software.xls contenant les références que vous avez transcodées à l'étape 3.

    Best Practice icon.png  Effectuez une sauvegarde du fichier avant d'effectuer vos corrections. Vous pourrez ainsi revenir en arrière si besoin.

  • Corrigez les colonnes SOFTWARE_NAME_TRANSCODED, SOFTWARE_PUBLISHER_TRANSCODED et FOLLOW_SOFTWARE pour les références Logiciels en anomalie.
  • Sauvegardez le fichier.
  • Relancez l'intégration des données via le script GOVERLAN_LOAD_DATA_CATALOG_run.xx.

Contrôle des données Caractéristiques

1. Ouvrez le fichier Excel output_software_to_ezv.xls contenant les données Caractéristiques qui ont été intégrées.

2. Si vous constatez des erreurs, contactez le support EasyVista.

Configuration des modèles d'intégration EV Reach

Étape 1 : Import des modèles dédiés à l'intégration des données EV Reach dans Service Manager

Note : Effectuez cette étape uniquement si votre version de Service Manager est antérieure à la version 2022.

1. Allez sur le menu Administration > Import / Export > Import.

2. Importez les 6 fichiers .exp situés dans le répertoire 4.integration models for service manager (exp) du package EV Reach que vous avez dezippé.
 

Étape 2 : Recherche des modèles dédiés à l'intégration des données EV Reach

1. Allez sur le menu Administration > Intégration > Modèles d'intégration.

  • Les modèles sont préfixés par EV Reach.
  • Ils permettent d'intégrer les données finales des tables E_GOVERLAN_..._TO_EZV dans les bases de production Service Manager (tables AM_ASSET, AM_SOFTWARE, AM_CHARACTERISTICS).

          Integration model - Goverlan model list.png
 

Étape 3 : Intégration des données Matériels

Étape 3.a : Mise à jour du catalogue des matériels

1. Recherchez le modèle 01.Goverlan / Create equipment catalog dédié à la mise à jour du catalogue des matériels.

2. Cliquez sur Edit icon.png en regard du modèle d'intégration.

3. Sélectionnez la langue dans laquelle sont écrites les données à intégrer.

4. Configurez la connexion à la base Service Manager.

  • Sélectionnez le type de données datasource.
  • Cliquez sur Définir.
            Integration model - General configuration.png
  • Renseignez la chaîne de connexion pour accéder à la base EVO_BACKOFFICE, en indiquant le mot de passe.
            Integration model - General configuration - Connection string.png
  • Renseignez la requête SQL de recherche des données à intégrer, via le champ Query, en remplaçant les valeurs indiquées en jaune par l'environnement Sandbox.
            Integration model - Equipment create catalog query.png

5. Allez sur l'étape 2 du modèle d'intégration et renseignez la correspondance des champs comme indiqué ci-dessous.
        Integration model - Equipment create catalog mapping.png

Étape 3.b : Mise à jour de l'inventaire des matériels

1. Recherchez le modèle 02.Goverlan / Import equipment dédié à la mise à jour de l'inventaire des matériels.

2. Cliquez sur Edit icon.png en regard du modèle d'intégration.

3. Sélectionnez la langue dans laquelle sont écrites les données à intégrer.

4. Configurez la connexion à la base Service Manager.

  • Sélectionnez le type de données datasource.
  • Cliquez sur Définir.
  • Renseignez la chaîne de connexion pour accéder à la base EVO_BACKOFFICE, en indiquant le compte et le mot de passe.
  • Renseignez la requête SQL de recherche des données à intégrer, via le champ Query, en remplaçant les valeurs indiquées en jaune par l'environnement Sandbox.
    Note : La clause WHERE permet d'importer uniquement les matériels dont la date d'inventaire a changé par rapport à la date d'inventaire précédent.
            Integration model - Equipment import query.png

5. Allez sur l'étape 2 du modèle d'intégration et renseignez la correspondance des champs comme indiqué ci-dessous.

  • Sélectionnez le champ source STATUS_xx correspondant à la langue dans laquelle sont écrites les données à intégrer. Par défaut, le champ est sélectionné dans la langue Anglais (STATUS_EN).
            Integration model - Equipment import mapping.png

Étape 4 : Intégration des données Logiciels

Étape 4.a : Mise à jour du catalogue des logiciels

1. Recherchez le modèle 03.Goverlan / Create software catalog dédié à la mise à jour du catalogue des logiciels.

2. Cliquez sur Edit icon.png en regard du modèle d'intégration.

3. Sélectionnez la langue dans laquelle sont écrites les données à intégrer.

4. Configurez la connexion à la base Service Manager.

  • Sélectionnez le type de données datasource.
  • Cliquez sur Définir.
  • Renseignez la chaîne de connexion pour accéder à la base EVO_BACKOFFICE, en indiquant le mot de passe.
  • Renseignez la requête SQL de recherche des données à intégrer, via le champ Query, en remplaçant les valeurs indiquées en jaune par l'environnement Sandbox.

    Note : La clause WHERE permet d'importer uniquement les logiciels marqués À suivre (colonne du fichier Excel FOLLOW_SOFTWARE = 1).

          Integration model - Software create catalog query.png

5. Allez sur l'étape 2 du modèle d'intégration et renseignez la correspondance des champs comme indiqué ci-dessous.
        Integration model - Software create catalog mapping.png

Étape 4.b : Mise à jour de l'inventaire des licences

1. Recherchez le modèle 04.Goverlan / Add software to equipment dédié à la mise à jour de l'inventaire des licences.

2. Cliquez sur Edit icon.png en regard du modèle d'intégration.

3. Sélectionnez la langue dans laquelle sont écrites les données à intégrer.

4. Configurez la connexion à la base Service Manager.

  • Sélectionnez le type de données datasource.
  • Cliquez sur Définir.
  • Renseignez la chaîne de connexion pour accéder à la base EVO_BACKOFFICE, en indiquant le compte et le mot de passe.
  • Renseignez la requête SQL de recherche des données à intégrer, via le champ Query, en remplaçant les valeurs indiquées en jaune par l'environnement Sandbox.
    Note : La clause EXCEPT permet d'importer uniquement les écarts de logiciels entre 2 intégrations (changement de version d'un logiciel, nouveau logiciel détecté).
            Integration model - Software add to equipment query.png

5. Allez sur l'étape 2 du modèle d'intégration "et renseignez la correspondance des champs comme indiqué ci-dessous.
        Integration model - Software add to equipment mapping.png

Étape 5 : Intégration des données Caractéristiques

Étape 5.a : Mise à jour de la table de référence Caractéristiques

1. Recherchez le modèle 05.Goverlan / Create attributes dédié à la mise à jour de la table de référence Caractéristiques.

2. Cliquez sur Edit icon.png en regard du modèle d'intégration.

3. Sélectionnez la langue dans laquelle sont écrites les données à intégrer.

4. Configurez la connexion à la base Service Manager.

  • Sélectionnez le type de données datasource.
  • Cliquez sur Définir.
  • Renseignez la chaîne de connexion pour accéder à la base EVO_BACKOFFICE, en indiquant le compte et le mot de passe.
  • Renseignez la requête SQL de recherche des données à intégrer, via le champ Query, en remplaçant les valeurs indiquées en jaune par l'environnement Sandbox. Note : La requête retourne les traductions multilingues de chaque caractéristique (ATTRIBUTE_EN, ATTRIBUTE_FR, ...) pour les intégrer automatiquement dans la table de référence Caractéristiques.
            Integration model - Attributes create query.png

5. Allez sur l'étape 2 du modèle d'intégration et renseignez la correspondance des champs comme indiqué ci-dessous.

  • Sélectionnez les champs sources ATTRIBUTE_xx et TYPE_xx correspondant à la langue dans laquelle sont écrites les données à intégrer. Par défaut, les champs sont sélectionnés dans la langue Anglais (ATTRIBUTE_EN et TYPE_EN).
            Integration model - Attributes create mapping.png

Étape 5.b : Mise à jour des caractéristiques sur l'inventaire des matériels

1. Recherchez le modèle 06.Goverlan / Add attributes to equipment dédié à la mise à jour des caractéristiques sur l'inventaire des matériels.

2. Cliquez sur Edit icon.png en regard du modèle d'intégration.

3. Sélectionnez la langue dans laquelle sont écrites les données à intégrer.

4. Configurez la connexion à la base Service Manager.

  • Sélectionnez le type de données datasource.
  • Cliquez sur Définir.
  • Renseignez la chaîne de connexion pour accéder à la base EVO_BACKOFFICE, en indiquant le compte et le mot de passe.
  • Renseignez la requête SQL de recherche des données à intégrer, via le champ Query, en remplaçant les valeurs indiquées en jaune par l'environnement Sandbox. Note : La requête retourne les traductions multilingues de chaque caractéristique (ATTRIBUTE_EN, ATTRIBUTE_FR, ...) pour les intégrer automatiquement dans l'inventaire des matériels.
            Integration model - Attributes add to equipment query.png

5. Allez sur l'étape 2 du modèle d'intégration et renseignez la correspondance des champs comme indiqué ci-dessous.

  • Sélectionnez le champ source ATTRIBUTE_xx correspondant à la langue dans laquelle sont écrites les données à intégrer. Par défaut, le champ est sélectionné dans la langue Anglais (ATTRIBUTE_EN).
            Integration model - Attributes add to equipment mapping.png

Planification de l'exécution des jobs Talend et de l'exécution des modèles d'intégration EV Reach

Best Practice icon.png  Planifiez et définissez la fréquence d'exécution des jobs Talend et des modèles d'intégration en fonction de la fréquence de votre suivi des données extraites par EV Reach.

Planification de l'exécution des jobs Talend

Utilisez un ordonnanceur (tel le planificateur de tâches Windows) pour automatiser l'exécution des jobs.

Étape 1 : Planification du job GOVERLAN_GET_DATA_TO_EZV

1. Allez dans le répertoire 3.standalone jobs (engine)\goverlan_get_data_catalog_1.0\GOVERLAN_GET_DATA_CATALOG du package EV Reach que vous avez dezippé.

2. Planifiez le script GOVERLAN_GET_DATA_CATALOG_run.xx en utilisant le fichier batch .bat, powershell .ps1 ou shell linux .sh suivant votre système d'exploitation.

Le job GOVERLAN_GET_DATA_TO_EZV va s'exécuter suivant la fréquence définie.

  • Les données Matériels et Logiciels nouvelles ou modifiées vont être extraites de la base EV Reach. Elles vont être ajoutées aux fichiers Excel de transcodage existants.
  • Les données Caractéristiques nouvelles ou modifiées vont être extraites de la base EV Reach. Elles vont être restructurées pour être normalisées avec la table de référence Service Manager, puis stockées dans la table E_GOVERLAN_..._TO_EZV.

Étape 2 : Planification du job GOVERLAN_LOAD_DATA_TO_EZV

1. Allez dans le répertoire 3.standalone jobs (engine)\goverlan_get_data_catalog_1.0\GOVERLAN_LOAD_DATA_CATALOG du package EV Reach que vous avez dezippé.

2. Planifiez le script GOVERLAN_LOAD_DATA_CATALOG_run.xx en utilisant le fichier batch .bat, powershell .ps1 ou shell linux .sh suivant votre système d'exploitation.

Le job GOVERLAN_LOAD_DATA_TO_EZV va s'exécuter suivant la fréquence définie.

  • Les fichiers Excel contenant les données transcodées Matériels et Logiciels vont être intégrés dans les tables E_GOVERLAN_..._TO_EZV.
  • Les fichiers Excel de contrôle vont être générés.

Planification de l'exécution des modèles d'intégration EV Reach

Vous pouvez utiliser l'ordonnanceur smoScheduler de Service Manager en définissant une tâche planifiée, ou utiliser un ordonnanceur externe (tel le planificateur de tâches de Windows) ou une application tierce.
   Open url.png voir Comment automatiser une intégration

  • Les 6 modèles d'intégration EV Reach vont s'exécuter suivant la fréquence définie.
  • Les données finales des tables E_GOVERLAN_..._TO_EZV vont être intégrées dans les bases de production Service Manager (tables AM_ASSET, AM_SOFTWARE, AM_CHARACTERISTICS).

Planification via l'outil smoIntegration

  • Note : L'outil smoIntegration est accessible uniquement aux clients OnPremise.
  • Il vous permet d'exécuter les modèles d'intégration en dehors des tâches planifiées (i.e., en dehors de l'ordonnanceur smoScheduler de Service Manager).
  • Vous pouvez télécharger le fichier smoIntegration.exe dans le répertoire 5.run smo_integration on-prem (bat) du package EV Reach que vous avez dezippé.
     

Étape 1 : Désactivation de l'exécution des modèles d'intégration EV Reach par l'ordonnanceur smoScheduler de Service Manager

1. Allez sur menu menu Administration > Intégration > Modèles d'intégration.

2. Éditez chaque modèle d'intégration EV Reach, via Edit icon.png.

3. Décochez la case Activée dans la fenêtre d'informations de planification.

Étape 2 : Création du script d'exécution automatique des 6 modèles d'intégration EV Reach sur les bases de production

1. Ouvrez le fichier run_smoIntegration (50004) situé dans le répertoire 5.run smo_integration on-prem (bat) du package EV Reach que vous avez dezippé.

2. Remplacez les valeurs indiquées en jaune par les valeurs de votre environnement.

  • smoIntegration : Chemin d'accès à l'exécutable smoIntegration, sur votre disque dur.
  • Variable portSmoServer : Port du service smoServer
  • Variable ipSmoServer : Adresse IP du service smoServer
  • Variable accountEZV : Compte de la base Service Manager (50004, 50005).

Attention : Ne modifiez pas les variables modelname qui correspondent aux libellés anglais des modèles, entre guillemets.

@echo off

set smoIntegration=C:\talend\smo_integration
set accountEZV=50004
set portSmoServer=xx.xx.xx.xx
set ipSmoServer=xx.xx.xx.xx

del /q %smoIntegration%\log\*.*

echo Integration is running... Please wait...

echo 01.Goverlan / Create equipment catalog
%smoIntegration%\smoIntegration.exe -port=%portSmoServer% -ip=%ipSmoServer% -account=%accountEZV% -modelname="01.Goverlan / Create equipment catalog"

echo 02.Goverlan / Import equipment
%smoIntegration%\smoIntegration.exe -port=%portSmoServer% -ip=%ipSmoServer% -account=%accountEZV% -modelname="02.Goverlan / Import equipment"

echo 03.Goverlan / Create software catalog
%smoIntegration%\smoIntegration.exe -port=%portSmoServer% -ip=%ipSmoServer% -account=%accountEZV% -modelname="03.Goverlan / Create software catalog"

echo 04.Goverlan / Add software to equipment
%smoIntegration%\smoIntegration.exe -port=%portSmoServer% -ip=%ipSmoServer% -account=%accountEZV% -modelname="04.Goverlan / Add software to equipment"

echo 05.Goverlan / Create attributes
%smoIntegration%\smoIntegration.exe -port=%portSmoServer% -ip=%ipSmoServer% -account=%accountEZV% -modelname="05.Goverlan / Create attributes"

echo 06.Goverlan / Add attributes to equipment
%smoIntegration%\smoIntegration.exe -port=%portSmoServer% -ip=%ipSmoServer% -account=%accountEZV% -modelname="06.Goverlan / Add attributes to equipment"

3. Sauvegardez le fichier.

4. Configurez de la même façon le fichier run_smoIntegration (50005) situé dans le répertoire 5.run smo_integration on-prem (bat) du package EV Reach que vous avez dezippé.

Suivi régulier des données Matériels et Logiciels extraites par EV Reach

But :

  • L'exécution régulière des jobs Talend permet d'extraire de la base EV Reach toutes les données Matériels et Logiciels nouvelles ou modifiées et de les ajouter régulièrement dans les fichiers Excel de transcodage.
  • Vous devez ensuite transcoder ces références nouvelles ou modifiées pour qu'elles puissent être intégrées dans les bases Service Manager.
     

Étape 1 : Suivi des données Matériels

1. Allez dans le répertoire contenant les fichiers Excel (répertoire renseigné dans le fichier DefaultProperties.txt via la variable filePath).

2. Ouvrez le fichier Excel de transcodage catalog_asset.xls.

3. Renseignez les 3 colonnes CATEGORY_TRANSCODED, MAKE_TRANSCODED et MODEL_TRANSCODED des nouvelles références et des références modifiées.

Les modifications sur les données Matériels sont intégrées dans le référentiel Service Manager lors de la prochaine exécution des modèles d'intégration EV Reach.
 

Étape 2 : Suivi des données Logiciels

1. Ouvrez le fichier Excel de transcodage catalog_software.xls.

2. Renseignez les colonnes SOFTWARE_NAME_TRANSCODED, SOFTWARE_PUBLISHER_TRANSCODED et FOLLOW_SOFTWARE des nouvelles références et des références modifiées.

Les modifications sur les données Logiciels sont intégrées dans le référentiel Service Manager lors de la prochaine exécution des modèles d'intégration EV Reach.

Description des jobs Talend

Job GOVERLAN_GET_DATA_CATALOG

          Talend - Job GOVERLAN_GET_DATA_CATALOG.png

Ce job permet :

  • d'extraire les données Matériels, Logiciels et Caractéristiques de la base EV Reach à partir de vues SQL EV Reach dédiées ;
  • de nettoyer et homogénéiser les données Matériels et Logiciels extraites pour garantir des référentiels Matériels et Logiciels uniformes dans Service Manager ;
  • de modifier la structure des données Caractéristiques extraites pour les adapter à la structure de la table de référence Caractéristiques de Service Manager.
  • de vérifier le bon déroulement du job.

Job GOVERLAN_LOAD_DATA_TO_EZV

          Talend - Job GOVERLAN_LOAD_DATA_TO_EZV.png

Ce job permet de :

  • conserver uniquement la version la plus récente d'un même logiciel ;
  • supprimer du référentiel Logiciels de Service Manager les logiciels qui ne sont plus détectés par EV Reach (étape cleanup) ;
  • générer des fichiers Excel de contrôle contenant les données prêtes à être intégrées dans Service Manager.
  • de vérifier le bon déroulement du job.

Liste des fichiers à télécharger

Note : Reportez-vous au processus d'intégration pour leur utilisation.

          Download icon.png  Package EV Reach

Tags :
Powered by XWiki © EasyVista 2022