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

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 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 des 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 (p. ex., les règles métier ou les tâches planifiées) 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 la 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 l'option Mettre à jour avec les changements de la base 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 modifiant la classe d'enregistrement.
    • Tous les attributs de service manuels 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 la CMDB pour connaître les dernières modifications de CI et applique les règles d'impact 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.

    Si vous tentez de traiter plus de CI que la valeur spécifiée dans la propriété sa.service_max_ci_service_population, l'opération échoue.

    Exécutez le processus de conversion en petits blocs (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 instance ServiceNow utilise Domain Separation, la conversion échoue si les CI de plusieurs domaines se trouvent dans le même service. Remplacez ou supprimez les CI pertinents 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 la suivante :

    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 lorsque la conversion réussit, faux lorsque la conversion échoue
    Lorsque la 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");