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

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 9 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 connectent.

    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 ressource) pour créer et enregistrer des requêtes, modifier des 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 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é qui apparaissent dans les résultats de la requête.

    Au fur et à mesure que vous progressez dans la création d’une requête, les options de liste et les 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 de Platform Analytics ServiceNow Community . Pour obtenir une présentation étape par étape de la création des 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 Tous > Configuration et sélectionnez Générateur de requêtes CMDB.
    2. Sur la page Générateur de requêtes CMDB , effectuez l’une des étapes suivantes :
      • Sélectionnez Créer. Saisissez un nom, choisissez Requête CMDB comme type de requête, puis sélectionnez Créer.
      • Sélectionnez le 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é 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 « copy ».
    3. Sur le canevas, vous pouvez effectuer l’une des opérations suivantes :
      • Ajoutez des classes CI à la requête : dans l’onglet Classes CMDB , sélectionnez des classes dans la liste 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 hiérarchie et faites-la glisser vers le canevas.

        Dans Propriétés du service d’application dans la barre de 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 sur un modèle, les nœuds situés aux deux extrémités de la connexion de modèle peuvent être distants de plusieurs 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 d’autres nœuds de classe CMDB représente des relations directes.

      • Ajoutez 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 d’interface utilisateur de connexion
        Notation Description
        Ligne complète Une relation dans une requête CMDB.
        Un 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 relations 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 Connexion de modèle entre un nœud de service d’application et un autre nœud.
      • Dans la barre de droite des propriétés de connexion, 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 Niveau sur Relations de premier niveau si les CI sont directement connectés. Ou, jusqu’aux relations de niveau 2 si les CI sont connectés directement ou indirectement par l’intermédiaire d’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 interroger 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.
          Ajouter un élément connexe Pour rechercher 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 latérale droite des propriétés de connexion, dans la section Colonne de référence CI, sélectionnez la colonne contenant une référence à un CI dans la liste Colonne de référence Utiliser 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 joints en modèle et un nœud de table non CMDB : Sélectionnez Appliquer <table> le 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 à interroger sur les bases de données situées à Seattle.

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

      • Ajoutez des opérateurs Et/ou à la requête :
        1. Connectez un nœud à deux autres nœuds.
        2. Cochez 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 qui sont connectés soit à un serveur Linux, soit à un serveur Windows.
      • Ajoutez des colonnes de propriété pour un nœud, à afficher dans les résultats de la requête :
        Remarque :
        Pour une relation, les résultats de la requête incluent les parentcolonnes , childet 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 pour que la section Colonnes du rapport s’affiche dans la barre de droite, puis sélectionnez Ajouter des colonnes.
        3. Sélectionnez des propriétés, puis en dehors de la liste des propriétés pour la fermer.
      • Créez une requête combinée 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 service enregistrées dans la barre de gauche.
        2. Sélectionnez puis faites glisser une Mappage des services requête vers le canevas.
        Cette requête renvoie tous les CI qui satisfont à la requête CMDB et qui sont inclus dans les services renvoyé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é 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 des 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 le prochain ensemble de 100 résultats.
      • 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 de CI, puis dans le formulaire CI, sélectionnez Ouvrir dans Espace de travail CMDB pour afficher l’intégrité des CI dans la vignette Intégrité du CI dans Espace de travail CMDB. Cette opération nécessite le 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 les relations de niveau 2 maximum, 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 qu’elle 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 ayant accès au générateur de requêtes CMDB. Le collage de 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 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 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 des instances.
    • Remplissez un groupe CMDB à l’aide d’une requête enregistrée.
    • Supprimer une requête CMDB.