Utilisation de la simulation d’identification

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 7 minutes de lecture
  • La simulation d’identification est un emplacement central pour construire automatiquement une charge utile dont la garantie est complète et valide. Vous pouvez ensuite simuler le traitement de la charge utile par le moteur d’identification et de rapprochement (IRE) et examiner les résultats avant de la soumettre pour exécution par IRE.

    Utilisez la simulation d’identification pour construire une charge utile d’entrée et simulez le traitement de la charge utile par IRE. Vous pouvez ensuite examiner les résultats, ajuster les règles d’identification si nécessaire et réexécuter la simulation de la charge utile mise à jour.

    Utilisez la simulation d’identification pour :
    • Construire automatiquement la charge utile d’entrée en fonction des règles d’identification, d’hébergement et d’imbrication existantes.
    • Simulez l’exécution d’une charge utile (construite automatiquement par simulation d’identification ou créée manuellement).
    • Parcourez la sortie de la charge utile et les messages du journal d’exécution pour une exécution simulée.
    Remarque :
    • La simulation d’identification n’engage aucune mise à jour de la CMDB.
    • La simulation d’identification prend en charge la simulation du traitement des charges utiles fournies qui contiennent des tables non CMDB, mais ne prend pas en charge la génération de telles charges utiles.

    Générer automatiquement la charge utile

    Utilisez la simulation d’identification pour construire automatiquement une charge utile d’entrée pour une classe spécifiée. La charge utile construite est complète avec tous les CI dépendants requis, correctement structurée et syntaxiquement valide pour le traitement par le moteur d’identification et de rapprochement (IRE).

    Avant de commencer

    Rôle requis : sn_cmdb_admin ou admin

    Pourquoi et quand exécuter cette tâche

    La charge utile construite lors de la simulation d’identification correspond à la classe spécifiée. Pour une classe CI dépendante, vous serez invité à fournir des informations sur toutes les dépendances. Une fois que vous avez fourni les détails requis, la simulation d’identification construit la charge utile en fonction de votre entrée.

    Remarque :
    La génération automatique de charges utiles contenant des tables non CMDB n’est pas prise en charge.

    Procédure

    1. Accédez à la Tous > Configuration > Identification/rapprochement, puis cliquez sur Simulation d’identification.
    2. Dans la zone Démarrer avec la classe CI , cliquez sur Démarrer.
    3. Dans le formulaire Informations sur la charge utile , dans le champ Source de données , sélectionnez la source de données associée à cette mise à jour de classe.
      Pour la source de données Découverte ServiceNow, sélectionnez ServiceNow.
    4. Sélectionnez la classe dans la charge utile.
      1. Dans la zone Attributs de critère , sélectionnez les attributs d’identificateur de CI, puis spécifiez les valeurs qui identifient un CI de façon unique.
      2. Dans la zone Attributs supplémentaires , spécifiez les attributs et les valeurs avec lesquels les CI correspondants seront mis à jour.
    5. Pour les CI dépendants associés à des règles d’identification dépendantes, remplissez les sections Attributs de critère et Attributs supplémentaires dans toutes les sections de niveau de conteneur qui s’affichent.
    6. Cliquez sur Générer le script.
    7. Si des erreurs indiquent qu’il manque des champs, renseignez-les, puis cliquez à nouveau sur Générer le script .

    Que faire ensuite

    • Cliquez sur Exécuter la simulation pour simuler le traitement de la charge utile par IRE.
    • Examinez les résultats de la simulation, affinez la charge utile selon vos besoins et combinez-les avec d’autres charges utiles pour d’autres classes si vous le souhaitez. Après avoir finalisé la charge utile, utilisez l’API createOrUpdateCI() pour exécuter la charge utile par IRE, ce qui entraînera des mises à jour réelles de la CMDB.
    • Cliquez sur Copier le script pour copier le script JSON dans le presse-papiers. Vous pouvez ensuite coller ce script dans un logiciel tiers ou sur un autre écran de la simulation d’identification.

    Simuler le traitement de la charge utile à l’aide de la simulation d’identification

    Utilisez la simulation d’identification pour simuler le processus du moteur d’identification et de rapprochement (IRE) d’identification des CI pour une charge utile d’entrée. Fournissez une charge utile valide, qui a été construite à l’aide de la simulation d’identification ou qui a été créée manuellement.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Accédez à la Tous > Configuration > Identification/rapprochement, puis cliquez sur Simulation d’identification.
    2. Facultatif : Pour exécuter une simulation d’une charge utile existante :
      1. Cliquez sur Démarrer dans la vignette Démarrer avec une charge utile existante .
      2. Sur la page Insérer une charge utile JSON, sélectionnez la source de données associée à cette mise à jour de classe.
      3. Facultatif : Sélectionnez Utiliser l’identification améliorée pour appliquer l’API identifyCIEnenhanced pour une identification améliorée des CI, au lieu d’utiliser l’API identifyCI.
      4. Collez la charge utile JSON dans le canevas vide.
    3. Facultatif : Pour construire une nouvelle charge utile, cliquez sur Démarrer dans la vignette Démarrer avec la classe CI .
      Consultez Générer automatiquement la charge utile pour plus d'informations.
    4. Cliquez sur Exécuter la simulation pour simuler le traitement de la charge utile par IRE.

    Que faire ensuite

    1. Examinez les résultats de la simulation dans le volet des résultats et affinez la charge utile si nécessaire :
      1. Cliquez sur Exécution #1 pour afficher l’ID de contexte et l’ID d’exécution de l’exécution simulée.
      2. Cliquez sur la flèche déroulante à côté de Exécution #1 pour afficher des détails supplémentaires.
        • Entrée : affiche la charge utile de la simulation.
        • Journaux : affiche tous les messages journalisés générés par IRE lors de la simulation du traitement de la charge utile, en fonction du niveau de journalisation spécifié.
        • Sortie : affiche la charge utile de sortie renvoyée par IRE.
    2. Après avoir finalisé la charge utile, utilisez l’API createOrUpdateCI() pour exécuter la charge utile par IRE, ce qui entraînera des mises à jour réelles de la CMDB.

    Définir le niveau de journalisation pour la simulation d’identification

    La simulation d’identification consigne chaque étape d’un traitement de charge utile simulée. Vous pouvez ensuite examiner ces journaux d’exécution pour déterminer si une charge utile a été traitée comme prévu et si les règles d’identification sont efficaces. Vous pouvez ajuster le niveau de journalisation pour qu’il soit utile et que le nombre de messages ne soit pas excessif ou insuffisant.

    Avant de commencer

    Rôle requis : sn_cmdb_admin ou admin

    Procédure

    1. Accédez à la Tous > Configuration > Identification/rapprochement, puis cliquez sur Simulation d’identification.
    2. Cliquez sur l’icône Paramètres .
    3. Sélectionnez le niveau de journalisation pour le moteur d’identification et de rapprochement (IRE) sous Niveau de connexion IE et pour le cache de service sous Niveau de connexion du cache de service.
      Les niveaux de journalisation sont affichés par ordre croissant, du niveau minimum au niveau maximum de journalisation.
    4. Cliquez à nouveau sur l’icône Paramètres pour fermer la boîte de dialogue Paramètres .

    Examiner les journaux d’exécution

    La simulation d’identification fournit des journaux d’exécution qui sont générés par le moteur IRE (Identification and Reconciliation Engine). Vous pouvez accéder à ces journaux d’exécution pour les exécutions de charge utile, pour examiner les résultats et à des fins de débogage. Les journaux de sortie de la charge utile IRE s’affichent dans un format convivial sur une page centrale.

    Avant de commencer

    Rôle requis : sn_cmdb_admin ou admin

    Pourquoi et quand exécuter cette tâche

    En outre, les applications internes qui utilisent IRE (telles que Découverte) peuvent appeler une API interne pour fournir une URL permettant d’afficher les journaux d’exécution IRE.

    La journalisation s’effectue dans le contexte d’une exécution spécifique du moteur d’identification. Vous pouvez filtrer la liste des journaux en fonction d’une source de données et d’une plage horaire spécifiques. Jusqu’à 1 000 journaux d’exécution datant de moins de 2 mois sont répertoriés, regroupés par ID de contexte et heures d’exécution. Vous pouvez utiliser la propriété glide.identification_logs.max_run_ids pour modifier la limite de 1 000.

    Vous pouvez contrôler le niveau de journalisation à l’aide de la glide.discovery.identification.log_level propriété système Discovery (Découverte) et en définissant la valeur sur l’une des valeurs suivantes :
    • Info
    • Avertir
    • Erreur
    • Debug
    • DebugVerbose
    • DébogageOdieux
    Remarque :
    IRE effectue une vérification initiale d’une charge utile avant de traiter les règles d’identification. Si IRE détecte des CI en double en fonction des identificateurs de classe, la charge utile est rejetée et le traitement s’arrête.

    Procédure

    1. Accédez à la Tous > Configuration > Identification/rapprochement > Journaux d’identification.
    2. Filtrez la liste des exécutions comme suit :
      1. Source : sélectionnez la source de données pour laquelle afficher les journaux d’exécution.
      2. Plage horaire : spécifiez une plage horaire pour laquelle afficher les journaux d’exécution.
      La liste Exécutions affiche toutes les exécutions pour la source de données spécifiée, au cours de la plage horaire spécifiée.
    3. Dans la liste Exécutions , cliquez sur un # d’exécution pour afficher son ID de contexte et son ID d’exécution.
      Un ID de contexte unique est associé à chaque charge utile exécutée. Chaque exécution de cette charge utile est associée à un ID d’exécution unique. Un ID de contexte unique pour une charge utile exécutée plusieurs fois est associé à plusieurs ID d’exécution.
    4. Cliquez sur la flèche déroulante d’une exécution # pour afficher des détails supplémentaires.
      • Entrée : affiche la charge utile de l’exécution.
      • Journaux : affiche tous les messages consignés par le moteur d’identification lors de l’exécution de la charge utile, en fonction du niveau de journalisation spécifié.
      • Sortie : affiche la charge utile de sortie renvoyée par le moteur d’identification.