En IBM Rational ClearQuest, el usuario puede adjuntar archivos a un registro (es decir, un objeto Entity) en un campo de archivo de datos adjuntos. Un registro que representa un defecto puede tener múltiples campos de archivo de datos adjuntos, y cada campo puede tener múltiples archivos adjuntos. Por ejemplo, un registro puede tener tres campos de archivo de datos adjuntos separados: uno para archivos de código fuente, uno para especificaciones de ingeniería, y otro para documentación.
Para gestionar los campos de archivo de datos adjuntos, cada objeto Entity tiene un objeto AttachmentFields. Para gestionar archivos de datos adjuntos individuales, cada AttachmentField tiene un objeto Attachments.
Para cruzar de un objeto Entity a un objeto Attachment, primero debe obtener el objeto AttachmentFields. A medida que cruce, puede distinguir una vía de acceso general gracias a los nombres AttachmentField. Cuando se encuentre en el nivel de una recopilación real de archivos de datos adjuntos, puede identificar archivos de datos adjuntos individuales utilizando valores Description y FileName.
El objeto AttachmentFields es una recopilación de objetos AttachmentField. Representa todos los campos de archivo de datos adjuntos asociados a un registro. Sólo puede haber un objeto AttachmentFields asociado a un registro. Este objeto contiene uno o más objetos AttachmentField. Sus métodos proporcionan acceso a los campos que contienen archivos de datos adjuntos.
El objeto AttachmentField representa un único campo de archivo de datos adjuntos en un registro. Un registro puede tener múltiples objetos AttachmentField, cada uno de los cuales incluye un único objeto Attachments. Un AttachmentField puede mantener una recopilación de archivos, cada uno almacenado en un objeto Attachment individual.
El objeto Attachments es un objeto contenedor que almacena uno o más objetos Attachment. Un objeto Attachments siempre se asocia a un único objeto AttachmentField. Este objeto contiene todas las recopilaciones del campo de archivo de datos adjuntos correspondiente y proporciona métodos para recontar, obtener, añadir y suprimir archivos de datos adjuntos.
Un objeto Attachment contiene un único archivo adjunto. Un objeto Attachment contiene información sobre un archivo de datos adjuntos concreto como, por ejemplo, su descripción, el nombre del archivo original, el tamaño del archivo, y proporciona los modos de manipular el archivo de datos adjuntos.
Los métodos del objeto Entity siguientes se utilizan para almacenar y gestionar archivos de datos adjuntos.
Obtiene el objeto de acceso. Cada objeto Entity tiene, exactamente, un objeto AttachmentFields con métodos que gestionan campos de archivo de datos adjuntos.
Obtiene los nombres de campo definidos para este objeto. Cuando utilice el objeto AttachmentFields para cruzar las recopilaciones de archivos de datos adjuntos, es posible que desee conocer los nombres de campo con el objeto de identificar la vía de acceso que desea seguir. (De forma alternativa, puede utilizar índices para obtener cada AttachmentField).
Obtiene el tipo de datos de un campo. Si el valor de retorno es 7 (_ATTACHMENT_LIST), el campo es del tipo AttachmentField. Resulta útil si tiene un nombre de campo, pero no está seguro sobre el tipo de datos.
Obtiene información sobre todos los campos de este objeto. Normalmente, se puede hacer debido a que utilizando FieldInfo.GetValue() y FieldInfo.GetValueAsList() se obtienen otros tipos de valores. Si tiene una matriz de objetos FieldInfo, puede obtener cada nombre con FieldInfo.GetName() y comprobar cada tipo de datos con FieldInfo.GetType().
Para obtener más información, consulte el apartado AttachmentFields del objeto Entity y "Obtención y establecimiento de información del archivo de datos adjuntos"