Guide d'utilisation de l'outil: Travailler avec des requêtes avec Rational ClearQuest
Ce guide d'utilisation de l'outil décrit comment utiliser des requêtes pour extraire des enregistrements d'une base de données ClearQuest avec Rational ClearQuest.
Outil: Rational ClearQuest
Description principale

Présentation

Ce guide d'utilisation de l'outil fournit des indications concernant les étapes suivantes :

Création et enregistrement des requêtes

Il existe différentes façons de créer une requête, mais chacune d'entre elles exige de nommer, de définir, d'exécuter et/ou d'enregistrer la requête. Lorsque vous utilisez une base de données pour la première fois, l'assistant de Requête vous aide à choisir les champs que vous souhaitez afficher et vous permet de choisir ceux que vous utiliserez comme filtre de recherche ainsi que les valeurs qui leur correspondent. Plus tard, lorsque vous serez habitué à créer des requêtes, il vous sera possible d'utiliser la fenêtre Requête pour modifier les filtres et définir les champs affichés.

Etapes outils

Les étapes suivantes sont exécutées pour créer une requête avec l'assistant de Requête lors de l'utilisation de Rational ClearQuest :

  1. Assurez-vous que l'option Use Query Wizard est activée dans le menu Query.
  2. Sélectionnez Query > New Query pour ouvrir la boîte de dialogue Choose Record Type.
  3. Sélectionnez le type d'enregistrement et cliquez sur OK.
  4. Dans la boîte de dialogue ClearQuest Query Wizard, effectuez les opérations suivantes :
    1. Dans Start with an Existing Query, saisissez le nom de la requête à utiliser comme canevas.
    2. Cliquez sur Browse, puis sur Yes pour visualiser une liste de requêtes disponibles comme canevas. Nous vous recommandons de choisir une requête parmi les Requêtes Publiques.
    3. Cliquez sur Next pour créer une nouvelle requête vierge avec l'Assistant de Requêtes.
  5. La boîte de dialogue Define How the Query Displays vous permet de personnaliser l'affichage des résultats en choisissant les champs à afficher. Par exemple, si vous sélectionnez ID, State et Headline comme champs affichés, les résultats de votre requête ne s'afficheront que dans ces trois champs.
    1. Pour afficher les champs de votre choix, double-cliquez sur l'enregistrement pour le placer dans la grille d'affichage. La grille d'affichage comprend les colonnes suivantes : Field, Title, Sort, Show, and Sort Order.
    2. Sélectionnez les champs à afficher et cliquez sur Next.
  6. Sélectionnez les champs à employer comme filtres de requête. Les filtres de requête déterminent quelles seront les entrées affichées.
    1. Dans la boîte de dialogue Select Fields to Use as Query Filters, sélectionnez les champs à utiliser comme filtre de requête en double-cliquant sur le champ pour le déplacer vers le volet Filters.
    2. Cliquez sur Next.
  7. La page de définition des filtres de l'Assistant de Requête vous permet de définir les filtres de requête en créant des expressions qui recherchent la valeur exacte ou la plage de valeurs spécifiée. La page de définition des filtres est divisée en deux volets : le volet Filters (sur la gauche), qui dresse la liste des champs que vous avez sélectionés et l'outil Filter (sur la droite), qui vous permet de définir les valeurs du filtre.
    1. Cliquez sur le filtre que vous souhaitez modifier.
    2. Dans l'outil Filter (sur la droite), choisissez l'opérateur que vous souhaitez employer. La liste des opérateurs disponibles dépend du type de données requises pour le champ. Cochez la case Not pour indiquer que vous voulez effectuer l'opposé de ce qu'indique l'opérateur sélectionné.
    3. Cliquez sur Values pour afficher une liste de valeurs disponibles pour le filtre.
    4. Dans la boîte de dialogue Values, sélectionnez les valeurs que vous voulez inclure et cliquez sur OK.
    5. Cliquez sur Set Value pour indiquer la valeur du champ sélectionné. Répétez cette étape pour chaque champ.
  8. Pour terminer, cliquez sur Run. La requête reçoit un nom par défaut et se lance. Une fenêtre de requête indiquant les résultats apparaît.
  9. Si vous êtes satisfait des résultats et que vous souhaitez relancer la requête lors de prochaines occasions, enregistrez la requête en cliquant sur File > Save ou File > Save as. Spécifiez un nom et un emplacement pour enregistrer la requête.
  10. Si vous souhaitez supprimer la requête et fermer la fenêtre de requête, cliquez sur File > Close, puis sur No.

Affichage des résultats d'une requête

Les résultats de la requête sont affichés dans l'onglet Results sets et insérés dans une grille selon les champs sélectionnés dans l'éditeur d'affichage. Les enregistrements sont organisés sous divers onglets dans la grille de résultats, comme Main, Analysis, Resolution, etc. Les champs apparaissant dans chaque onglet et le nombre d'onglets de chaque enregistrement peuvent varier en fonction de votre environnement ClearQuest.

Etapes outils

Les étapes suivantes sont effectuées pour voir les résultats d'une requête lors de l'utilisation de Rational ClearQuest :

  1. Cliquez sur la ligne qui contient l'information concernant l'enregistrement.
  2. Pour une information plus détaillée concernant cet enregistrement, cliquez sur l'onglet approprié.

Mode d'affichage des résultats d'une requête

Rational ClearQuest stocke les requêtes dans les dossiers Private Queries et Public Queries. Les requêtes que vous créez sont automatiquement stockées dans le dossier des Personal Queries. Ces deux dossiers contiennent des requêtes prêtes à l'emploi ou personnalisables pour un usage personnel.

Etapes outils

Les étapes suivantes sont effectuées pour afficher les résultats d'une requête lors de l'utilisation de Rational ClearQuest :

  1. Ouvrez le dossier Private Queries ou Public Queries pour afficher les requêtes qu'il contiennent.
  2. Double-cliquez sur la requête que vous souhaitez lancer.
  3. Le cas échéant, complétez ou sélectionnez les options de la boîte de dialogue et cliquez sur OK.

Impression des résultats d'une requête

Après avoir lancé une requête, il vous est possible d'imprimer les enregistrements apparaissant dans l'onglet Results set. Vous avez la possibilité d'ajouter les en-têtes et pieds de page lors de l'impression des résultats de la requête. Le format du rapport associé au type d'enregistrement détermine les champs à imprimer.

Etapes outils

Les étapes suivantes sont effectuées pour imprimer les résultats d'une requête avec Rational ClearQuest :

  1. Exécutez une requête et sélectionnez l'onglet Result set.
  2. Vous pouvez ajouter les en-têtes et pieds de page aux grilles de requête incluses lors de l'impression. Pour modifier ces en-têtes et pieds de page, suivez les indications suivantes :
    1. Cliquez sur File > Headers/Footers
    2. Cliquez sur l'onglet Headers pour ajouter ou modifier l'en-tête et tapez le texte que vous souhaitez voir apparaître pour chaque colonne. Il vous est possible d'avoir un texte centré, justifié à gauche ou justifié à droite.
    3. Cliquez sur l'onglet Footers pour modifier le pied de page.
    4. Sélectionnez Save setting to profile si vous voulez appliquer ces paramètres lors de la prochaine utilisation de Rational ClearQuest
    5. Cliquez sur OK.
  3. Cliquez sur File > Print Grid ou cliquez sur le bouton Print de la barre d'outils.
  4. Dans la boîte de dialogue Print, paramétrez les options appropriées dans Printer, Print to file, Print range ou Copies, selon vos besoins, puis cliquez sur OK.