Créer une règle d’identification de CI

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 11 minutes de lecture
  • Les règles d’identification permettent d’identifier de façon unique les CI dans la CMDB, dans le cadre des processus d’identification et de rapprochement (IRE). Chaque classe CMDB peut être associée à une règle d’identification unique.

    Avant de commencer

    Rôle requis : itil a un accès en lecture, itil_admin (en plus d’itil) a un accès complet.

    Pourquoi et quand exécuter cette tâche

    Dans une règle d’identification de CI, spécifiez un identificateur de CI, ainsi que des entrées d’identificateur et des entrées associées qui identifient le CI de façon unique.

    Vérifiez les points suivants avant de créer des règles d’identification :
    • Règles d'identification
    • Directives générales pour l’utilisation de l’identification CMDB
    • Explorez les règles d’identification prédéfinies :
      1. Accédez à la Tout > Gestionnaire de classe de CI.
      2. Sélectionnez Hiérarchie , puis recherchez et sélectionnez, par exemple, la classe Matériel.
      3. Dans la barre Hardware, développez Class Info (Informations de classe) et sélectionnez Identification Rule (Règle d’identification).
      4. Examinez toutes les sections et tuiles avec les paramètres de la règle d’identification de classe de matériel.

    Procédure

    1. Accédez à la Tout > Configuration > Gestionnaire de classe de CI.
    2. Sélectionnez Hiérarchie pour afficher la liste des classes CI, puis sélectionnez la classe pour laquelle créer une règle d’identification.
    3. Dans la barre de navigation de la classe, développez Informations sur la classe , puis sélectionnez Règle d’identification.
    4. Sélectionnez Modifier pour modifier une règle existante ou Ajouter dans la section Règle d’identification pour en créer une.
    5. Remplissez le formulaire, puis sélectionnez Enregistrer.
      Champ Description
      Indépendant/Dépendant Désignation indiquant si l’identificateur CI peut identifier ou non le CI indépendamment des autres CI.
      Remarque :
      Pour définir la règle comme dépendante, vous devez spécifier des règles de relation dépendante pour la classe sélectionnée.
      Nom Nom de l'identificateur CI
      Description Description de l'identificateur CI.
    6. Dans la section Entrées d’identificateurs, sélectionnez une entrée d’identificateur existante à modifier ou sélectionnez Ajouter pour en créer une.
    7. Dans la boîte de dialogue Entrée d’identificateur, choisissez une option, puis sélectionnez Suivant.
      Continuez avec l’une des trois étapes suivantes en fonction de l’option que vous avez sélectionnée :
      Option Description
      Utiliser les attributs de la table principale <table> Permet de sélectionner des attributs à partir de la table actuellement sélectionnée (entrée d’identificateur standard).
      Utiliser des attributs d'une autre table (table de recherche) Permet de sélectionner des attributs à partir de n’importe quelle table connexe, autre que la table actuellement sélectionnée (entrée d’identificateur de recherche).
      Utiliser les attributs provenant de la table principale et d'une autre (hybride) Permet de sélectionner des attributs à partir de la table actuellement sélectionnée et d’une autre table (entrée d’identificateur hybride).
    8. Utiliser les attributs de la table principale < option « table » > : définissez les options sur le formulaire, puis sélectionnez Enregistrer.

      L’option Rechercher sur la table est prédéfinie sur la table actuellement sélectionnée dans la liste Classes CI.

      Champ Description
      Active Cochez la case qui indique que l'entrée d'identificateur est active. Au moins une entrée d’identificateur dans une règle d’identification doit être active pour que la règle s’applique.
      Priorité Priorité de l’entrée d’identificateur. Les entrées d’identificateur sont appliquées en fonction de leur priorité. Les règles avec des numéros de priorité inférieurs ont la priorité. Les entrées d’identificateur de propriétés identiques sont appliquées de manière aléatoire.

      Vous pouvez conserver des écarts entre les numéros de priorité afin de pouvoir affecter les numéros de priorité non utilisés aux nouvelles entrées sans modifier l'ordre de priorité existant.

      Attributs de critères Ensemble d’attributs qui identifient le CI de façon unique. Les attributs peuvent appartenir à la classe actuelle ou à une classe parent.
      Remarque :
      Il est possible d'ajouter des champs de référence comme attribut de critère. Toutefois, ces champs ne sont pas toujours efficaces :
      • Les champs de référence stockent les sys_id qui pointent sur un enregistrement dans une autre table et sont donc considérés comme un attribut de critère faible (en matière d'unicité) pour la table actuelle.
      • Le système détecte et remplace ensuite les valeurs non valides dans un champ de référence par « Inconnu ». Par exemple, une valeur Model ID non valide est remplacée par la valeur « Inconnu ». En outre, si plusieurs CI terminent par avoir ce même champ de référence défini sur « Inconnu », ils deviennent des duplications de CI.
      Autoriser un attribut Null

      Quand cette option est sélectionnée, si au moins un attribut de critère n’est pas nul, essayez d’établir une correspondance avec une entrée d’identificateur, même si certains attributs de critère sont nuls.

      Dans le cas contraire, tous les attributs de critères doivent avoir des valeurs pour tenter de les mettre en correspondance avec une entrée d’identificateur.

      Autoriser le retour aux règles du parent Permet d’utiliser les règles d’identification du parent du CI si aucune correspondance n’est trouvée pour cette règle d’identification. S’applique uniquement aux règles d’identification dépendantes.

      Options avancées

      Filtre pour réduire l’ensemble des enregistrements dans lequel l’objet de la recherche d’un CI correspondant.

      Disponible uniquement si la propriété système glide.identification_engine.enable_identifier_optional_condition est définie sur true (false par défaut). Dans le système de base, les entrées d’identificateurs de différentes classes sont préconfigurées avec des conditions d’options avancées. Toutes ces conditions préconfigurées dans les entrées d’identificateur standard s’appliqueront automatiquement lorsque vous réglerez cette propriété sur vrai. Par conséquent, pour éviter tout comportement inattendu, passez en revue ces conditions prédéfinies dans les entrées d’identificateur standard avant de définir cette propriété sur vrai.

      Pour plus d’informations sur cette propriété, reportez-vous à la rubrique Propriétés pour l’identification et le rapprochement.

      Remarque :
      Si les attributs de critère n’ont que deux attributs et sys_class_name est l’un d’eux (par exemple [name, sys_class_name], [ip_address, sys_class_name]), l’autre attribut ne peut pas être NULL, même si l’option Autoriser un attribut Null est activée. Cette restriction est due au fait qu’il sys_class_name s’agit d’un attribut spécial de correspondance du système.
    9. Option Utiliser les attributs d’une autre table (table de recherche) :
      1. Définissez Rechercher sur la table sur une table autre que la table actuellement sélectionnée dans la liste Classes CI.
        La recherche sur la table doit avoir un champ de référence à cmdb_ci, sinon l’entrée d’identificateur est considérée comme non valide.
      2. Définissez les autres champs comme décrit à l’étape précédente.
      3. Facultatif : Sélectionnez Options avancées et entrez les informations pour un identificateur de recherche (faites défiler vers le bas si nécessaire).
        Option avancée Description
        Toutes ces conditions doivent être remplies Filtre pour réduire l’ensemble des enregistrements dans lequel l’objet de la recherche d’un CI correspondant.
        Appliquer la concordance de nombre exacte Pour l’identification de recherche, faites correspondre un CI uniquement sur la concordance exacte du nombre d’enregistrements de recherche.
        Lorsqu’elle est appliquée, tous les éléments de recherche pour un CI dans la charge utile doivent avoir des enregistrements correspondants dans la table de recherche, qui font référence au même CI :
        1. Correspond uniquement aux CI qui ont tous les éléments de recherche de la charge utile d’entrée faisant référence au CI dans CMDB.
        2. S’il existe plusieurs correspondances, sélectionne le CI le plus ancien comme correspondance finale.
        Lorsqu’il n’est pas appliqué, un élément de recherche pour un CI dans la charge utile correspondant à un enregistrement dans la table de recherche est suffisant pour considérer une correspondance :
        1. Correspond à tout CI qui possède au moins un des éléments de recherche de la charge utile de l’entrée faisant référence au CI dans la CMDB.
        2. S’il existe plusieurs correspondances, sélectionne les CI avec le nombre maximal d’éléments de recherche dans la charge utile d’entrée faisant référence au CI dans CMDB.
        3. S’il existe encore plusieurs correspondances, sélectionne le CI le plus ancien comme correspondance finale.
      4. Sélectionnez Enregistrer.
    10. Utilisez les attributs de la table principale et d’une autre option (hybride) :
      1. Définissez les options de l’onglet Paramètres généraux comme décrit dans les étapes précédentes, puis sélectionnez Suivant.
      2. Dans l’onglet Paramètres de la table principale , sélectionnez les attributs à utiliser dans la table actuellement sélectionnée, puis sélectionnez Suivant.
        L’option Rechercher sur la table est prédéfinie sur la table actuellement sélectionnée dans la liste Classes CI.
      3. Dans l’onglet Paramètres de la table de recherche , sélectionnez une recherche sur la table , puis dans Attributs de critères , sélectionnez les attributs de la table spécifiée. La recherche sur la table doit comporter un champ de référence vers cmdb_ci, sinon l’entrée d’identificateur est considérée comme non valide.
        Vous pouvez sélectionner Options avancées et entrer les informations d’un identificateur de recherche comme décrit à l’étape précédente (faites défiler vers le bas si nécessaire).
      4. Sélectionnez Enregistrer.
      Remarque :
      L’option Autoriser un attribut Null de l’option hybride est définie sur faux. Par conséquent, tous les attributs de critères sélectionnés de la table actuellement sélectionnée et de la table de recherche doivent avoir une valeur. De plus, la définition de conditions facultatives n’est disponible que pour la table de recherche et n’est pas disponible pour la table principale.
    11. Facultatif : Dans la section Entrées associées, sélectionnez une entrée associée existante à modifier ou sélectionnez Ajouter pour en créer une.
      1. Mettez à jour le formulaire Entrée associée, puis sélectionnez Enregistrer.
        Tableau 1. Formulaire Entrée associée
        Champ Description
        Actif Case à cocher qui spécifie que l'entrée connexe est active.
        Table connexe Une table associée qui fait référence au CI correspondant.
        Champ Référencé Champ référencé dans la table connexe qui doit stocker le CI référencé. Ce champ fait toujours référence à la table cmdb_ci, ou à un descendant de la table cmdb_ci.
        Priorité Priorité de l'entrée connexe pour la table connexe spécifiée. Les règles dont les numéros de priorité sont les plus faibles sont prioritaires lors de la correspondance d'un élément connexe pour une table connexe spécifique. Les entrées connexes pour la table connexe spécifiée avec des priorités identiques sont appliquées de manière aléatoire.

        Vous pouvez conserver des écarts entre les numéros de priorité afin de pouvoir affecter les numéros de priorité non utilisés aux nouvelles entrées sans modifier l'ordre de priorité existant.

        Attributs de critères Ensemble d'attributs permettant d'identifier de façon unique l'élément connexe. Les attributs peuvent appartenir à la classe actuelle ou à une classe parent.
        Remarque :
        Il est possible d'ajouter des champs de référence comme attribut de critère. Toutefois, ces champs ne sont pas toujours efficaces :
        • Les champs de référence stockent les sys_id qui pointent sur un enregistrement dans une autre table et sont donc considérés comme un attribut de critère faible (en matière d'unicité) pour la table actuelle.
        • Le système détecte et remplace ensuite les valeurs non valides dans un champ de référence par « Inconnu ». Par exemple, une valeur Model ID non valide est remplacée par la valeur « Inconnu ». En outre, si plusieurs CI terminent par avoir ce même champ de référence défini sur « Inconnu », ils deviennent des duplications de CI.

        Sélectionnez l’icône de verrouillage pour afficher, ajouter ou supprimer des attributs à partir de la règle d’identification.

        Autoriser un attribut Null Si au moins un attribut de critère dans la table connexe n'est pas null, autorisez-le à tenter de correspondre à une entrée d'identificateur, même si des attributs de critères sont null
        Conditions de filtre Ajoutez des conditions afin de créer un filtre et réduire l'ensemble d'enregistrements qui seront recherchés pour un élément connexe correspondant.
        Remarque :
        Si les attributs de critère n’ont que deux attributs et sys_class_name est l’un d’eux (par exemple [name, sys_class_name], [ip_address, sys_class_name]), l’autre attribut ne peut pas être NULL, même si l’option Autoriser un attribut Null est activée. Cette restriction est due au fait qu’il sys_class_name s’agit d’un attribut spécial de correspondance du système.

    Exemple

    Par exemple, la règle Matériel prédéfinie s’applique à la table Matériel [cmdb_ci_hardware]. Il possède une entrée d’identificateur avec l’attribut de critère Numéro de série, Type de numéro de série et son champ Rechercher sur la table est défini sur Numéro de série.

    L’extrait de charge utile suivant ajoute un CI à la cmdb_ci_linux_server classe, c’est-à-dire un enfant de la classe Hardware . Elle montre également comment vous pouvez ajouter des éléments connexes dans la charge utile pour laquelle vous devez créer des entrées connexes sur la page Identificateur de CI pour la table Matériel [cmdb_ci_hardware] :

    
    {
        "items": [
            {
                "className": "cmdb_ci_linux_server",
                "lookup": [
                    {
                        "className": "cmdb_serial_number",
                        "values": {
                            "serial_number": "VMware-42 21 e3 da 44 14 5a a6-56 48 2b 0a 28 53 42 4c",
                            "serial_number_type": "system",
                            "valid": "true"
                        }
                    },
                    {
                        "className": "cmdb_serial_number",
                        "values": {
                            "serial_number": "4221E3DA-4414-5AA6-5648-2B0A2853424C",
                            "serial_number_type": "uuid",
                            "valid": "true"
                        }
                    },                }
                ],
    
        “related": [
                    {
                        "className": "cmdb_ci_ucs_chassis",
                        "values": {
                            “name": “chassis1",
                            “category": “category1",
                            “short_description": “My Chassis 1"
                        }
                    },
                    {
                        "className": "cmdb_ci_ucs_chassis",
                        "values": {
                            “name": "chassis2",
                            "category": "category2",
                            "short_description": "My Chassis 2"
                        }
                    },    }
         ],
    
                "values": {
                    ......
                    "name": "xpolog2.lab3",
                    "os_name": "Linux",
                    "output": "Linux xpolog2.lab3 2.6.32-431.el6.x86_64 #1 SMP Fri Nov 22 03:15:09 UTC 2013 x86_64 x86_64 x86_64 GNU/Linux",
                    "serial_number": "VMware-42 21 e3 da 44 14 5a a6-56 48 2b 0a 28 53 42 4c",
                    "sys_class_name": "cmdb_ci_linux_server"
                }
            }
        ]
    }
                             

    Lorsque la règle matérielle est appliquée, une correspondance avec les valeurs spécifiées dans la clé de recherche est recherchée dans la table Numéro de série [cmdb_serial_number]. À moins que l’option Appliquer la concordance de nombre exacte (Rechercher) ne soit cochée, il n’est pas nécessaire que chaque clé de recherche renvoie une correspondance, tant qu’il existe au moins une correspondance. Si toutes les correspondances font référence au même CI, ce CI est considéré comme l’enregistrement de CI existant. Si aucune correspondance n’est trouvée, la recherche d’identification se poursuit jusqu’à l’entrée de règle suivante. Si, après tout, toutes les règles sont épuisées sans qu’aucune correspondance ne soit trouvée, un nouvel enregistrement de CI est créé dans la base de données.

    Que faire ensuite

    Vous pouvez éventuellement créer une règle d’inclusion pour limiter le champ d’application des CI qui sont inclus dans l’identification.