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

Rversion finale: Washingtondc

Mis à jour 1 févr. 2024

10 minutes de lecture

Les règles d'identification permettent d'identifier de façon unique les CI dans la CMDB, dans le cadre du processus d'identification et de rapprochement. Chaque classe CMDB peut être associée à une règle d’identification unique.

Avant de commencer

Rôle requis : itil dispose d’un accès en lecture itil_admin (en plus d’itil) d’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 connexes qui identifient le CI de façon unique.

Passez en revue les éléments suivants avant de créer des règles d’identification :

Procédure

Accédez à la Tous > Configuration > Gestionnaire de classe de CI.
Cliquez sur Hiérarchie pour afficher la liste Classes CI.
Sélectionnez la classe pour laquelle créer une règle d’identification.
Dans la barre de navigation de la classe, développez Informations sur la classe , puis cliquez sur Règle d’identification.

Cliquez sur Modifier pour modifier une règle existante ou cliquez sur Ajouter dans la section Règle d’identification pour en créer une.

Remplissez le formulaire, puis cliquez sur Enregistrer.


Champ	Description
Indépendant/Dépendant(e)	Désignation indiquant si l’identificateur CI peut identifier le CI indépendamment des autres CI, ou non. Remarque : Pour définir la règle comme dépendante, vous devez spécifier des règles de relations dépendantes pour la classe sélectionnée.
Nom	Nom de l'identificateur CI
Description	Description de l'identificateur CI.

Dans la section Entrées d’identificateurs, cliquez sur une entrée d’identificateur existante pour la modifier, ou cliquez sur Ajouter pour en créer une.

Dans la boîte de dialogue Entrée d’identificateur, choisissez une option, puis cliquez sur 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)	Vous 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)	Vous permet de sélectionner des attributs à la fois dans la table actuellement sélectionnée et dans une autre table (entrée d’identificateur hybride).

Option Utiliser les attributs de la table principale <'table' > : définissez les options sur le formulaire, puis cliquez sur Enregistrer.

L’option Rechercher sur la table est prédéfinie pour 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 dont les numéros de priorité sont les plus faibles sont prioritaires. Les entrées d’identificateurs 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	Lorsque cette option est sélectionnée, si au moins un attribut de critère n’est pas null, essayez de correspondre à une entrée d’identificateur, même si certains attributs de critères sont null. Dans le cas contraire, tous les attributs de critères doivent avoir des valeurs pour tenter de correspondre à 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 d’enregistrements qui sera recherché pour un CI correspondant. Disponible uniquement si la propriété système glide.identification_engine.enable_identifier_optional_condition est définie sur vrai (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 en savoir plus sur cette propriété, reportez-vous à Propriétés pour l’identification et la réconciliation.

Remarque :

Si les attributs de critère n’ont que deux attributs et sys_class_name sont 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 l’attribut Null est activée. Cette restriction est due au fait qu’il sys_class_name est considéré comme un attribut spécial de correspondance du système.

Option Utiliser les attributs d’une autre table (table de recherche) :

Définissez l’option Recherche dans la table sur une table autre que la table actuellement sélectionnée dans la liste Classes CI.
La table de recherche doit avoir un champ de référence à cmdb_ci, sinon l’entrée d’identificateur est considérée comme non valide.
Définissez les champs restants comme décrit à l’étape précédente.

Facultatif : Cliquez sur Options avancées et saisissez les informations d’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 d’enregistrements qui sera recherché pour un CI correspondant.
Appliquer la concordance de nombre exacte	Pour l’identification de recherche, faites correspondre un CI uniquement sur la correspondance exacte du nombre d’enregistrements de recherche. Lorsqu’elle est appliquée, tous les éléments de recherche d’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 : 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. S’il existe plusieurs correspondances, sélectionne le CI le plus ancien créé comme correspondance finale. Lorsqu’elle n’est pas appliquée, un élément de recherche pour un CI de la charge utile correspondant à un enregistrement dans la table de recherche est suffisant pour considérer une correspondance : Met en correspondance n’importe quel CI ayant au moins un des éléments de recherche de la charge utile d’entrée faisant référence au CI dans CMDB. 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. S’il existe encore plusieurs correspondances, sélectionne le CI le plus ancien créé comme correspondance finale.

Cliquez sur Enregistrer.

Utilisez les attributs de l’option principale et d’une autre table (hybride) :
1. Définissez les options de l’onglet Paramètres généraux comme décrit dans les étapes précédentes, puis cliquez sur Suivant.
2. Dans l’onglet Paramètres de la table principale , sélectionnez les attributs à utiliser dans la table actuellement sélectionnée, puis cliquez sur Suivant.
  L’option Rechercher sur la table est prédéfinie pour 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 dans 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.
  Vous pouvez cliquer sur Options avancées et saisir 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. Cliquez sur Enregistrer.
Remarque :
L’option Autoriser un attribut Null dans l’option hybride est définie sur faux. Par conséquent, tous les attributs de critères sélectionnés à partir de la table actuellement sélectionnée et de la table de recherche doivent avoir une valeur. En outre, la définition de conditions facultatives n’est disponible que pour la table de recherche et n’est pas disponible pour la table principale.

Facultatif : Dans la section Entrées associées, cliquez sur une entrée associée existante pour la modifier, ou cliquez sur Ajouter pour en créer une.

Mettez à jour le formulaire Entrée associée, puis cliquez sur 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. Cliquez sur l'icône de verrouillage pour afficher, ajouter ou supprimer des attributs 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 :

Exemple

Par exemple, la règle de 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 dans 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 . Il 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 de matériel est appliquée, la table Numéro de série [cmdb_serial_number] est recherchée pour trouver une correspondance avec les valeurs spécifiées dans la clé de recherche . À moins que l’option Appliquer la correspondance de nombre exact (Recherche) 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 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, si vous le souhaitez, créer une règle d’inclusion pour affiner le champ d’application des CI inclus dans l’identification.