Coercion BasicsCoercion is the process of manipulating DICOM tags during the incoming DICOM C-STORE to the OnePacs Gateway. Coercion rules are defined as XSL transformations in <OPG_HOME>\server\default\conf\dcm4chee-ae\cstorerq.xsl. Applying coerced tags to instances forwarded to the cloudIn order for the forwarded instances to include the changes in the coercion rules, one of the following must be done. Save the DICOM coercion changes to the instances before they are written to diskThe StoreSCP must be modified to set CoerceBeforeWrite to true.
Coerce the outbound instances with the coerced values from the databaseAlternatively, to leave the incoming files as-is and coerce the outbound instances, the <OPG_HOME>\server\default\conf\dcm4chee-ae\out-cstorerq.xsl file can be modified. The following XSL in the dataset element would overwrite tag ( Modify outbound coercion in out-cstorerq.xsl
Example: Fixing illegal DICOM tag (0028,0008) "Number of Frames" with value of -1
Example: Called AE TitleThe following XSL could be added to the "dataset" element in the cstorerq.xsl file to place the called AE title into tag (0032,1021):
Example: Calling AE TitleThe following XSL could be added to the "dataset" element in the cstorerq.xsl file to place the calling AE title in tag (0032,1021):
Other tags, more complex rulesIt's possible to use DICOM coercion to make more advanced manipulation of DICOM tags. Please make sure you completely understand coercion rules and facility distribution rules before making custom DICOM coercion changes. |