Import / Export


DefinitionExport

L'export consiste à extraire des objets (filtres, vues, ...) d'une base Service Manager, puis à générer un fichier d'export. 

EndDefinitionExport
DefinitionImport

L'import consiste à télécharger un fichier d'export et à intégrer les objets qu'il contient dans une base Service Manager.

EndDefinitionImport

Objets pouvant être exportés / importés
Alertes planifiées, Assistants, Baselines, Blocs, Connecteurs, Composants mails, Éditeur de rapports (smoReportDesigner), Filtres, Indicateurs, Mails types, Modèles d’intégration, Profils, Questionnaires, Questionnaires multi-sections, Règles métier, Reportings, Représentations, Requêtes, Rôles personnalisés, Vues, Workflows / Processus associés aux règles métier, XSD
 

Quelles sont les finalités de l'import / export ?

  • Récupérer dans une base de production des objets créés ou modifiés sur une base de test, ce qui évite de les recréer.
  • Reproduire rapidement la configuration d’une base de développement vers une base de production.
  • Remplacer des éléments existants par ceux d'une nouvelle version, dans le cadre d’une migration de Service Manager.
  • Aider à la résolution des incidents dans le cadre du support technique (fourniture d'éléments corrigés suite à un bug).

Exemples

Diffuser sur l'ensemble des bases de production un filtre Matériels créé sur la base de test :

1. Exportez l'objet Filtres depuis la base de test

==> Résultat : Création d'un fichier .exp

2. Importez le fichier sur chacune des bases de production

==> Résultat : Après intégration, les utilisateurs peuvent accéder au nouveau filtre qui est automatiquement proposé dans la liste des filtres relatifs aux matériels (sous réserve des droits par profil définis pour le filtre).

Remarques

  • Ne confondez pas l'export des objets Service Manager décrit dans cette page et l'export des enregistrements, consistant à extraire uniquement les données  - Open url.png voir fonctionnalité Exporter les enregistrements
  • La liste des objets pouvant être exportés est fournie par EasyVista. Vous ne pouvez pas en ajouter.
  • Les fichiers d'export sont cryptés et compressés. Ils ne sont pas modifiables.
  • L'export peut être :
    • Global, via l'option de menu Export. Plusieurs objets de nature différente peuvent être sélectionnés. L'export génère un fichier .zip.
    • Unitaire, via des options de menu dédiées. L'export génère des fichiers .exp respectant des règles de nommage suivant le type d'objets exportés.
  • L'import peut se faire à partir d'un fichier .zip ou d'un fichier .exp. Seuls les éléments qui diffèrent entre le fichier d'export et la base cible sont importés en base.
  • Le nombre d'objets importés peut être supérieur au nombre d'objets exportés.

    exemple  Export de reportings comprenant également l'export des filtres et vues associés

Attention

  • Avant de lancer l'import, assurez-vous d'être connecté à la bonne base Service Manager.
  • Pour conserver la cohérence en base des relations, les fichiers exportés doivent être importés en respectant l'ordre des valeurs numériques ajoutées au nom des fichiers : les fichiers nommés 100 doivent être importés en premier, puis les fichiers nommés 200, puis les fichiers nommés 300...
  • Après l'import, pensez à mettre à jour les droits d'accès aux objets qui sont par défaut accessibles à tous les profils (vous pouvez également faire un export puis un import des profils).

Bonnes pratiques

  • Pour importer les objets dans plusieurs bases, connectez-vous à chaque bass et lancez l'import à partir du même fichier.
  • Pour importer plusieurs types d'objets en une seule opération, effectuez un export global afin de constituer un seul fichier, puis téléchargez celui-ci.

Spécificités des versions 2016 et antérieures

  • Les formulaires, les tables croisées, les thèmes sont disponibles uniquement dans ces versions.
  • Règles de nommage :
Règle Exemple
Objet Convention de nommage Objet Convention de nommage
Formulaires Export_200_SD_FORMS__(nom formulaire)_aaaammjjhhmmss.exp Configuration complète Export_200_SD_FORMS__Full_Configuration.exp
Tables croisées Export_200_C_PIVOTTABLE__(nom table croisée)_aaaammjjhhmmss.exp Catégories par entité Export_200_C_PIVOTTABLE__Types_by_Department.exp
Thèmes Export_200_THEME__(nom thème)_aaaammjjhhmmss.exp Transition Export_200_C_THEME__Transition.exp

Cas particuliers

Objet Remarques
Filtres et vues
  • Les noms de fichiers d'export ne sont pas forcément uniques.
    exemple   Filtre Aucun présent sur la majorité des menus
Questionnaires
  • Les questions sont exportées en même temps que le questionnaire associé.
  • Les surcharges ne sont pas prises en compte par l'export.
Questionnaires multi-sections
  • Les sections et les questions associées au questionnaire sont exportées en même temps que le questionnaire.
Règles métier
  • Exportez au préalable les processus associés pour maintenir le lien entre les éléments.
Reportings
  • Par défaut, l'import d'un reporting écrase la requête parent.
  • Pour conserver les modifications apportées à la requête (ex. : Ajout d'un champ E_..., Libellé d'un champ modifié), cochez la case Ne pas écraser la requête parente lors de l’import.
Requêtes parent
  • Exportez les requêtes avec les objets qui les utilisent (filtre, vue, ...) lorsqu'elles ont été modifiées ou personnalisées (ajout de champs supplémentaires).
  • Importez-les toujours avant les objets qui les utilisent.
Représentations
  • L'export concerne uniquement les représentations conditionnelles.
XSD
  • Les fichiers sont fournis uniquement dans le cadre du support technique.

Description des écrans

Import d'objets

       Import.png

Accès menu : Administration > Import / Export > Import

Document à télécharger : Chemin et nom du fichier d'export à intégrer dans la base Service Manager.

Import et fusion des assistants (Note : Uniquement pour l'objet Assistants) : Indique si le paramétrage actuel des assistants doit être conservé (case cochée) ou s'il doit être remplacé par le paramétrage de la nouvelle version (case non cochée).

Export d'objets

       Export.png

Accès menu :

  • Administration > Import / Export > Export pour un export global
  • Administration > Import / Export > Export de... pour un export unitaire
     

Export unitaire

  • Le fichier généré répond à des règles de nommage précises.
  • Plusieurs éléments d'un même objet peuvent être exportés simultanément. Dans ce cas, le nom du fichier est constitué à partir du nom du dernier élément de la sélection.

    exemple  Export simultané des profils Discovery, Operation, Transition ==> Nom du fichier : Export_AM_PROFIL__Transition.exp

     

Export global

  • Plusieurs types d'objets peuvent être exportés en une seule opération.
  • Le fichier est généré sous la forme d'un fichier compressé .zip, avec le nom Export_Package suivi de la date AAAAMMJJ.
  • Il comprend un fichier .exp pour chaque type d'objets, chacun répondant aux règles de nommage.

    exemple  Export des profils Utilisateurs, des connecteurs Caractéristiques et Capacités et de la représentation Licence

    • Fichier généré : Export_Package_20160729191254.zip 
    • Comprend 3 fichiers .exp : Profil, Connecteur, Block

Règles de nommage des objets exportés

Note : La valeur numérique ajoutée dans le nom de chaque fichier indique l’ordre dans lequel les fichiers doivent être importés afin de conserver la cohérence des relations en base.

Règle Exemple
Objet Convention de nommage Objet Convention de nommage
Alertes planifiées Export_400_C_TASK_alerts__(nom alerte planifiée)_aaaammjjhhmmss.exp Contrats à annuler Export_400_C_TASK_alerts__Contracts_to_Cancel.exp
Assistants Export_200_C_WIZARD__(nom assistant)_aaaammjjhhmmss.exp Entrée en stock Export_200_C_WIZARD__Delivery_Reception.exp
Baselines (graphes de la CMDB) Export_200_CMDB_GRAPH__(nom baseline)_aaaammjjhhmmss.exp ORA-RDB_UK Export_200_CMDB_GRAPH__ORA-RDB_UK_.exp
Blocs (menus, grilles, fiches, ...) Export_200_C_BLOCK__(nom bloc)_aaaammjjhhmmss.exp DialogEquipment Export_200_C_BLOCK__DialogEquipment.exp
Composants mails Export_SD_MAIL_TAG__(nom composants mail)_aaaammjjhhmmss.exp ServiceDesk_Signature Export_SD_MAIL_TAG__ServiceDesk_Signature.exp
Connecteurs (modèles d'intégration) Export_200_IN_CONNECTOR __(nom connecteur)_aaaammjjhhmmss.exp Employés Export_200_IN_CONNECTOR__Employees.exp
Éditeur de rapports (smoReportDesigner) Export_200_C_REPORTDESIGNER__(nom éditeur de rapport)_aaaammjjhhmmss.exp Bon de commande Export_200_C_REPORTDESIGNER__Order_Form.exp
Filtres Export_200_C_FILTER__(nom filtre)_aaaammjjhhmmss.exp Matériels en stock Export_200_C_FILTER__In_Stock.exp
Indicateurs Export_400_C_TASK_statistic__(nom indicateur)_aaaammjjhhmmss.exp Nombre d'incidents créés cette semaine Export_400_C_TASK_statistic__Number_of_Incidents_Created_This_Week.exp
Mails type Export_300_SD_MAIL_TYPE__(sujet du mail type)_aaaammjjhhmmss.exp [IT Service Desk] - Configuration Internet Explorer Export_300_SD_MAIL_TYPE__[IT_Service_Desk]_-_Internet_Explorer_Configuration.exp
Modèles d’intégration Export_400_C_TASK_integration__(nom modèle d'intégration)_aaaammjjhhmmss.exp Employés Export_400_C_TASK_integration__Employees.exp
Profils Export_200_AM_PROFIL__(nom profil)_aaaammjjhhmmss.exp Administrateur Export_200_AM_PROFIL__Administrator.exp
Questionnaires Export_300_SD_QUESTION_LIST__(nom questionnaire)_aaaammjjhhmmss.exp Oracle Export_300_SD_QUESTION_LIST__Oracle.exp
Questionnaires multi-sections Export_300_SD_QUESTION_LIST__(nom questionnaire multi-sections)_aaaammjjhhmmss.exp Groupes et intervenants Export_300_SD_QUESTION_LIST__Groups_and_Intervenants.exp
Règles métier Export_500_SD_PROCESS_DEF__(nom règle métier)_aaaammjjhhmmss.exp Modèle de Règle métier Contrat Export_500_SD_PROCESS_DEF__Contract_Business_Rule_Template.exp
Reportings Export_400_C_TASK_reporting__(nom reporting)_aaaammjjhhmmss.exp Entités sans plan de continuité Export_400_C_TASK_reporting__Departments_Without_Continuity_Plan.exp
Représentations Export_100_C_BLOCK_OVERLOAD__(nom représentation)_aaaammjjhhmmss.exp Incidents clôturés Export_100_C_BLOCK_OVERLOAD__Closed_Incidents.exp
Requêtes Export_200_C_QUERY__AM_(nom requête)_aaaammjjhhmmss.exp Centres de coûts Export_200_C_QUERY__AM_CostCenter.exp
Rôles personnalisés Export_300_GENERIC_ROLE__(nom rôle personnalisé)_aaaammjjhhmmss.exp Propriétaire du matériel Export_300_GENERIC_ROLE__Asset_Owner.exp
Vues Export_200_C_REPORT__(nom vue)_aaaammjjhhmmss.exp Liste des matériels Export_200_C_REPORT__List.exp
Worflows / Processus associés (workflows et processus associés aux règles métier) Export_400_SD_WORKFLOW__(nom workflow ou processus).exp Processus réseau Export_400_SD_WORKFLOW__Network_Process.exp
XSD (éléments internes contenant la structure des fichiers xml) Export_100_C_XSD__(nom xsd)_aaaammjjhhmmss.exp DYNAMIC FORM Export_100_C_XSD__DYNAMIC_FORM.exp

Procédures

Comment exporter des objets

Étape 1 : Export des objets

1. Allez sur l'écran Administration > Import / Export.

2. Sélectionnez l'opération d'export à effectuer.

  • Soit cliquez sur l'option Export pour réaliser un export global, et sélectionnez les objets souhaités.
  • Soit cliquez sur l'option dédiée Export de pour réaliser l'export d'un seul type d'objets, et sélectionnez les éléments souhaités.

3. Lancez l'assistant Exporter.

L'export des objets est réalisé.

  • Fichier .zip s'il s'agit d'un export global.
  • Fichier .exp s'il s'agit d'un export unitaire.

Étape 2 : Téléchargement du fichier d'export

1. Cliquez sur le lien Cliquez ici pour télécharger le fichier.

2. Cliquez sur Enregistrer dans la boîte de dialogue Téléchargement de fichiers.

3. Indiquez le répertoire de sauvegarde du fichier.

4. Cliquez sur Fermer.
Le fichier d'export est téléchargé.

Comment importer un fichier d'export

Attention : Vous devez toujours réaliser l'import des fichiers en respectant l'ordre croissant de leur numérotation.

exemple  Importez les fichiers suivants dans l'ordre ci-dessous.

1. Export_100_C_XSD__DYNAMIC_FORM.exp
2. Export_200_C_REPORT__List.exp
3. Export_300_SD_QUESTION_LIST__Oracle.exp
4. Export_400_C_TASK_integration__Employees.exp 

1. Allez sur l'écran Administration > Import / Export > Import.

2. Sélectionnez le fichier d'export à télécharger, via Parcourir puis Télécharger.
La liste des éléments qui vont être intégrés est affichée, avec la date de dernière modification et le nom de l'intervenant ayant effectué cette modification.

3. Cliquez sur Suivant.
L'opération d'import est effectuée. Le nombre d'éléments intégrés est affiché.

4. Cliquez sur Terminer.

Tags:
Modifié par Utilisateur inconnu le 2021/05/31 19:34
Créé par Administrator XWiki le 2013/03/25 18:20

Raccourcis

L'actualité mensuelle
•  Newsletter

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

Powered by XWiki ©, EasyVista 2021