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:

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:

1. 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>
   

2. 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>
   

3. Also Queries must be encoded with Explicit VR. E.g.:

   (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
   

   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)!