Créer une règle d’identification pour une table non CMDB

Pour utiliser les fonctionnalités du moteur Identification et réconciliation (IRE) avec des tables non CMDB prises en charge, vous devez d’abord créer des règles d’identification qui identifient de façon unique les enregistrements de table. Chaque table non-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

Chaque règle d’identification se compose d’un identificateur unique pour la table, d’une ou plusieurs entrées d’identificateur et d’une ou plusieurs entrées connexes.

Passez en revue les rubriques suivantes avant de créer des règles d’identification :

• Règles d'identification
• Directives générales pour l’utilisation de l’identification CMDB

Lors de la création d’entrées d’identificateurs, vous pouvez configurer les champs Rechercher sur la table et Attributs de critères sur le formulaire Entrée d’identificateur pour implémenter l’une des options suivantes :

Entrée d’identificateur classique

Permet de sélectionner des attributs à partir de la table d’identificateurs associée.

Rechercher une entrée d’identificateur

Permet de sélectionner des attributs à partir de n’importe quelle table connexe (table de recherche), autre que la table actuellement sélectionnée.

Entrée d’identificateur hybride

Permet de sélectionner des attributs à la fois dans la table principale sélectionnée et dans une autre table (table de recherche).

Pour les tables non CMDB, seules les règles d’identification indépendantes sont prises en charge.

Procédure

1. Accédez à la Tout > Identification/Rapprochement > Identificateurs CI.
2. Dans la vue de liste Identificateurs, cliquez sur Nouveau.
3. Renseignez le formulaire Identificateur.

   Champ	Description
   Nom	Nom de l'identificateur CI
   Concerne	Table non CMDB prise en charge.
   Indépendant	Doit être activé pour indiquer que l’identificateur peut identifier un enregistrement indépendamment des autres enregistrements.

4. Cliquez sur Envoyer.
5. Dans la vue de liste Identificateurs, localisez et ouvrez l’identificateur que vous venez de créer.
6. Dans le formulaire d’identificateur, sélectionnez l’onglet Entrées d’identificateurs , puis cliquez sur Nouveau.
7. Remplissez le formulaire Entrée d’identificateur.

   Champ	Description
   Identificateur	Paramètre prédéfini avec le nom de la table de l’identificateur associé.
   Rechercher sur la table	Paramètre prédéfini avec l’étiquette de la table de l’identificateur associé. Pour créer : Une entrée d’identificateur standard : définissez la table d’identificateurs et sélectionnez les attributs de critère dans cette même table. Une entrée d’identificateur de recherche : définissez sur une autre table (table de recherche) et sélectionnez des attributs de critère dans cette table de recherche. Une entrée d’identificateur hybride : définissez sur une autre table (table de recherche), puis procédez comme suit. Sélectionnez les attributs de critères dans la table de recherche. Ajoutez des attributs de critères CI de l’entrée hybride à partir de la table actuelle à l’aide de scripts en arrière-plan, après avoir enregistré la règle. Pour plus de détails, reportez-vous à la section « Étapes suivantes » à la fin de cette tâche. Une table de recherche doit avoir une référence à la table d’identificateurs associée.
   Attributs de critères	Ensemble d’attributs qui identifient l’enregistrement 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 en tant qu’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.
   Priorité	Priorité d’application de l’entrée d’identificateur. 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.
   Actif	Spécifie si 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.
   Appliquer la concordance de nombre exacte	Pour l’identification de recherche, faites correspondre un enregistrement uniquement sur la concordance exacte du nombre d’enregistrements de recherche. Lorsqu’elle est appliquée, tous les éléments de recherche pour un enregistrement dans la charge utile doivent avoir des enregistrements correspondants dans la table de recherche qui font référence au même enregistrement : Met uniquement en correspondance les enregistrements qui ont tous les éléments de recherche de la charge utile de l’entrée faisant référence à l’enregistrement dans la table. S’il existe plusieurs correspondances, sélectionne l’enregistrement le plus ancien comme correspondance finale. Lorsqu’il n’est pas appliqué, un élément de recherche pour un enregistrement dans la charge utile correspondant à un enregistrement dans la table de recherche est suffisant pour considérer une correspondance : Met en correspondance tout enregistrement qui possède au moins un des éléments de recherche de la charge utile de l’entrée faisant référence à l’enregistrement dans la table. S’il existe plusieurs correspondances, sélectionne les enregistrements avec le nombre maximal d’éléments de recherche de la charge utile de l’entrée faisant référence à l’enregistrement dans la table. S’il existe encore plusieurs correspondances, sélectionne l’enregistrement le plus ancien comme correspondance finale.
   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 des 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 de la table parente de l’enregistrement si aucune correspondance n’est trouvée pour cette règle d’identification. S’applique uniquement aux règles d’identification dépendantes.
   Condition facultative	Filtre pour réduire l’ensemble des enregistrements dans lequel l’objet de la recherche d’un enregistrement 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.
8. Cliquez sur Envoyer.
9. Dans le formulaire Identificateur, sélectionnez l’onglet Entrées connexes , puis cliquez sur Nouveau.
10. Remplissez le formulaire Entrée associée.

    Tableau 1. Formulaire Entrée associée

    Champ	Description
    Identificateur	Paramètre prédéfini avec l’identificateur auquel cette entrée associée est associée.
    Actif	Case à cocher qui spécifie que l'entrée connexe est active.
    Table connexe	Une table connexe (table de recherche) qui fait référence à l’enregistrement correspondant.
    Champ référencé	Un champ référencé dans la table connexe avec une référence à la table d’identificateurs associée.
    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 en tant qu’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 associée n’est pas nul, autorisez la tentative de correspondance avec une entrée d’identificateur même si des attributs de critère sont nuls.
    Priorité	Priorité de l'entrée connexe pour la table connexe spécifiée. Les règles contenant des numéros de priorité inférieurs ont la priorité et correspondent à un élément connexe d’une table associée 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.
    Condition facultative	Conditions de filtre pour réduire l’ensemble des enregistrements dans lequel l’élément associé correspondant sera recherché.

11. Cliquez sur Envoyer.

Que faire ensuite

Pour ajouter des attributs de critères à un champ Attributs de critères CI de l’entrée hybride dans une entrée d’identificateur hybride, au lieu d’utiliser le formulaire Entrée d’identificateur, vous devez utiliser des scripts en arrière-plan. Après avoir enregistré la règle d’identification, accédez à Définitions système > Scripts - Arrière-plan, puis entrez un script qui ajoute les attributs, puis cliquez sur Exécuter le script.

Exemple de script :

var gr = new GlideRecord('cmdb_identifier_entry');
// get the identifier entry you want to update
gr.get('<identifier_entry_sys_id>');
// set the attributes you want in the hybrid rule in a comma separated list
// for example: 'name,serial_number'
gr. hybrid_entry_ci_criterion_attributes='<column_name_1>,<column_name_2>,<etc.>';
gr.update();

Ce processus nécessite un rôle administrateur.