Objets de pièce jointe (Attachement)

Dans IBM® Rational ClearQuest, l'utilisateur peut joindre des fichiers à un enregistrement (c'est-à-dire un objet Entity) dans une zone de pièce jointe. Un enregistrement représentant un défaut peut comporter plusieurs zones de pièce jointe, chaque zone pouvant contenir plusieurs fichiers joints. Par exemple, un enregistrement peut comporter trois zones de pièce jointe distincts : un pour les fichiers de code source, un pour les spécifications techniques et un pour la documentation.

Pour gérer des zones de pièce jointe, chaque objet Entity comporte un objet AttachmentFields. Pour gérer des pièces jointes individuelles, chaque zone de pièce jointe (AttachmentField) comporte un objet Attachments.

Pour passer d'un objet Entity à une pièce jointe, vous devez d'abord obtenir l'objet AttachmentFields. Lors de la transition, vous pouvez distinguer un chemin d'accès général en utilisant des noms de zone AttachmentField. Lorsque vous accédez au niveau d'une collection réelle de pièces jointes, vous pouvez identifier des pièces jointes individuelles à l'aide des valeurs Description et FileName.

Objets de pièce jointe (Attachement)
Description
Objet AttachmentField
Représente une zone de pièce jointe unique dans un enregistrement
Objet AttachmentFields
Objet de collection représentant les zones de pièce jointe dans un enregistrement
Objet Attachment
Stocke un fichier de pièce jointe et les informations associées
Objet Attachments
Objet de collection représentant un ensemble de pièces jointes dans une zone de pièces jointes d'un enregistrement

L'objet AttachmentFields est une collection d'objets AttachmentField. Il représente toutes les zones de pièce jointe associées à un enregistrement. Un seul objet AttachmentFields peut être associé à un enregistrement. Cet objet contient un ou plusieurs objets AttachmentField. Ses méthodes permettent d'accéder aux zones contenant des pièces jointes.

L'objet AttachmentField représente une zone de pièce jointe unique dans un enregistrement. Un enregistrement peut comporter plusieurs objets AttachmentField, chacun contenant un objet Attachments unique. Une zone AttachmentField peut inclure une collection de fichiers, dont chacun est stocké dans un objet Attachment individuel.

L'objet Attachments est un objet conteneur comportant un ou plusieurs objets Attachment. Un objet Attachments est toujours associé à un objet AttachmentField unique. Cet objet contient toutes les collections de la pièce jointe correspondante et dispose de méthodes pour compter, extraire, ajouter et supprimer des pièces jointes.

Un objet Attachment contient un fichier joint unique. Un objet Attachment contient des informations sur une pièce jointe donnée telles que sa description, le nom de fichier d'origine, la taille du fichier et elle fournit des méthodes de gestion de la pièce jointe.

Les méthodes de l'objet Entity suivantes permettent de stocker et de gérer les pièces jointes.

Pour plus d'informations, voir AttachmentFields de l'objet Entity et la section "Getting and setting attachment information"


Commentaire