DICOM Attribute Filter
The Attribute filter defines which attributes of the DICOM header are written into the BLOB field of patient/study/series/instance level and are therefore accessible during C-FIND.
It supports the configuration of up to 3 additional matching key on PATIENT, STUDY, SERIES and INSTANCE Level, configurable in conf/dcm4chee-attribute-filter.xml by new XML attribute field of <attr> element, which defines which DB column shall be mapped to this attribute to support it as matching key in DICOM Queries. Possible values for attribute field depends on the entity level:
Level |
field value1 |
field value2 |
field value3 |
<patient> |
|
|
|
<study> |
|
|
|
<seriest> |
|
|
|
<instance> |
|
|
|
Example:
<dcm4chee-attribute-filter> [..] <series> [..] <attr tag="00180010" field="seriesCustomAttribute1"/> <\!-\- Contrast/Bolus Agent \--> [..] </series> [..] </dcm4chee-attribute-filter>
will configure support of (0018,0010) Contrast/Bolus Agentas matching key on SERIES level
It is also possible to add private Attributes to custom_fields on study/series/instance level by:
- Using the absolute tag value and also adding an entry for the corresponding Private Creator ID in
conf/dcm4chee-attribute-filter.xml
. E.g.:<study> : <attr tag="00990010"/> <!-- Private Creator ID --> <attr tag="00991015" field="studyCustomAttribute1"/> <!-- Private Attribute --> : </study>
- Objects must not be stored with Implicit VR Little Endian - except, if the private attribute is added by a configured C-STORE RQ coercion in
conf/dcm4chee-ae/MOD_AET/cstorerq.xsl
. E.g.:<xsl:template match="/dataset"> <dataset> <xsl:variable name="bodypartexamined" select="normalize-space(attr[@tag='00180015'])"/> <xsl:if test="$bodypartexamined"> <attr tag="00990010" vr="LO">DCM4CHEE</attr> <attr tag="00991015" vr="CS"> <xsl:value-of select="$bodypartexamined"/> </attr> </xsl:if> </dataset> </xsl:template>
- Also Queries must be encoded with Explicit VR. E.g.:
Attention: At default configuration, only Transfer Syntax: Implicit VR Little Endian is accepted by the Query Retrieve Service of dcm4chee-archive for Standard Query Retrieve Services (QueryRetrieveSCP.AcceptedTransferSyntaxForStandardSOPClasses=ImplicitVRLittleEndian)!
(0008,0020) DA #0 \[\] Study Date (0008,0030) TM #0 \[\] Study Time (0008,0050) SH #0 \[\] Accession Number (0008,0052) CS #6 [STUDY] Query/Retrieve Level (0020,000D) UI #0 \[\] Study Instance UID (0020,0010) SH #0 \[\] Study ID (0020,1206) IS #0 \[\] Number of Study Related Series (0020,1208) IS #0 \[\] Number of Study Related Instances (0099,0010) LO #8 [DCM4CHEE] Private Creator Data Element (0099,1015) CS #8 [ABDOMEN] Private Attribute