Objet

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.

Ce guide d'utilisation de l'outil se réfère aux informations RUP suivantes :

Présentation

Les requêtes vous permettent de rechercher des enregistrements spécifiques dans une base de données ClearQuest. Les requêtes comprennent des critères de recherche que vous utilisez soit par le biais des requêtes disponibles, soit en en créant de nouvelles avec l'Editeur de requêtes. Lorsque vous lancez la requête, ClearQuest exécute la recherche dans la base de données selon les critères indiqués. Si un ou plusieurs enregistrements correspondent aux critères de recherche, ClearQuest affiche une liste résumée de ces enregistrements dans le volet des résultats.

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

Créer et enregistrer des requêtes Haut de la page

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 outil

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 cochée dans le menu Query.
  2. Sélectionnez Query > New Query pour ouvrir la boîte de dialogue Choose Record Type.
  3. Sélectionnez un 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, spécifiez le nom de la requête à employer 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 dans 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 d'affichage que vous souhaitez, puis 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, choisissez les champs à utiliser comme filtres 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 No pour indiquer que vous souhaitez effectuer l'opposé de ce qu'indique l'opérateur sélectionné.
    3. Cliquez sur Values pour afficher une liste des valeurs disponibles pour ce filtre.
    4. Dans la boîte de dialogue Values, sélectionnez les valeurs que vous souhaitez inclure puis 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 chemin 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.

Visualiser les résultats d'une requête Haut de la page

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 outil

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é.

Afficher les résultats d'une requête Haut de la page

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 outil

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, puis cliquez sur OK.

Imprimer les résultats d'une requête To top of page

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 outil

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

  1. Lancez 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 ajouter ou modifier le pied de page.
    4. Sélectionnez Save setting to profile si vous souhaitez que ces paramètres soient appliqués lors de votre 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.


RUP (Rational Unified Process)   2003.06.15