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).
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.
DCM4CHEE 5 Documentation