Convertir les services manuels en services d’application à l’aide de l’API

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 2 minutes de lecture

    • Vous pouvez utiliser une API JavaScript pour convertir des services manuels existants en services d’application. Gestion des événements peut utiliser les services d’application pour surveiller les performances du service et identifier les problèmes d’intégrité.

    Les services manuels ne sont plus pris en charge et ce type de service, ainsi que les services détectés, ont été remplacés par des services d’application. Tous les services manuels existants doivent être convertis en services d’application. Assurez-vous que toute automatisation des services manuels (tels que les règles métier ou les travaux planifiés) a été créée et testée avant la conversion en services d’application.
    Remarque :
    Les services manuels sont statiques et conservent leur structure d’origine après leur conversion en services d’application. Pour mettre à jour les services manuels importés avec l’état CMDB existant, renseignez les services manuels d’origine pour vous assurer que tous les CI sont affectés au service correct ou exécutez la mise à jour avec l’option de changements CMDB après la conversion.
    Pendant le processus de conversion :
    • L’enregistrement de service manuel est déplacé de la table Services manuels [cmdb_ci_service_manual] vers la table Service d’application mappé [cmdb_ci_service_discovered] en changeant la classe d’enregistrement.
    • Tous les attributs de service manuel d’origine, tels que le nom, le propriétaire et l’état opérationnel, sont conservés dans les services d’application.
    • Les éléments de configuration (CI) du service manuel sont conservés dans les services d’application après la conversion.
    • Le système interroge le pour connaître les derniers changements de CI et applique les règles d’impact CMDB de CI.
    Le nombre maximal de connexions de CI ajoutées aux services d'application au cours de cette opération est contrôlé par la propriété sa.service_max_ci_service_population. Par défaut, la valeur est 1 000 (mille connexions). Augmenter le nombre de connexions de CI peut entraîner des problèmes de performance. Pour ajuster le nombre maximal de connexions de CI ajoutées, ajoutez la propriété sa.service_max_ci_service_population, conformément aux instructions de la rubrique Ajouter une propriété système.

    Toute tentative de traitement de CI supérieur à la valeur spécifiée dans la propriété sa.service.max_ci_service_population entraîne l’échec de l’opération.

    Exécutez le processus de conversion par petits blocs d’environ 10 à la fois, afin de faciliter l’identification du service problématique en cas de problème de conversion.

    Les services d’application ne prennent pas en charge ces types de CI :
    • cmdb_ci_endpoint
    • cmdb_ci_translation_rule
    • cmdb_ci_config_file
    • cmdb_ci_qualifier
    • cmdb_ci_application_cluster
    Si les types de CI précédents sont utilisés dans le service manuel que vous souhaitez convertir, la conversion échoue. Les CI de ce type doivent être supprimés avant la conversion. Ils peuvent être remplacés par l’ajout de nouveaux CI aux services d’application après la conversion.

    Si votre ServiceNow instance utilise la séparation de domaine, la conversion échoue si des CI de plusieurs domaines se trouvent dans le même service. Remplacez ou supprimez les CI appropriés avant la conversion. Les services d’application convertis contiennent uniquement des CI affectés au même domaine que les services d’application.

    L’API JavaScript est :

    BusinessServiceManager.migrateManualToApplicationService(String service_id)
    Tableau 1. Paramètres
    Nom Type Description
    service_id Chaîne sys_id du service manuel à convertir
    Tableau 2. Renvoie
    Type Description
    Booléen vrai pour une conversion réussie, faux pour une conversion qui a échoué
    Lorsque le sys_id d’un service manuel existant est 451047c6c0a8016400de0ae6df9b9d76, exécutez l’API suivante pour le convertir en service d’application :
    var bsManager = new SNC.BusinessServiceManager();
var res = bsManager.migrateManualToApplicationService("451047c6c0a8016400de0ae6df9b9d76");