Merge or Nullify Dataset Attributes - dcm4che/dcm4chee-arc-light GitHub Wiki

This page briefly guides and acquaints the user with coercion type to merge or nullify DICOM dataset attributes' values.

Content

Brief Description

A DICOM dataset coming in or going out of the archive may have one or more missing or incorrectly valued DICOM attributes in it. Merge or nullify such attributes with help of a Merge or nullify dataset attributes coercion type.

Refer

Applicability using Archive Attribute Coercion rules

New Archive Attribute Coercion or Legacy Archive Attribute Coercions can be used to merge or nullify DICOM attributes in :

  • incoming C-STORE requests on receive of DICOM objects to archive sent from external systems
  • outgoing C-STORE requests on sending DICOM objects from archive to external systems
  • incoming (MWL) C-FIND requests to archive
  • incoming (MWL) C-FIND responses to archive
  • outgoing (MWL) C-FIND requests from archive
  • incoming MPPS N-CREATE requests to archive

Note : Legacy Archive Attribute Coercions can not be used to nullify Issuer of Patient ID (0010,0021) and Issuer of Patient ID Qualifiers Sequence (0010,0024) DICOM attributes as there are separate configuration fields to handle their nullification.

Configurable fields on Archive Attribute Coercion rules

Merging or nullifying dataset attributes can be applied using either :

(Recommended) DICOM Attribute Coercion Parameters field with Attribute Coercion URI as merge-attrs: on New Archive Attribute Coercion

OR

Using Legacy Archive Attribute Coercion fields

See

Merge Attributes Formatting Options

  • Applicable format {attributeID}={value} wherein specified {attributeID} can be a Keyword or Tag number, some examples :
    • PatientID=JMS{PatientID}
    • PatientID={PatientID,slice,3}
    • IssuerOfPatientID={00100010,hash}-{00100030}
  • {attributeID} inside {value} will be replaced by the value of that attribute in the original dataset.
  • To nullify an attribute, just specify attribute without any value {attributeID}=, for example :

Formatting options available to merge DICOM dataset attributes are :

Attributes format Meaning Example
slice Slice attribute value from a certain index / position
(optionally upto an end index / position)		 PatientID={PatientID,slice,3}
PatientID={PatientID,slice,3[,7]}
hash Hash the value of specified attribute IssuerOfPatientID={00100010,hash}-{00100030}
AccessionNumber=ACC-{StudyInstanceUID,hash}
upper Convert specified attribute's value to upper case AccessionNumber={AccessionNumber,upper}
Add a custom footer
⚠️ **GitHub.com Fallback** ⚠️