Sie erstellen eine Abfrage, indem Sie durch Aufrufen der Methode BuildQuery
des Sitzungsobjekts ein QueryDef-Objekt erstellen.
Eine Abfrage besteht aus einer Liste von Feldern für einen bestimmten Datensatztyp, für den Sie die Werte
abrufen möchten. Die Datensätze werden in einem ResultSet-Objekt zurückgegeben. Die Abfrage gibt die erforderlichen Felder
für alle Datensätze eines bestimmten Typs zurück. Sie können dann durch die Ergebnismengen navigieren und die Daten verarbeiten.
Die
Erstellung einer Abfrage umfasst die Erstellung von mindestens drei separaten Objekten:
einem QueryDef-Objekt, einem QueryFilterNode-Objekt und einem ResultSet-Objekt.
Komplexere Abfragen beinhalten möglicherweise die Erstellung zusätzlicher
QueryFilterNode-Objekte.
Führen Sie die folgenden Schritte aus, um eine einfache Abfrage zu erstellen:
- Erstellen Sie eine Abfrage, indem Sie das QueryDef-Objekt verwenden, um die abzurufenden Daten anzugeben. Das QueryDef-Objekt enthält
die Definition einer Abfrage für eine Rational-ClearQuest-Datenbank. Nach Erstellung eines QueryDef-Objekts können Sie mit diesem Objekt
Informationen aus der Datenbank abrufen. Verwenden Sie zum Erstellen dieses Objekts die Methode BuildQuery des
Sitzungsobjekts.
- Verwenden Sie die Methoden von QueryDef, um Suchkriterien hinzuzufügen und die Felder
der einzelnen Datensätze anzugeben, die von der Abfrage zurückgegeben werden sollen.
- Erstellen Sie ein ResultSet-Objekt, das die zurückgegebenen Daten speichern soll. Rufen Sie
zum Erstellen dieses Objekts die Methode BuildResultSet des Sitzungsobjekts auf. Bei der
Erstellung wird vom ResultSet-Objekt ein Satz interner Datenstrukturen erstellt, wobei die Informationen im QueryDef-Objekt als Vorlage dienen. Bei
Ausführung der Abfrage füllt das ResultSet-Objekt diese Datenstrukturen mit den Daten aus der Abfrage.
- Führen Sie die Abfrage aus, indem Sie die Methode Execute oder ExecuteAndCountRecords des ResultSet-Objekts aufrufen. Durch Aufrufen einer
dieser Methoden wird eine Ergebnismenge mit den aus der Datenbank abgerufenen Daten gefüllt.
- Greifen Sie auf die Daten zu, indem Sie durch das ResultSet-Objekt navigieren und andere Methoden
des Objekts verwenden, um Informationen zu den Feldern eines Datensatzes abzurufen.
Eine Abfrage gibt nicht den gesamten Datensatz, sondern nur die Felder des Datensatzes zurück,
die Sie durch Aufrufen der Methode BuildField des QueryDef-Objekts angegeben haben. Die Methode Execute gibt Ergebnisse in keiner bestimmten Reihenfolge zurück. Deshalb verwendet das ResultSet-Objekt ein cursorbasiertes System, damit der Code nacheinander durch die einzelnen Datensätze navigieren kann.