Ein Entitätsobjekt repräsentiert einen Datensatz in einer ClearQuest-Benutzerdatenbank.
Sie können Datensätze anzeigen, ändern und erstellen, indem Sie Methoden des Sitzungsobjekts verwenden.
In diesem Modul werden Sie sich mit den
ClearQuest-API-Objekten und -Methoden vertraut machen, die eingesetzt werden, um einen Datensatz und die darin enthaltenen Daten
anzuzeigen, zu ändern und zu erstellen.
Wenn Benutzer Änderungsanforderungen eingeben, werden die Daten in einem logischen Datensatz, der als
Entität bezeichnet wird, gespeichert.
Der Begriff "Entität" (Entity)
bezieht sich auf eine Struktur,
die Informationen zu einer einzelnen Instanz eines Satztyps (EntityDef), z. B. "defect" (Fehler), verwaltet.
Jede Instanz der Entity-Klasse bietet Zugriff auf die Werte in definierten Feldtypen des Datensatzes, einschließlich einer Liste der Duplikate
des Datensatzes, des Satzprotokolls sowie aller Dateianhänge.
Mit der ClearQuest-API können Sie Daten für den Datensatz und den
Datensatztyp anzeigen, bearbeiten und erstellen. Verwenden Sie dazu die folgenden Methoden des Sitzungsobjekts:
- Methode "GetEntity" zum Anzeigen eines vorhandenen Datensatzes
- Methode "EditEntity" zum Bearbeiten eines vorhandenen Datensatzes
- Methode "BuildEntity" zum Erstellen eines neuen Datensatzes
Die Rational-ClearQuest-API stellt auch Methoden für das Validieren
der Änderungen und das Festschreiben des aktualisierten Datensatzes in der Datenbank bereit.