Créer une requête CMDB à l’aide du générateur de requêtes CMDB

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 8 minutes de lecture

    • Type de requête CMDB qui interroge l’infrastructure pour les classes CI et, éventuellement, les tables non CMDB, ainsi que les relations et références qui les relient.

    Avant de commencer

    Rôle requis : cmdb_query_builder_read pour afficher et exécuter uniquement les requêtes enregistrées, et cmdb_query_builder (contenu pour itil, itil_admin et asset) pour créer et enregistrer des requêtes, modifier les requêtes enregistrées et exécuter des requêtes. Pour générer des rapports sur les requêtes, les ACL associées au rapport sont requises.

    Les utilisateurs autorisés peuvent mettre à jour et supprimer une requête créée par un autre utilisateur.

    Pourquoi et quand exécuter cette tâche

    Créez la requête en faisant glisser les classes CI et les tables non-CMDB que vous souhaitez inclure dans la requête. Ensuite, déposez-les en tant que nœuds sur le canevas et définissez des propriétés de relation entre eux. Vous pouvez filtrer sur les attributs de n’importe quel nœud pour affiner les résultats à un ensemble spécifique de CI de cette classe ou à un seul CI spécifique. Vous pouvez également sélectionner les colonnes de propriétés qui apparaissent dans les résultats de la requête.

    Au fur et à mesure que vous créez une requête, les options de liste et d’autres éléments de l’interface utilisateur du générateur de requêtes CMDB sont filtrés dynamiquement en fonction de vos sélections.

    Pour en savoir plus sur l’utilisation du générateur de requêtes, consultez la vidéo Requêtes et rapports du générateur de requêtes CMDB - Académie Platform Analytics ServiceNow Community . Pour obtenir la procédure pas à pas de la création de requêtes CMDB dans le générateur de requêtes, y compris les requêtes avec les services d’application, reportez-vous à la section Exemples de requêtes :.

    Procédure

    1. Accédez à la Tout > Configuration et sélectionnez Générateur de requêtes CMDB.
    2. Sur la page du générateur de requêtes CMDB , effectuez l’une des actions suivantes :
      • Sélectionnez Créer. Saisissez un nom, choisissez Requête CMDB comme type de requête, puis sélectionnez Créer.
      • Sélectionnez un widget d’une requête enregistrée pour continuer à créer une requête existante. Rechercher une requête enregistrée d’abord si nécessaire.
      • Pointez sur le coin supérieur droit d’un widget de requête enregistrée et sélectionnez l’icône Dupliquer la requête pour modifier une copie d’une requête enregistrée. Le nom par défaut de la nouvelle requête contient la chaîne « copie ».
    3. Sur le canevas, vous pouvez effectuer l’une des opérations suivantes :
      • Ajouter des classes CI à la requête : dans l’onglet Classes CMDB , sélectionnez des classes dans la liste de hiérarchie et faites-les glisser vers le canevas.

      • Ajoutez un CI de service d’application à la requête : Dans l’onglet Classes CMDB , sélectionnez la classe de service d’application dans la liste de hiérarchie et faites-la glisser vers le canevas.

        Dans les propriétés du service d’application, dans la barre latérale droite, vous pouvez sélectionner Convertir les nœuds attachés en modèle pour interroger les modèles entre le service d’application et d’autres nœuds de classe CMDB. Lors de l’interrogation d’un modèle, les nœuds situés aux deux extrémités de la connexion du modèle peuvent être distants d’un nombre illimité de niveaux. Si l’option Convertir les nœuds attachés en modèle n’est pas sélectionnée, la connexion entre le nœud de service d’application et les autres nœuds de classe CMDB représente des relations directes.

      • Ajouter des tables non CMDB à la requête : sélectionnez une table dans la liste Tables non CMDB et faites-la glisser vers le canevas.
        Remarque :
        Une table non-CMDB ne peut pas être le nœud de départ de la requête.
      • Ajoutez des connexions (relations ou modèles pour les services d’application) entre deux nœuds sur le canevas :
        1. Sur le premier nœud de la connexion, sélectionnez le petit carré au centre du côté droit.
        2. Sur le deuxième nœud de la connexion, sélectionnez le petit carré au centre du côté gauche pour créer la connexion.
        Tableau 1. Notations de l’interface utilisateur de connexion
        Notation Description
        Ligne complète Une relation dans une requête CMDB.
        Astérisque rouge au centre de la ligne de connexion Des informations telles que le type de relation sont manquantes, ce qui invalide la requête.
        Niveaux :<n> Types :<n> ou une notation <Type de référence> sur la ligne de connexion

        Le cas échéant : le nombre de niveaux de relation et le nombre de types de relations inclus pour la connexion. Ou, un type de référence pour une relation qui est une référence.
        Pointillée Modèle de connexion entre un nœud de service d’application et un autre nœud.
      • Dans Propriétés de la connexion dans la barre latérale droite, configurez les paramètres de relation (sélectionnez la ligne de connexion si nécessaire) :
        1. Dans la section Sens de la relation, sélectionnez le nœud Parent (le nœud Enfant s’ajuste automatiquement).
        2. Dans la section Niveaux de relation, définissez le niveau sur Relations de premier niveau si les CI sont directement connectés. Ou, jusqu’à des relations de 2e niveau si les CI sont connectés directement ou indirectement via un autre CI.
        3. Dans la section Types de relations et Éléments connexes, sélectionnez l’une des options suivantes :
          Option Description
          Aucune relation Pour demander les CI sans relations de connexion, tels que Tous les CI WAR Tomcat qui ne sont pas connectés à un serveur Windows.
          Ajouter des types de relations Pour sélectionner un type de relation spécifique ou n’importe quel type de relation.
          Ajouter un élément connexe Pour demander les CI associés entre les nœuds.
      • Configurez la colonne de référence CI pour une connexion à une table non CMDB : dans la barre de droite des propriétés de la connexion, dans la section Colonne de référence CI, sélectionnez la colonne faisant référence à un CI dans la liste Utiliser la colonne de référence CI . Si une seule option est disponible, elle est automatiquement sélectionnée.
      • Configurez le modèle entre un nœud de service d’application défini avec l’option Convertir les nœuds attachés en modèle et un nœud de table non CMDB : Sélectionnez Appliquer <table> une filtre de référence à tous les nœuds du modèle pour appliquer la requête au CI du service d’application lui-même et aux CI au sein du service d’application.
      • Ajouter des filtres à un nœud de classe : appliquez des filtres pour affiner une requête de classe à un ensemble spécifique de CI ou à un seul CI spécifique.
        1. Pointez sur le nœud auquel ajouter un filtre, puis sélectionnez l’icône Appliquer des filtres qui s’affiche au-dessus du nœud.
        2. Dans la section Filtres, ajoutez des conditions d’attribut et de liste connexe.
        3. Fermez la section Filtres .
        Par exemple : ajoutez un filtre pour l’emplacement de la base de données afin d’interroger les bases de données situées à Seattle.

        Sélectionnez Filtres appliqués dans la barre de droite pour afficher tous les filtres de chaque nœud sur le canevas.

      • Ajouter des opérateurs ET/Ou à la requête :
        1. Connectez un nœud à deux autres nœuds.
        2. Sélectionnez la case Et qui apparaît sur la ligne de connexion pour basculer entre les opérateurs Et/Or .
        Par exemple : C1 est Tomcat WAR, C2 est Linux Server et C3 est Windows Server. Requête pour tous les CI WAR Tomcat connectés à un serveur Linux ou à un serveur Windows.
      • Ajoutez des colonnes de propriétés pour un nœud afin qu’elles apparaissent dans les résultats de la requête :
        Remarque :
        Pour une relation, les résultats de la requête incluent les parentcolonnes , child, et type . Vous ne pouvez pas ajouter d’autres colonnes à partir de la table [cmdb_rel_ci].
        1. Sélectionnez Propriétés dans le volet droit.
        2. Sélectionnez un nœud une ou deux fois, de sorte que la section Colonnes du rapport s’affiche dans la barre latérale droite, puis sélectionnez Ajouter des colonnes.
        3. Sélectionnez les propriétés, puis sélectionnez en dehors de la liste des propriétés pour la fermer.
      • Créez une requête de combinaison en intégrant une Mappage des services requête dans une requête CMDB :
        1. Lors de la création d’une requête CMDB, sélectionnez Requêtes de services enregistrées dans la barre latérale gauche.
        2. Sélectionnez une requête, puis faites-la glisser Mappage des services vers le canevas.
        Cette requête renvoie tous les CI qui satisfont à la requête CMDB et qui sont inclus dans les services retournés par la requête incorporée Mappage des services .
      • Ajoutez une balise de recherche qui peut ensuite être utilisée comme critère de recherche pour les requêtes enregistrées :
        1. Sélectionnez l’icône Ajouter des balises en haut du canevas.
        2. Sélectionnez Ajouter une balise et, dans la boîte de dialogue Balises de requête , entrez une ou plusieurs chaînes de balises.
        3. Sélectionnez à nouveau l’icône Ajouter des balises pour fermer la boîte de dialogue Balises de requête .
    4. Sélectionnez Enregistrer.

      Dans l’onglet Requêtes enregistrées , pointez sur un widget de requête enregistrée et sélectionnez Informations sur la requête. Les détails de la requête tels que le type de requête, la date de dernière mise à jour, les groupes CMDB associés à la requête et les calendriers de requêtes s’affichent.

    Que faire ensuite

    • Sélectionnez Exécuter.

      Seuls les 100 premiers résultats de la requête s’affichent dans le volet des résultats.
      • Sélectionnez Charger plus de résultats pour afficher l’ensemble de 100 résultats suivant.
      • Sélectionnez Charger tous les résultats pour afficher le reste des résultats de la requête, jusqu’au nombre spécifié par la propriété système glide.cmdb.query.max_results_limit (10 000 par défaut).

      Sélectionnez un CI pour ouvrir son formulaire CI et, sur le formulaire CI, sélectionnez Ouvrir dans l’espace de travail CMDB pour afficher l’intégrité des CI dans la vignette Intégrité des CI dans l’espace de travail CMDB. Cette opération nécessite un rôle sn_cmdb_user (utilisateur CMDB).

      Remarque :
      • Assurez-vous que la propriété glide.security.use_csrf_token est définie sur true, ce qui permet à tous les résultats d’apparaître.
      • Lorsque le niveau est défini sur Jusqu’aux relations de 2e niveau, le type de relation n’apparaît pas dans les résultats de la requête.
      • Lorsqu’une requête est en cours d’exécution, attendez qu’elle se termine ou expire avant d’ouvrir ou d’exécuter une autre requête.
    • Modifier les paramètres du générateur de requêtes : sélectionnez l’icône Paramètres. (Paramètres) pour ouvrir la boîte de dialogue Paramètres du générateur de requêtes .
    • Copiez et partagez l’URL d’une requête enregistrée avec les utilisateurs qui ont accès au générateur de requêtes CMDB. Coller l’URL partagée dans une nouvelle fenêtre de navigateur Internet ouvre directement la requête enregistrée dans le générateur de requêtes CMDB.
    • Créer un rapport dans le générateur de requêtes CMDB.
    • Créez un calendrier pour exécuter la requête ultérieurement et pour envoyer les résultats par e-mail aux parties intéressées.
    • Exporter les résultats de la requête :

      Sélectionnez le menu contextuel Résultats de la requête, puis sélectionnez Exporter. Même si le bouton Charger plus de résultats est visible, indiquant qu’il existe des résultats de requête supplémentaires, seuls les résultats visibles sont exportés.

    • Exporter et importer une requête CMDB pour porter une définition de requête entre les instances.
    • Remplissez un groupe CMDB à l’aide d’une requête enregistrée.
    • Supprimer une requête CMDB.