How to configure Imaging Object Change Management

vrindanayak edited this page Oct 12, 2016 · 3 revisions
Clone this wiki locally

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. 251ff).

IOCM Configuration Basics

To understand the IOCM configuration, we explain configuration of two objects of dcm4chee-arc Device i.e. QueryRetrieveView and RejectionNote.

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

One has to configure query retrieve views and map them to the application entity titles as explained below. This mapping is done as each application entity of archive has a query retrieve view associated with it.

For query retrieve views, you may

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

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

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

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

For mapping the views with application entities of archive, you may

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

    version: 1
    dn: dicomAETitle=DCM4CHEE,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmQueryRetrieveViewID
    dcmQueryRetrieveViewID: hideRejected
    -
    
    dn: dicomAETitle=DCM4CHEE,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dicomDescription
    dicomDescription: Hide instances rejected for Quality Reasons
    -
    
    dn: dicomAETitle=DCM4CHEE_ADMIN,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmQueryRetrieveViewID
    dcmQueryRetrieveViewID: regularUse
    -
    
    dn: dicomAETitle=DCM4CHEE_ADMIN,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dicomDescription
    dicomDescription: Show instances rejected for Quality Reasons
    -
    
    dn: dicomAETitle=DCM4CHEE_TRASH,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmQueryRetrieveViewID
    dcmQueryRetrieveViewID: trashView
    -
    
    dn: dicomAETitle=DCM4CHEE_TRASH,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dicomDescription
    dicomDescription: Show rejected instances only
    -
    

    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

You may

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

    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
    dcmDeleteRejectedInstanceDelay: PT1M
    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
    dcmAcceptPreviousRejectedInstance: REJECT
    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
    -
    

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

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

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