Toolmentor: Mit Abfragen in Rational ClearQuest arbeiten
Dieser Toolmentor beschreibt, wie Abfragen in Rational ClearQuest zum Abrufen von Datensätzen aus einer ClearQuest-Datenbank verwendet werden.
Tool: Rational ClearQuest
Hauptbeschreibung

Überblick

Dieser Toolmentor beschreibt die Schritte für die folgenden Aufgaben:

Abfragen erstellen und speichern

Es gibt verschiedene Möglichkeiten, Abfragen zu erstellen, aber in jedem Fall müssen Sie die Abfrage benennen, definieren, ausführen und/oder speichern. Wenn Sie zuerst eine Datenbank verwenden, führt Sie der Abfrageassistent durch die Auswahl der Felder, die Sie anzeigen möchten, und lässt Sie die Felder und Werte auswählen, die Sie als Abfragefilter verwenden möchten. Später, wenn Sie mit dem Erstellen von Abfragen vertraut sind, können Sie das Abfragefenster verwenden, um die Abfragefilter zu bearbeiten und Anzeigefelder zu konfigurieren.

Toolschritte

Die folgenden Schritte werden ausgeführt, um eine Abfrage mit dem Abfrageassistenten in Rational ClearQuest zu erstellen:

  1. Stellen Sie sicher, dass die Option Use Query Wizard im Menü Query ausgewählt ist.
  2. Wählen Sie Query > New Query aus, um das Dialogfenster Choose Record Type zu öffnen.
  3. Wählen Sie einen Datensatztyp aus und klicken Sie auf OK.
  4. Führen Sie im Dialogfenster ClearQuest Query Wizard die folgenden Aktionen aus:
    1. Geben Sie im Feld Start with an Existing Query den Namen einer Abfrage ein, die Sie als Vorlage verwenden möchten.
    2. Klicken Sie auf Browse und anschließend auf Yes, um eine Liste der verfügbaren Abfragen anzuzeigen, die Sie als Vorlagen verwenden können. Es wird empfohlen, eine der Abfragen unter "Public Queries" auszuwählen.
    3. Klicken Sie auf Next, um eine neue, leere Abfrage mit dem Abfrageassistenten zu erstellen.
  5. Im Dialogfenster Define How the Query Displays können Sie die Anzeige der Abfrageergebnisse anpassen, indem Sie die anzuzeigenden Felder auswählen. Wenn Sie beispielsweise ID, Status und Überschrift als Anzeigefelder auswählen, werden in den Abfrageergebnissen nur diese drei Felder angezeigt.
    1. Zum Anzeigen der gewünschten Felder klicken Sie doppelt auf den Datensatz, um ihn in das Grid "Display" zu verschieben. Das Grid "Display" enthält die folgenden Spalten: Field, Title, Sort, Show und Sort Order.
    2. Wählen Sie die gewünschten Anzeigefelder aus und klicken Sie auf Next.
  6. Wählen Sie die Felder aus, die Sie als Abfragefilter verwenden möchten. Abfragefilter bestimmen, welche Datensätze angezeigt werden.
    1. Wählen Sie im Dialogfenster Select Fields to Use as Query Filters die Felder aus, die Sie als Abfragefilter verwenden möchten, indem Sie doppelt auf das jeweilige Feld klicken und es damit in das Teilfenster "Filters" verschieben.
    2. Klicken Sie auf Next.
  7. Auf der Seite "Filter definition" des Abfrageassistenten können Sie die Abfragefilter definieren, indem Sie Ausdrücke erstellen, die nach dem gültigen Wert bzw. Wertebereich suchen, den Sie angeben. Die Seite "Filter definition" ist in zwei Teilfenster eingeteilt: Im Teilfenster "Filters" werden die ausgewählten Felder aufgelistet, und im Tool "Filter" (auf der rechten Seite) können Sie die Filterwerte definieren.
    1. Klicken Sie auf die Filter, die Sie definieren möchten.
    2. Wählen Sie im Tool "Filter" (auf der rechten Seite) den Operator aus, den Sie verwenden möchten. Die Liste der verfügbaren Operatoren richtet sich nach dem für das Feld erforderlichen Datentyp. Verwenden Sie das Markierungsfeld Not, um anzuzeigen, dass Sie genau das Gegenteil vom ausgewählten Operator wünschen.
    3. Klicken Sie auf Values, um eine Liste der für diesen Filter verfügbaren Werte anzuzeigen.
    4. Wählen Sie im Dialogfenster Values die Werte aus, die Sie einfügen möchten, und klicken Sie anschließend auf OK.
    5. Klicken Sie auf Set Value, um den Wert für das ausgewählte Feld festzulegen. Wiederholen Sie diesen Schritt für jedes Feld.
  8. Klicken Sie abschließend auf Run. Die Abfrage erhält einen Standardnamen und wird ausgeführt. Es erscheint ein Fenster "Query", in dem die Ergebnisse angezeigt werden.
  9. Wenn Sie mit den Ergebnissen zufrieden sind und die Abfrage später noch einmal ausführen möchten, speichern Sie die Abfrage. Klicken Sie auf File > Save oder File > Save As. Geben Sie einen Namen und ein Verzeichnis ein, in dem Sie die Abfrage speichern möchten.
  10. Wenn Sie die Abfrage verwerfen und das Fenster "Query" schließen möchten, klicken Sie auf File > Close und anschließend auf No.

Abfrageergebnisse sichten

Abfrageergebnisse werden auf der Registerkarte Results set angezeigt und einem Grid entsprechend den Feldern, die Sie im Anzeigeeditor auswählen, aufgelistet. Die Satzdaten werden strukturiert auf verschiedenen Registerkarten im Grid "Results" angezeigt, z. B. Main, Analysis, Resolution. Die Felder, die auf den einzelnen Registerkarten angezeigt werden, und die Anzahl der Registerkarten für jeden Datensatz können je nach ClearQuest-Umgebung variieren.

Toolschritte

Die folgenden Schritte werden ausgeführt, um die Ergebnisse einer Abfrage mit Rational ClearQuest zu sichten:

  1. Klicken Sie auf die Zeile, die die Informationen zum Datensatz enthält.
  2. Wenn Sie weitere Informationen zu dem Datensatz sehen möchten, klicken Sie auf das entsprechende Register.

Abfrageergebnisse anzeigen

Rational ClearQuest speichert Abfragen in den Ordnern "Private Queries" und "Public Queries folders". Abfragen, die Sie erstellen, werden automatisch im Ordner "Personal Queries" abgelegt. Beide Ordner enthalten Abfragen, die ausgeführt oder für persönliche Verwendung angepasst werden können.

Toolschritte

Die folgenden Schritte werden ausgeführt, um Abfrageergebnisse mit Rational ClearQuest anzuzeigen:

  1. Öffnen Sie den Ordner "Private Queries" oder "Public Queries", um die darin enthaltenen Abfragen aufzulisten.
  2. Klicken Sie doppelt auf die Abfrage, die Sie ausführen möchten.
  3. Vervollständigen bzw. wählen Sie auf Anforderung die Optionen im Dialogfenster aus und klicken Sie auf OK.

Abfrageergebnisse drucken

Nachdem Sie eine Abfrage ausgeführt haben, können Sie die Datensätze, die auf der Registerkarte Results set angezeigt werden, drucken. Beim Drucken der Abfrageergebnisse haben Sie die Möglichkeit, Kopf- und Fußzeilen hinzufügen. Das Berichtsformat, das dem Datensatztyp zugeordnet ist, bestimmt die Felder, die gedruckt werden.

Toolschritte

Die folgenden Schritte werden ausgeführt, um ein Abfrageergebnis mit Rational ClearQuest zu drucken.

  1. Führen Sie eine Abfrage aus und wählen Sie das Register Result set aus.
  2. Sie können Ihren Abfrage-Grids Kopf- und Fußzeilen hinzufügen, die dann gedruckt werden. Zum Ändern dieser Kopf- und Fußzeilen gehen Sie wie folgt vor:
    1. Klicken Sie auf File > Headers/Footers.
    2. Klicken Sie auf das Register Headers, um die Kopfzeile hinzuzufügen oder zu ändern, und geben Sie die Bedingung an, die Sie in der entsprechenden Spalte verwenden möchten. Sie können zwischen zentriert, linksbündig und rechtsbündig wählen.
    3. Klicken Sie auf die Registerkarte Footers, um die Fußzeile hinzuzufügen oder zu ändern.
    4. Wählen Sie Save setting to profile aus, wenn Sie diese Einstellungen auch weiterhin in Rational ClearQuest verwenden möchten.
    5. Klicken Sie auf OK.
  3. Klicken Sie auf File > Print Grid oder klicken Sie in der Funktionsleiste auf die Schaltfläche Print.
  4. Geben Sie im Dialogfenster Print die Optionen für die Felder Printer, Print to file, Print range und Copies an und klicken Sie anschließend auf OK.