In IBM® Rational ClearQuest kann der Benutzer in einem Anhangsfeld Dateien an einen Datensatz (d. h. ein Entity-Objekt) anhängen. Ein Datensatz, der einen Fehler darstellt, kann mehrere Anhangsfelder aufweisen, und jedes Feld kann über mehrere angehängte Dateien verfügen. Ein Datensatz kann zum Beispiel drei separate Anhangsfelder aufweisen: eines für Quellcodedateien, eines für technische Spezifikationen und eines für Dokumentation.
Zur Verwaltung von Anhangsfeldern verfügt jedes Entity-Objekt über ein AttachmentFields-Objekt. Zur Verwaltung einzelner Anhänge verfügt jedes AttachmentField-Objekt über ein Attachments-Objekt.
Wenn Sie von einem Entity-Objekt zu einem Anhang gelangen möchten, müssen Sie zuerst das AttachmentFields-Objekt abrufen. Bei der Durchquerung können Sie mit den AttachmentField-Namen einen allgemeinen Pfad ermitteln. Wenn Sie auf der Ebene einer tatsächlichen Sammlung von Anhängen angelangt sind, können Sie einzelne Anhänge mit den Werten "Description" und "FileName" identifizieren.
Das AttachmentFields-Objekt ist eine Sammlung von AttachmentField-Objekten. Es stellt alle Anhangsfelder dar, die einem Datensatz zugeordnet sind. Einem Datensatz kann nur jeweils ein AttachmentFields-Objekt zugeordnet werden. Dieses Objekt enthält ein oder mehrere AttachmentField-Objekte. Mit den zugehörigen Methoden wird Zugriff auf Felder mit Anhängen erteilt.
Das AttachmentField-Objekt stellt ein Anhangsfeld in einem Datensatz dar. Ein Datensatz kann über mehrere AttachmentField-Objekte verfügen, wobei jedes Objekt jeweils ein Attachments-Objekt enthält. Ein AttachmentField-Objekt kann eine Sammlung von Dateien enthalten, wobei jede Datei in einem eigenen Attachment-Objekt gespeichert ist.
Das Attachments-Objekt ist ein Containerobjekt, das ein oder mehrere Attachment-Objekte speichert. Ein Attachments-Objekt ist stets einem AttachmentField-Objekt zugeordnet. Dieses Objekt enthält alle Sammlungen des entsprechenden Anhangsfelds und stellt Methoden zum Zählen, Abrufen, Hinzufügen und Löschen von Anhängen zur Verfügung.
Ein Attachment-Objekt enthält eine angehängte Datei. Ein Attachment-Objekt enthält Informationen zu einem bestimmten Anhang, z. B. Beschreibung, ursprünglicher Dateiname und Dateigröße. Ferner bietet es Möglichkeiten zur Bearbeitung des Anhangs.
Die folgenden Methoden des Entity-Objekts werden zur Speicherung und Verwaltung von Anhängen verwendet.
Ruft das Zugriffsobjekt ab. Jedes Entity-Objekt verfügt über genau ein AttachmentFields-Objekt mit Methoden zur Verwaltung von Anhangsfeldern.
Ruft die Feldnamen für dieses Objekt ab. Bei Verwendung des AttachmentFields-Objekts zur Durchquerung von Anhangsammlungen benötigen Sie möglicherweise die Feldnamen, um den gewünschten Pfad zu ermitteln. (Alternativ können Sie Indizes verwenden, um jedes AttachmentField-Objekt abzurufen.)
Ruft den Datentyp eines Felds ab. Wenn der Rückgabewert 7 ist (_ATTACHMENT_LIST), lautet der Datentyp AttachmentField. Diese Information ist nützlich, wenn Sie über einen Feldnamen verfügen, aber den Datentyp nicht kennen.
Ruft Informationen zu allen Feldern in diesem Objekt ab. Das ist eine übliche Vorgehensweise, weil Sie andere Werte mit FieldInfo.GetValue() und FieldInfo.GetValueAsList() abrufen. Wenn Sie über ein Array von FieldInfo-Objekten verfügen, können Sie jeden Namen mit FieldInfo.GetName() abrufen und die Datentypen mit FieldInfo.GetType() überprüfen.
Weitere Informationen finden Sie in den Abschnitten AttachmentFields des Entity-Objekts und unter "Getting and setting attachment information".