Difference between revisions of "The CTP XmlObject"
| (13 intermediate revisions by the same user not shown) | |||
| Line 3: | Line 3: | ||
<b>UID</b> | <b>UID</b> | ||
#the <b>uid</b> attribute of the root element | #the <b>uid</b> attribute of the root element | ||
| − | This attribute is required. The DICOM UID format is strongly suggested, but there is no technical requirement imposed by the the XmlObject on the format. | + | #the <b>uid</b> child element of the root element |
| + | #the <b>uid</b> attribute of the first child element of the root element | ||
| + | #<b>default</b>: the numerical string value of the MD5 hash of the text of the file. | ||
| + | This attribute is required. The DICOM UID format is strongly suggested, but there is no technical requirement imposed by the the XmlObject on the format. | ||
<b>Date</b> | <b>Date</b> | ||
| Line 9: | Line 12: | ||
#the <b>study-date</b> attribute of the root element | #the <b>study-date</b> attribute of the root element | ||
#the last-modified-date of the file | #the last-modified-date of the file | ||
| − | This value is technically not required, but since the object automatically supplies its last-modified-date | + | This value is technically not required, but since the object automatically supplies its last-modified-date if no other date is found, a date is always available. |
<b>Description</b> | <b>Description</b> | ||
#the <b>description</b> child element of the root element | #the <b>description</b> child element of the root element | ||
| − | #the <b>description</b> child of the first child of the root element | + | #the <b>description</b> child of the first child element of the root element |
This value is not required. | This value is not required. | ||
| Line 19: | Line 22: | ||
#the <b>pt-name</b> attribute of the root element | #the <b>pt-name</b> attribute of the root element | ||
#the <b>pt-name</b> child element of the root element | #the <b>pt-name</b> child element of the root element | ||
| − | #the <b>pt-name</b> child of the first child of the root element | + | #the <b>pt-name</b> child of the first child element of the root element |
This value is not required. | This value is not required. | ||
| Line 25: | Line 28: | ||
#the <b>pt-id</b> attribute of the root element | #the <b>pt-id</b> attribute of the root element | ||
#the <b>pt-id</b> child element of the root element | #the <b>pt-id</b> child element of the root element | ||
| − | #the <b>pt-id</b> child of the first child of the root element | + | #the <b>pt-id</b> child element of the first child element of the root element |
This value is technically not required, but it is required if the intent is to relate the object to other objects for the same patient. | This value is technically not required, but it is required if the intent is to relate the object to other objects for the same patient. | ||
| Line 33: | Line 36: | ||
#the <b>study-uid</b> child element of the root element | #the <b>study-uid</b> child element of the root element | ||
#the <b>StudyInstanceUID</b> child element of the root element | #the <b>StudyInstanceUID</b> child element of the root element | ||
| − | #the <b>study-uid</b> child of the first child of the root element | + | #the <b>study-uid</b> child element of the first child element of the root element |
| − | #the <b>StudyInstanceUID</b> child of the first child of the root element | + | #the <b>StudyInstanceUID</b> child element of the first child element of the root element |
| − | This value is technically not required, but it is required if the intent is to relate the object to other objects of the same study. The DICOM UID format is strongly suggested, but there is no technical requirement imposed by | + | This value is technically not required, but it is required if the intent is to relate the object to other objects of the same study. The DICOM UID format is strongly suggested, but there is no technical requirement imposed by the XmlObject on the format. Note that the DICOM UID format is required if the object is to be related to DicomObjects for the same study. |
Latest revision as of 14:57, 1 June 2010
The CTP XmlObject is an XML file in any XML schema. To be useful, such an object must contain certain identifiers which allow it to be related to other objects obtained in a trial. The XmlObject provides some flexibility in the placement of those identifiers. This article describes the order in which the XmlObject searches for the identifiers. In all cases, the value of an identifier is defined to be the value in the first place found.
UID
- the uid attribute of the root element
- the uid child element of the root element
- the uid attribute of the first child element of the root element
- default: the numerical string value of the MD5 hash of the text of the file.
This attribute is required. The DICOM UID format is strongly suggested, but there is no technical requirement imposed by the the XmlObject on the format.
Date
- the date attribute of the root element
- the study-date attribute of the root element
- the last-modified-date of the file
This value is technically not required, but since the object automatically supplies its last-modified-date if no other date is found, a date is always available.
Description
- the description child element of the root element
- the description child of the first child element of the root element
This value is not required.
Patient Name
- the pt-name attribute of the root element
- the pt-name child element of the root element
- the pt-name child of the first child element of the root element
This value is not required.
Patient ID
- the pt-id attribute of the root element
- the pt-id child element of the root element
- the pt-id child element of the first child element of the root element
This value is technically not required, but it is required if the intent is to relate the object to other objects for the same patient.
Study UID
- the study-uid attribute of the root element
- the StudyInstanceUID attribute of the root element
- the study-uid child element of the root element
- the StudyInstanceUID child element of the root element
- the study-uid child element of the first child element of the root element
- the StudyInstanceUID child element of the first child element of the root element
This value is technically not required, but it is required if the intent is to relate the object to other objects of the same study. The DICOM UID format is strongly suggested, but there is no technical requirement imposed by the XmlObject on the format. Note that the DICOM UID format is required if the object is to be related to DicomObjects for the same study.