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

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 7 minutes de lecture

    • 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 les enregistrements de table de façon unique. Chaque table non 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) dispose d’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 de 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 :
    Lors de la création d’entrées d’identificateur, vous pouvez configurer les champs Rechercher sur la table et Attributs de critère du 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
    Vous 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
    Vous permet de sélectionner des attributs à partir de la table sélectionnée principale et d’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 Tous > Identification/Réconciliation > Identificateurs CI.
    2. Dans la vue de liste Identificateurs, cliquez sur Nouveau.
    3. Remplissez le formulaire Identificateur.
      Champ Description
      Nom Nom de l'identificateur CI
      Concerne Table non CMDB prise en charge.
      Indépendant Doit être coché 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 Identificateur, sélectionnez l’onglet Entrées d’identificateur , puis cliquez sur Nouveau.
    7. Remplissez le formulaire d’entrée d’identificateur.
      Champ Description
      Identificateur Préréglage avec le nom de la table de l’identificateur associé.
      Rechercher sur la table

      Préréglage avec l’étiquette de la table de l’identificateur associé.

      Pour créer :
      • Entrée d’identificateur standard : définissez la table des identificateurs et sélectionnez les attributs de critère dans cette même table.
      • Une entrée d’identificateur de recherche : sélectionnez une autre table (table de recherche) et sélectionnez les attributs de critères dans cette table de recherche.
      • Entrée d’identificateur hybride : sélectionnez une autre table (table de recherche), puis procédez comme suit.
        • Sélectionnez des attributs de critères dans la table de recherche.
        • Ajoutez des attributs de critères CI d’entrée hybride à partir de la table actuelle à l’aide de scripts en arrière-plan, après avoir enregistré la règle. Pour en savoir plus, 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 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.
      Priorité Priorité d’application de l’entrée d’identificateur. 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.
      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 par recherche, faites correspondre un enregistrement uniquement sur la correspondance exacte du nombre d’enregistrements de recherche.
      Lorsqu’elle est appliquée, tous les éléments de recherche d’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 :
      1. Correspond uniquement aux enregistrements qui ont tous les éléments de recherche de la charge utile d’entrée faisant référence à l’enregistrement dans la table.
      2. S’il existe plusieurs correspondances, sélectionne l’enregistrement créé le plus ancien comme correspondance finale.
      Lorsqu’elle n’est pas appliquée, un élément de recherche pour un enregistrement de la charge utile correspondant à un enregistrement dans la table de recherche est suffisant pour considérer une correspondance :
      1. Correspond à tout enregistrement qui a au moins un des éléments de recherche de la charge utile d’entrée faisant référence à l’enregistrement dans la table.
      2. S’il existe plusieurs correspondances, sélectionne les enregistrements avec le nombre maximal d’éléments de recherche dans la charge utile d’entrée faisant référence à l’enregistrement dans la table.
      3. S’il existe encore plusieurs correspondances, sélectionne l’enregistrement créé le plus ancien comme correspondance finale.
      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 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

      Un filtre pour réduire l’ensemble d’enregistrements qui sera recherché pour un enregistrement 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 un 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.
    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 Table connexe (table de recherche) qui fait référence à l’enregistrement correspondant.
      Champ référencé Champ référencé dans 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 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.
      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.
      Condition facultative Conditions de filtre pour réduire l’ensemble des enregistrements qui seront recherchés pour un élément connexe correspondant.
    11. Cliquez sur Envoyer.

    Que faire ensuite

    Pour ajouter des attributs de critère à un champ Attributs de critères CI d’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 du système > Scripts - Arrière-plan, puis entrez un script qui ajoute les attributs et 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 le rôle administrateur.