Transférer une définition de service d'une instance à une autre

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 6 minutes de lecture

    • Gagnez du temps et économisez votre énergie en exportant des définitions d’instances de service à partir de l’instance source et en important ces définitions dans l’instance cible. Vous pouvez utiliser cette méthode pour copier les définitions des instances de service uniquement du type détecté.

    En règle générale, vous gérez deux instances ServiceNow dans votre organisation : une pour la production et l'autre pour le développement. Effectuez le mappage initial des services d'application de votre organisation sur l'instance de développement, que vous utilisez pour les tests. Les résultats du mappage initial nécessitent souvent un dépannage ou un réglage de base. Lorsque vous avez terminé de mapper les services d'application sur votre instance source, transférez les définitions de service dans l'instance cible (production).

    Notez que vous ne pouvez exporter que les définitions de service, et pas les services d'application réels. Le mappage est un processus dynamique, et son résultat reflète l'infrastructure réelle et sa configuration. Il en résulte que les services que vous avez exportés d'une instance et importés dans une autre peuvent sembler différents.

    Par défaut, vous exportez les définitions de service suivantes :
    • Nom de service
    • Utilisation de la détection basée sur le trafic
    • Point d'entrée
    • Criticité opérationnelle
    • Groupe auquel le service appartient

      Si ce groupe de services fait partie d'une hiérarchie de groupes de services, tous les groupes de services parents de cette hiérarchie sont également exportés.

    • Commentaires
    Le système utilise l'attribut ID système [sys_id] pour identifier les services sur les instances source et cible et implémente l'importation des définitions de service en fonction des règles suivantes :
    • Si un ID système de service n'existe pas sur l'instance cible, le système crée un nouveau service sur l'instance cible.
    • Si un ID système et un nom de service existent déjà sur l'instance cible, le système met à jour ce service en remplaçant les définitions de service existantes par les définitions importées.
    • Si un ID système de service existe sur l'instance cible, mais qu'il est associé à un autre nom de service, le système met à jour le service avec cet ID système. Le système remplace les définitions de service, y compris le nom du service.
    • Si un même nom est utilisé pour différents services sur les instances source et cible, le système n'importe pas les définitions de service.
    • Vous ne pouvez pas exporter de services manuels. De même, vous ne pouvez pas exporter de points d'entrée ajoutés manuellement. Lors de l'importation des définitions d'un service contenant des points d'entrée manuels, le système n'apporte aucune modification à ceux-ci.
    Figure 1. Exporter un flux de définitions de service

    Exportation des définitions de service.

    Lors du transfert des définitions de service entre les instances, les instances de service et les groupes de services importés sont affectés au domaine de l’utilisateur.

    Par défaut, le système affecte l'état Non-operational aux services d'application dont vous avez importé les définitions.

    Un transfert de définition de service déploie la fonctionnalité de jeu d'importation standard disponible sur la Now Platform. Lorsque vous exportez des définitions de service sur l'instance source, le système crée un fichier JSON contenant des données exportées. Lorsque vous copiez des définitions de service dans l'instance cible, vous importez les données de ce fichier JSON, qui devient un jeu d'importation.

    Exporter des définitions de service

    Créez un jeu d'importation contenant des définitions de services. Vous pouvez utiliser ce jeu d'importation pour importer des définitions de service dans une autre instance.

    Avant de commencer

    • Décidez des définitions de service à exporter.
      Important :
      vous pouvez utiliser cette méthode pour copier les définitions des services d'application du type détecté uniquement.
    • Vérifiez que les instances source et cible sont dans la même version ServiceNow.
    • Ouvrez l'instance source à partir de laquelle vous souhaitez copier les définitions de service.
    • Si nécessaire, affinez la création d’un jeu d’importation en modifiant les propriétés pertinentes sous Mappage des services > Administration > Propriétés. Pour plus d'informations, consultez Composants installés avec Mappage des services.
    Rôle requis : service_mapping_admin

    Procédure

    1. Si l'instance utilise la séparation de domaine et que vous avez accès au domaine global, sélectionnez le domaine auquel le de service appartient dans le sélecteur de domaine (Sélecteur de domaine).
      Le domaine sélectionné doit être un domaine sans domaine enfant.
    2. Accédez à la Mappage des services > Services > Services d'application.
    3. Sélectionnez les services d'application que vous souhaitez exporter.
    4. Cliquez sur Actions sur les lignes sélectionnées en bas de la page, puis sélectionnez Exporter les services.
      Le jeu d'importation apparaît dans le dossier Téléchargements. Le nom du fichier respecte la convention suivante : export_service_<datetime>.json.
    5. Si nécessaire, copiez le jeu d'importation à un autre emplacement sur l'ordinateur.

    Importer des définitions de service d'une instance à l'autre

    Importez les définitions des services d'application à partir de l'instance source.

    Avant de commencer

    • Vérifiez que les instances source et cible sont dans la même version ServiceNow.
    • Ouvrez l'instance cible dans laquelle vous souhaitez importer des définitions de service.
    Rôle requis : import_admin

    Procédure

    1. Si l'instance utilise la séparation de domaine et que vous avez accès au domaine global, sélectionnez le domaine auquel le de service appartient dans le sélecteur de domaine (Sélecteur de domaine).
      Le domaine sélectionné doit être un domaine sans domaine enfant.
    2. Accédez à la Mappage des services > Services > Définitions des services d'importation.
    3. Dans la fenêtre Importer les définitions de service, cliquez sur Choisir un fichier, accédez au fichier JSON qui contient des définitions de service, puis cliquez sur OK.
    4. Facultatif : Cliquez sur Afficher l'aperçu et vérifiez les définitions dans le fichier JSON choisi.
    5. Cliquez sur Importer.
    6. Cliquez sur Oui pour confirmer que vous êtes prêt à importer les définitions de service.
      Important :
      Pendant l'importation, le système écrase les définitions de service actuelles de façon irréversible.

      La fenêtre de progression affiche le message de réussite.

      Mappage des services démarre automatiquement la détection des services qui contiennent des points d'entrée importés.

    7. Vérifiez les services importés ou mis à jour après que Mappage des services a terminé le processus de mappage.
      Si le transfert ne correspond pas au résultat attendu, effectuez un dépannage de base comme décrit dans le tableau ci-dessous.
    Symptôme Cause Solution
    Les changements que vous avez récemment apportés à un de service ont disparu. Les définitions des services d'application existants sont toujours remplacées lors du transfert.
    1. Apportez à nouveau les changements nécessaires aux définitions de ce de service.
    2. Exécutez la détection de haut en bas de ce de service en cliquant sur Exécuter la détection dans la carte de services.
    Un groupe de services importé n'apparaît pas. L'importation d'un service d'application affecté à ce groupe a échoué, et le système n'a pas créé le groupe, car il semble vide.
    1. Résolvez le problème qui a empêché le système d'importer le de service appartenant à ce groupe.
    2. Importez à nouveau le jeu d'importation.
    3. Vérifiez que le groupe de services s'affiche.
    Des services d'application incorrects ont été affectés à un groupe de services importé. Il s'agit d'un autre groupe de services qui porte le même nom, et non du groupe de services que vous avez importé. Le système n'a pas pu importer le groupe de services, car l'instance source dispose déjà d'un groupe de services du même nom ou portant le même nom et le même ID système.
    1. Vérifiez le journal d'importation.
    2. Si une erreur indique que la création d'un enregistrement a échoué lors de l'exécution de la règle métier Vérifier l'unicité du nom, procédez comme suit :
      1. Renommez le groupe de services sur l'instance source.
      2. Réexportez les services d'application affectés à ce groupe.
      3. Importez le dernier jeu d'importation sur l'instance cible.
    3. Si une erreur indique que la création d'un enregistrement a échoué, car l'ID système existe déjà, procédez comme suit :
      1. Recréez le groupe de services sur l'instance source, en veillant à lui fournir un nom de groupe et un ID système différents.
      2. Réexportez les services d'application affectés à ce groupe.
      3. Importez le dernier jeu d'importation sur l'instance cible.
    4. Vérifiez que le groupe de services s'affiche correctement sur l'instance source.