Skip to content

Imaging Object Change Management

Vrinda edited this page Mar 27, 2023 · 1 revision

dcm4chee-arc 5 supports the IHE Imaging Object Change Management Integration Profile as Image Manager/Image Archive (s. IHE Radiology Technical Framework, Volume 1, p. 234ff).

IOCM Configuration Basics

Instances can be marked for deletion for reasons : Data Retention Policy Expired, Incorrect Modality Worklist Entry, Rejected for Patient Safety Reasons, Rejected for Quality Reasons.

QueryRetrieveView : Following query retrieve views are available by default configuration. These are then mapped to the respective Application Entities.

  • Archive version 5.13.3 onwards

          version: 1
          dn: dcmQueryRetrieveViewID=hideRejected,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dcmHideRejectionNoteWithCode: (113039, DCM, "Data Retention Policy Expired")
          dcmQueryRetrieveViewID: hideRejected
          objectClass: dcmQueryRetrieveView
          -
          
          dn: dcmQueryRetrieveViewID=regularUse,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dcmQueryRetrieveViewID: regularUse
          objectClass: dcmQueryRetrieveView
          dcmShowInstancesRejectedByCode: (113001, DCM, "Rejected for Quality Reasons")
          -
    
          dn: dcmQueryRetrieveViewID=rejectedForQualityReasons,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dcmHideNotRejectedInstances: TRUE
          dcmQueryRetrieveViewID: rejectedForQualityReasons
          objectClass: dcmQueryRetrieveView
          dcmShowInstancesRejectedByCode: (113001, DCM, "Rejected for Quality Reasons")
          -
          
          dn: dcmQueryRetrieveViewID=dataRetentionPolicyExpired,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dcmHideNotRejectedInstances: TRUE
          dcmQueryRetrieveViewID: dataRetentionPolicyExpired
          objectClass: dcmQueryRetrieveView
          dcmShowInstancesRejectedByCode: (113039, DCM, "Data Retention Policy Expired")
          -
          
          dn: dcmQueryRetrieveViewID=incorrectModalityWorklistEntry,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dcmHideNotRejectedInstances: TRUE
          dcmQueryRetrieveViewID: incorrectModalityWorklistEntry
          objectClass: dcmQueryRetrieveView
          dcmShowInstancesRejectedByCode: (113038, DCM, "Incorrect Modality Worklist Entry")
          -
          
          dn: dcmQueryRetrieveViewID=rejectedForPatientSafetyReasons,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dcmHideNotRejectedInstances: TRUE
          dcmQueryRetrieveViewID: rejectedForPatientSafetyReasons
          objectClass: dcmQueryRetrieveView
          dcmShowInstancesRejectedByCode: (113037, DCM, "Rejected for Patient Safety Reasons")
          -
    
  • Upto archive version 5.13.2

          version: 1
          dn: dcmQueryRetrieveViewID=hideRejected,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          objectClass: dcmQueryRetrieveView
          dcmQueryRetrieveViewID: hideRejected
          dcmHideRejectionNoteWithCode: (113039, DCM, "Data Retention Policy Expired")
          -
          
          dn: dcmQueryRetrieveViewID=regularUse,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          objectClass: dcmQueryRetrieveView
          dcmQueryRetrieveViewID: regularUse
          dcmHideRejectionNoteWithCode: (113039, DCM, "Data Retention Policy Expired")
          dcmShowInstancesRejectedByCode: (113001, DCM, "Rejected for Quality Reasons")
          -
    
          dn: dcmQueryRetrieveViewID=trashView,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          objectClass: dcmQueryRetrieveView
          dcmQueryRetrieveViewID: trashView
          dcmHideNotRejectedInstances: TRUE
          dcmShowInstancesRejectedByCode: (113001, DCM, "Rejected for Quality Reasons")
          dcmShowInstancesRejectedByCode: (113037, DCM, "Rejected for Patient Safety Reasons")
          dcmShowInstancesRejectedByCode: (113038, DCM, "Incorrect Modality Worklist Entry")
          dcmShowInstancesRejectedByCode: (113039, DCM, "Data Retention Policy Expired")
          -
    

One may refer to Query Retrieve View to understand the description of attributes.

Mapping of query retrieve views with application entities of archive

  • Archive version 5.13.3 onwards

          version: 1
          dn: dicomAETitle=DCM4CHEE,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dicomNetworkConnectionReference: cn=dicom,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dcmQueryRetrieveViewID: hideRejected
          dicomDescription: Hide instances rejected for Quality Reasons
          dicomAssociationInitiator: TRUE
          dcmObjectStorageID: fs1
          dicomAssociationAcceptor: TRUE
          dicomAETitle: DCM4CHEE
          objectClass: dicomNetworkAE
          objectClass: dcmNetworkAE
          objectClass: dcmArchiveNetworkAE
          dcmAcceptedUserRole: user
          dcmAcceptedUserRole: admin
          -
    
          dn: dicomAETitle=AS_RECEIVED,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dicomAssociationInitiator: TRUE
          dicomDescription: Retrieve instances as received
          dcmAcceptedUserRole: admin
          dcmQueryRetrieveViewID: regularUse
          objectClass: dicomNetworkAE
          objectClass: dcmNetworkAE
          objectClass: dcmArchiveNetworkAE
          dicomNetworkConnectionReference: cn=dicom,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dicomAETitle: AS_RECEIVED
          dicomAssociationAcceptor: TRUE
          -
          
          dn: dicomAETitle=IOCM_REGULAR_USE,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dicomAssociationInitiator: TRUE
          dicomDescription: Show instances rejected for Quality Reasons
          dcmAcceptedUserRole: admin
          dcmQueryRetrieveViewID: regularUse
          objectClass: dicomNetworkAE
          objectClass: dcmNetworkAE
          objectClass: dcmArchiveNetworkAE
          dicomNetworkConnectionReference: cn=dicom,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dicomAETitle: IOCM_REGULAR_USE
          dicomAssociationAcceptor: TRUE
          -
          
          dn: dicomAETitle=IOCM_EXPIRED,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dicomAssociationInitiator: TRUE
          dicomDescription: Only show instances rejected for Data Retention Expired
          dcmAcceptedUserRole: user
          dcmAcceptedUserRole: admin
          dcmQueryRetrieveViewID: dataRetentionPolicyExpired
          objectClass: dicomNetworkAE
          objectClass: dcmNetworkAE
          objectClass: dcmArchiveNetworkAE
          dicomNetworkConnectionReference: cn=dicom,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dicomAETitle: IOCM_EXPIRED
          dicomAssociationAcceptor: TRUE
          -
          
          dn: dicomAETitle=IOCM_QUALITY,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dicomAssociationInitiator: TRUE
          dicomDescription: Only show instances rejected for Quality Reasons
          dcmAcceptedUserRole: admin
          dcmQueryRetrieveViewID: rejectedForQualityReasons
          objectClass: dicomNetworkAE
          objectClass: dcmNetworkAE
          objectClass: dcmArchiveNetworkAE
          dicomNetworkConnectionReference: cn=dicom,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dicomAETitle: IOCM_QUALITY
          dicomAssociationAcceptor: TRUE
          -
          
          dn: dicomAETitle=IOCM_WRONG_MWL,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dicomAssociationInitiator: TRUE
          dicomDescription: Only show instances rejected for Incorrect Modality Worklist Entry
          dcmAcceptedUserRole: admin
          dcmQueryRetrieveViewID: incorrectModalityWorklistEntry
          objectClass: dicomNetworkAE
          objectClass: dcmNetworkAE
          objectClass: dcmArchiveNetworkAE
          dicomNetworkConnectionReference: cn=dicom,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dicomAETitle: IOCM_WRONG_MWL
          dicomAssociationAcceptor: TRUE
          -
          
          dn: dicomAETitle=IOCM_PAT_SAFETY,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dicomAssociationInitiator: TRUE
          dicomDescription: Only show instances rejected for Patient Safety Reasons
          dcmAcceptedUserRole: admin
          dcmQueryRetrieveViewID: rejectedForPatientSafetyReasons
          objectClass: dicomNetworkAE
          objectClass: dcmNetworkAE
          objectClass: dcmArchiveNetworkAE
          dicomNetworkConnectionReference: cn=dicom,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dicomAETitle: IOCM_PAT_SAFETY
          dicomAssociationAcceptor: TRUE
          -
    
  • Upto archive version 5.13.2

          version: 1
          dn: dicomAETitle=DCM4CHEE,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dicomNetworkConnectionReference: cn=dicom,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dcmQueryRetrieveViewID: hideRejected
          dicomDescription: Hide instances rejected for Quality Reasons
          dicomAssociationInitiator: TRUE
          dcmObjectStorageID: fs1
          dicomAssociationAcceptor: TRUE
          dicomAETitle: DCM4CHEE
          objectClass: dicomNetworkAE
          objectClass: dcmNetworkAE
          objectClass: dcmArchiveNetworkAE
          dcmAcceptedUserRole: user
          dcmAcceptedUserRole: admin
          -
    
          dn: dicomAETitle=DCM4CHEE_ADMIN,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dicomAssociationInitiator: TRUE
          dicomDescription: Show instances rejected for Quality Reasons
          dcmAcceptedUserRole: admin
          dcmQueryRetrieveViewID: regularUse
          objectClass: dicomNetworkAE
          objectClass: dcmNetworkAE
          objectClass: dcmArchiveNetworkAE
          dicomNetworkConnectionReference: cn=dicom,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dicomAETitle: DCM4CHEE_ADMIN
          dicomAssociationAcceptor: TRUE
          -
          
          dn: dicomAETitle=DCM4CHEE_TRASH,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dicomAssociationInitiator: TRUE
          dicomDescription: Show rejected instances only
          dcmAcceptedUserRole: admin
          dcmQueryRetrieveViewID: trashView
          objectClass: dicomNetworkAE
          objectClass: dcmNetworkAE
          objectClass: dcmArchiveNetworkAE
          dicomNetworkConnectionReference: cn=dicom,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          dicomAETitle: DCM4CHEE_TRASH
          dicomAssociationAcceptor: TRUE
          -
    

    and import it to the LDAP Server by using the ldapmodify command line utility.

One may refer to Archive Network AE to understand the description of attributes.

RejectionNote : Following rejection notes are available by default configuration.

    version: 1
	dn: dcmRejectionNoteLabel=Incorrect MWL Entry,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
	objectClass: dcmRejectionNote
	dcmRejectionNoteCode: (113038, DCM, "Incorrect Modality Worklist Entry")
	dcmRejectionNoteLabel: Incorrect MWL Entry
	dcmAcceptPreviousRejectedInstance: REJECT
	dcmOverwritePreviousRejection: (113001, DCM, "Rejected for Quality Reasons")
	dcmOverwritePreviousRejection: (113037, DCM, "Rejected for Patient Safety Reasons")
	dcmRejectionNoteType: INCORRECT_MODALITY_WORKLIST_ENTRY
    -

	dn: dcmRejectionNoteLabel=Patient Safety,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
	objectClass: dcmRejectionNote
	dcmRejectionNoteCode: (113037, DCM, "Rejected for Patient Safety Reasons")
	dcmRejectionNoteLabel: Patient Safety
	dcmOverwritePreviousRejection: (113001, DCM, "Rejected for Quality Reasons")
	dcmRejectionNoteType: REJECTED_FOR_PATIENT_SAFETY_REASONS
    -

	dn: dcmRejectionNoteLabel=Quality,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
	objectClass: dcmRejectionNote
	dcmRejectionNoteCode: (113001, DCM, "Rejected for Quality Reasons")
	dcmRejectionNoteLabel: Quality
	dcmAcceptPreviousRejectedInstance: IGNORE
	dcmRejectionNoteType: REJECTED_FOR_QUALITY_REASONS
    -

	dn: dcmRejectionNoteLabel=Retention Expired,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
	objectClass: dcmRejectionNote
	dcmRejectionNoteCode: (113039, DCM, "Data Retention Policy Expired")
	dcmRejectionNoteLabel: Retention Expired
	dcmAcceptPreviousRejectedInstance: RESTORE
	dcmDeleteRejectedInstanceDelay: P1D
	dcmDeleteRejectionNoteDelay: P1D
	dcmOverwritePreviousRejection: (113001, DCM, "Rejected for Quality Reasons")
	dcmOverwritePreviousRejection: (113037, DCM, "Rejected for Patient Safety Reasons")
	dcmOverwritePreviousRejection: (113038, DCM, "Incorrect Modality Worklist Entry")
	dcmRejectionNoteType: DATA_RETENTION_POLICY_EXPIRED
    -
	
	dn: dcmRejectionNoteLabel=Revoke Rejection,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
	objectClass: dcmRejectionNote
	dcmRejectionNoteCode: (REVOKE_REJECTION, 99DCM4CHEE, "Restore rejected Instances")
	dcmRejectionNoteLabel: Revoke Rejection
	dcmOverwritePreviousRejection: (113001, DCM, "Rejected for Quality Reasons")
	dcmOverwritePreviousRejection: (113037, DCM, "Rejected for Patient Safety Reasons")
	dcmOverwritePreviousRejection: (113038, DCM, "Incorrect Modality Worklist Entry")
	dcmOverwritePreviousRejection: (113039, DCM, "Data Retention Policy Expired")
	dcmRejectionNoteType: REVOKE_REJECTION
    -

One may refer to Rejection Note to understand the description of attributes.

Refer ISO-8601 Duration format for more know-how on Durations.

Configuration for Auto Deletion of Rejected Instances or Rejection Notes

One may either

  • create a LDIF file (e.g.):

          version: 1
          dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          changetype: modify
          add: dcmDeleteRejectedPollingInterval
          dcmDeleteRejectedPollingInterval: PT5M
          -
          
          dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          changetype: modify
          add: dcmDeleteRejectedFetchSize
          dcmDeleteRejectedFetchSize: 10
          -
    
          dn: dcmRejectionNoteLabel=Incorrect MWL Entry,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          changetype: modify
          add: dcmDeleteRejectedInstanceDelay
          dcmDeleteRejectedInstanceDelay: PT1M
          -
    
          dn: dcmRejectionNoteLabel=Incorrect MWL Entry,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
          changetype: modify
          add: dcmDeleteRejectionNoteDelay
          dcmDeleteRejectionNoteDelay: PT1M
          -
    

    and import it to the LDAP Server by using the ldapmodify command line utility.

  • or use the Add Attribute... and Add Value... function of Apache Directory Studio to add attributes on Device Level (e.g.: dicomDeviceName=dcm4chee-arc) and on or more Rejection Note level (e.g.: dcmRejectionNoteLabel=Incorrect MWL Entry) of the Archive Configuration.

One may refer to Archive Device and Rejection Note to understand the description of attributes.

Refer ISO-8601 Duration format for more know-how on Durations.

Go to the Control tab on Configuration page in archive UI and reload the configuration.

Clone this wiki locally