Transfert de définition de service d’une instance à une autre

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 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 maintenez deux ServiceNow instances dans votre organisation : pour la production et 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 de base ou un affinage. Une fois que vous avez terminé de mapper les services d’application sur votre instance source, transférez les définitions de service vers l’instance cible (de production).

    Notez que vous ne pouvez pas exporter les services d’application réels, uniquement les définitions de service. Le mappage est un processus dynamique et le résultat du mappage reflète l’infrastructure réelle et sa configuration. Par conséquent, les services que vous avez exportés d’une instance et importés vers une autre peuvent être différents.

    Par défaut, vous exportez les définitions de service suivantes :
    • Nom de service
    • Utilisation de la découverte 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 de définition de service conformément aux règles suivantes :
    • Si aucun ID système de service n’existe 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 est associé à un nom de service différent, 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 le 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 des services manuels. De même, vous ne pouvez pas exporter les 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 aux points d’entrée.
    Figure 1. Exportation du 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é d’ensemble d’importation standard disponible sur le ServiceNow AI Platform. Lorsque vous exportez des définitions de service sur l’instance source, le système crée un fichier JSON contenant les données exportées. Lorsque vous copiez des définitions de service dans l’instance cible, vous importez les données à partir de ce fichier JSON, qui devient un jeu d’importation.

    Exporter des définitions de service

    Créer un jeu d’importation contenant les définitions des services. Vous utilisez ce jeu d’importation pour importer des définitions de service dans une autre instance.

    Avant de commencer

    • Choisissez les définitions de service que vous souhaitez 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 se trouvent sur la même ServiceNow version.
    • 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 en domaines et que vous avez accès au domaine global, sélectionnez le domaine auquel appartient instance de service le 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 et sélectionnez Exporter les services.
      Le jeu d’importation apparaît dans le dossier Téléchargements . Le nom du fichier suit 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 à une autre

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

    Avant de commencer

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

    Procédure

    1. Si l’instance utilise la séparation en domaines et que vous avez accès au domaine global, sélectionnez le domaine auquel appartient instance de service le 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 les 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écouverte des services contenant des points d’entrée importés.

    7. Examinez les services importés ou mis à jour une fois Mappage des services le processus de mappage terminé.
      Si le résultat du transfert ne correspond pas à vos attentes, effectuez le dépannage de base décrit dans le tableau suivant.
    Symptôme Cause Solution
    Les changements que vous avez récemment apportés disparaissent instance de service . Les définitions des services d’application existants sont toujours remplacées pendant le transfert.
    1. Apportez à nouveau les modifications nécessaires aux définitions de cela instance de service .
    2. Exécutez la détection de haut en bas en cliquant sur Exécuter la découverte dans la carte de instance de service 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 empêchait le système d’importer l’appartenance instance de service à ce groupe.
    2. Importez à nouveau le jeu d’importation.
    3. Vérifiez que le groupe de services s’affiche.
    Un groupe de services importé semble avoir des services d’application incorrects qui lui sont affectés. Il s’agit d’un groupe de services différent portant le même nom, et non le groupe de services que vous avez importé. Le système a échoué dans l’importation du groupe de services, car l’instance source a déjà un groupe de services portant le même nom ou le même nom et le même ID système.
    1. Vérifiez le journal d’importation.
    2. Si une erreur indique qu’une création d’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éexporter les services d’application affectés à ce groupe.
      3. Importez le dernier jeu d’importation sur l’instance cible.
    3. Si une erreur indique qu’une création d’enregistrement a échoué parce que 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éexporter 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.