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

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 6 minutes de lecture

    • Le Mappage des services type de requête est un modèle composé de classes et de relations entre ces classes. Une fois que vous avez créé le modèle et exécuté la requête, la requête renvoie tous les Mappage des services services qui contiennent ce modèle.

    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.

    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 que vous souhaitez inclure dans la requête, en les déposant sous forme de nœuds sur le canevas, puis en définissant les propriétés de relation entre elles. Pour chaque nœud de classe de la requête, vous pouvez filtrer ses attributs afin d’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.

    Consultez la procédure Exemples de requêtes : pas à pas de la création d’une Mappage des services requête dans le générateur de requêtes CMDB.

    Procédure

    1. Accédez à la Tous > Configuration > Générateur de requêtes CMDB.
    2. Sur la page Générateur de requêtes CMDB , effectuez l’une des actions suivantes :
      1. Sélectionnez Créer.
      2. Saisissez un Nom.
      3. Sélectionnez Requête de Mappage des services comme type de requête.
      4. Sélectionnez Créer.
      5. 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.
      6. Pointez sur le coin supérieur droit d’un widget de requête enregistré.
      7. 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 : Sélectionnez des classes dans la liste hiérarchie des classes CMDB et faites-les glisser vers le canevas.
      • Ajoutez des connexions (relations) entre deux nœuds sur le canevas :
        1. Sur le premier nœud de la relation, sélectionnez le petit carré au centre du côté droit.
        2. Sur le deuxième nœud de la relation, sélectionnez le petit carré au centre du côté gauche pour créer la connexion.
        3. Dans Propriétés de connexion dans la barre latérale droite, configurez les éléments suivants (sélectionnez la ligne de connexion si nécessaire) :
          • Dans la section Sens de la relation, sélectionnez le nœud parent (le nœud enfant s’ajuste automatiquement).
          • Dans la section Propriétés de la requête de service, sélectionnez Rechercher les CI associés ou Rechercher les CI non associés pour rechercher un modèle dans lequel les deux classes ont ou n’ont pas de relations l’une avec l’autre, respectivement.

            Par exemple, tous les CI WAR Tomcat qui ne sont pas connectés à un serveur Windows.

        Tableau 1. Notations d’interface utilisateur de relation
        Notation Description
        Pointillée Une relation dans une Mappage des services requête.
      • Ajouter des filtres à un nœud de classe : appliquez des filtres pour affiner une 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 la criticité opérationnelle afin d’interroger les entreprises « les plus critiques ».

        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. Sélectionnez la case Et qui apparaît sur la ligne de connexion, pour basculer entre les opérateursEt et Ou.

        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 affichent 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 du nœud 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.
      • Sélectionnez des colonnes et ajoutez des filtres qui seront appliqués à l’ensemble de services résultant :
        1. Sélectionnez Propriétés dans la barre de droite, puis sélectionnez un espace vide sur le canevas pour vous assurer que rien n’est sélectionné.
        2. Sélectionnez Ajouter des colonnes en bas de la barre de droite, puis sélectionnez les colonnes à ajouter. Sélectionnez en dehors de la liste des colonnes pour la fermer.
        3. Sélectionnez l’icône Appliquer des filtres de requête de mappage des services en haut du canevas et ajoutez des filtres.
      • Inversez l’intégralité de la requête et recherchez tous les Mappage des services services qui n’incluent pas le modèle de requête : sélectionnez un nœud une ou deux fois pour que les propriétés de la requête apparaissent dans la barre de droite. Dans la section Métadonnées, basculez Services incluant ce modèle pour activer ou désactiver l’option.
      • 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 de requête pour afficher les détails de la requête tels que le type de requête, la date de dernière mise à jour et les calendriers des requêtes.

    Que faire ensuite

    • Sélectionnez Exécuter.

      Le volet des résultats de la requête affiche uniquement les 100 premiers résultats de la requête.
      • 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 :
      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 (icône 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 :

      Résultats des requêtes d’exportation visibles : 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.
    • Renseignez un groupe CMDB à l’aide de la requête enregistrée.
    • Supprimer une requête CMDB.