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

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 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 asset) pour créer et enregistrer des requêtes, modifier les 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 en tant que nœuds sur le canevas, puis en définissant des propriétés de relation entre elles. Pour chaque nœud de classe de la requête, vous pouvez filtrer ses attributs 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.

    Reportez-vous à la rubrique Exemples de requêtes : Procédure 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 Tout > Configuration > Générateur de requêtes CMDB.
    2. Sur la page du générateur de requêtes CMDB , effectuez l’une des opérations 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 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.
      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 « copie ».
    3. Sur le canevas, vous pouvez effectuer l’une des actions suivantes :
      • Ajouter des classes CI à la requête : sélectionnez des classes dans la liste de 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 la 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 interroger 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 de l’interface utilisateur des relations
        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 réduire 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 de rechercher les entreprises les plus critiques.

        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. Cochez 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. Interrogez 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 à afficher dans les résultats de la requête :
        Remarque :
        Pour une relation, les résultats de la requête affichent 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 de rapport du nœud 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.
      • Sélectionnez des colonnes et ajoutez des filtres qui seront appliqués à l’ensemble de services obtenu :
        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.
      • Inverser l’intégralité de la requête et rechercher 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 afin que les propriétés de la requête apparaissent dans la barre de droite. Dans la section Metadata (Métadonnées), activez ou désactivez l’option Services incluant ce modèle .
      • 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 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 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 :
      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 ( 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 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 :

      Pour exporter les résultats de requête visibles : 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.
    • Renseignez un groupe CMDB à l’aide de la requête enregistrée.
    • Supprimer une requête CMDB.