IBM® Rational® ClearQuest®에서 사용자는 첨부 필드에서 레코드(즉, Entity 오브젝트)에 파일을 첨부할 수 있습니다. 결함을 표시하는 레코드에는 여러 개의 첨부 필드가 있을 수 있으며, 각 필드마다 첨부된 파일이 여러 개 있을 수 있습니다. 예를 들어, 레코드에 별개의 첨부 필드가 세 개 있을 수 있습니다(하나는 소스 코드 파일용, 또 하나는 엔지니어링 스펙용, 나머지는 문서용).
첨부 필드를 관리할 수 있도록 각 Entity 오브젝트마다 AttachmentFields 오브젝트가 있습니다. 개별 첨부를 관리할 수 있도록 각 AttachmentField마다 Attachments 오브젝트가 있습니다.
Entity 오브젝트에서 Attachment로 순회하려면 먼저 AttachmentFields 오브젝트를 가져와야 합니다. 순회할 때 AttachmentField 이름을 사용하여 일반 경로를 구별할 수 있습니다. 실제 첨부 콜렉션 레벨에 있는 경우, 설명 및 FileName 값을 사용하여 개별 첨부를 식별할 수 있습니다.
AttachmentFields 오브젝트는 AttachmentField 오브젝트의 콜렉션입니다. 레코드와 연관된 첨부 필드를 모두 표시합니다. 레코드와 연관된 AttachmentFields 오브젝트가 하나만 있을 수 있습니다. 이 오브젝트는 하나 이상의 AttachmentField 오브젝트를 포함합니다. 오브젝트의 메소드는 첨부가 들어 있는 필드에 대한 액세스를 제공합니다.
AttachmentField 오브젝트는 레코드의 단일 첨부 필드를 표시합니다. 레코드에는 각각 단일 Attachments 오브젝트를 포함하는 AttachmentField 오브젝트가 여러 개 있을 수 있습니다. AttachmentField는 각각 개별 Attachment 오브젝트에 저장된 파일 콜렉션을 보유할 수 있습니다.
Attachments 오브젝트는 하나 이상의 Attachment 오브젝트를 저장하는 컨테이너 오브젝트입니다. Attachments 오브젝트는 항상 단일 AttachmentField 오브젝트와 연관됩니다. 이 오브젝트는 해당 첨부 필드가 갖고 있는 콜렉션을 모두 포함하며 첨부를 계수, 가져오기, 추가 및 삭제할 수 있는 메소드를 제공합니다.
Attachment 오브젝트는 첨부된 단일 파일을 포함합니다. Attachment 오브젝트는 설명, 원래의 파일 이름, 파일 크기와 같은 특정 첨부에 대한 정보를 포함하며, 첨부 오퍼레이션 방법을 제공합니다.
다음 Entity 오브젝트 메소드는 첨부 저장 및 관리에 사용됩니다.
액세스 오브젝트를 가져옵니다. 모든 Entity 오브젝트는 첨부 필드를 관리하는 메소드가 있는 단 하나의 AttachmentFields 오브젝트를 갖습니다.
이 오브젝트에 대해 정의된 필드 이름을 가져옵니다. AttachmentFields 오브젝트를 사용하여 첨부 콜렉션을 순회할 때 따를 경로를 식별할 수 있도록 필드 이름을 알 필요가 있습니다(또는 색인을 사용하여 각 AttachmentField를 가져올 수 있음).
필드의 데이터 유형을 가져옵니다. 리턴 값이 7(_ATTACHMENT_LIST)이면, 필드는 AttachmentField 유형입니다. 이는 필드 이름은 알지만 데이터 유형은 모를 경우에 유용합니다.
이 오브젝트의 모든 필드에 대한 정보를 가져옵니다. FieldInfo.GetValue() 및 FieldInfo.GetValueAsList()를 사용하여 기타 값 유형을 페치하므로 이는 일반적으로 수행하는 작업입니다. FieldInfo 오브젝트 배열이 없는 경우, FieldInfo.GetName()을 사용하여 각 이름을 가져오고 FieldInfo.GetType()을 사용하여 각 데이터 유형을 확인할 수 있습니다.
자세한 정보는 Entity 오브젝트의 AttachmentFields 및 "첨부 정보 가져오기 및 설정"을 참조하십시오.