Invoke Image Display

Overview

This feature helps the user of a non image-aware system like an EHR, PHR or RIS, to request the display of studies for a patient, and have the display performed by an image-aware system like an Image Display (PACS). More details related to RAD-106 Invoke Image Display can be found here.

Configuration

• The below configuration explained is in conjunction with open source Weasis Viewer Integration with archive.

Using Archive UI

1. Go to Menu->Configuration->Devices->dcm4chee-arc->Device Extension->Web Applications.
2. Select web application(s) and add following properties :

• Unsecured Archive or Secure Archive (only UI secured)

  • Invoke Image Display Patient URL:
    IID_PATIENT_URL=weasis://$dicom:rs --url "{{qidoBaseURL}}{{qidoBasePath}}" -r "patientID={{patientID}}" --query-ext "&includedefaults=false"
  • Invoke Image Display Study URL:
    IID_STUDY_URL=weasis://$dicom:rs --url "{{qidoBaseURL}}{{qidoBasePath}}" -r "studyUID={{studyUID}}" --query-ext "&includedefaults=false"

• Secure Archive (both UI and RESTful secured)

  • Invoke Image Display Patient URL:
    IID_PATIENT_URL=weasis://$dicom:rs --url "{{qidoBaseURL}}{{qidoBasePath}}" -r "patientID={{patientID}}" --query-ext "&includedefaults=false" -H "Authorization: Bearer {{access_token}}
  • Invoke Image Display Study URL:
    IID_STUDY_URL=weasis://$dicom:rs --url "{{qidoBaseURL}}{{qidoBasePath}}" -r "studyUID={{studyUID}}" --query-ext "&includedefaults=false" -H "Authorization: Bearer {{access_token}}"

• To avoid opening a new empty window in the web browser

  • IID_URL_TARGET=_self

and Save the configuration.

Using LDAP

One may either create a LDIF file and import it to the LDAP Server by using the ldapmodify command line utility.

• Unsecured Archive or Secure Archive (only UI secured)

  version: 1
  dn: dcmWebAppName=DCM4CHEE,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
  changetype: modify
  add: dcmProperty
  dcmProperty: IID_PATIENT_URL=weasis://$dicom:rs --url "{{qidoBaseURL}}{{qidoBasePath}}" -r "patientID={{patientID}}" --query-ext "&includedefaults=false"
  -
  
  dn: dcmWebAppName=DCM4CHEE,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
  changetype: modify
  add: dcmProperty
  dcmProperty: IID_STUDY_URL=weasis://$dicom:rs --url "{{qidoBaseURL}}{{qidoBasePath}}" -r "studyUID={{studyUID}}" --query-ext "&includedefaults=false"
  
  dn: dcmWebAppName=DCM4CHEE,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
  changetype: modify
  add: dcmProperty
  dcmProperty: IID_URL_TARGET=_self
  

• Secure Archive (both UI and RESTful secured)

  version: 1
  dn: dcmWebAppName=DCM4CHEE,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
  changetype: modify
  add: dcmProperty
  dcmProperty: IID_PATIENT_URL=weasis://$dicom:rs --url "{{qidoBaseURL}}{{qidoBasePath}}" -r "patientID={{patientID}}" --query-ext "&includedefaults=false" -H "Authorization: Bearer {{access_token}}
  -
  
  dn: dcmWebAppName=DCM4CHEE,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
  changetype: modify
  add: dcmProperty
  dcmProperty: IID_STUDY_URL=weasis://$dicom:rs --url "{{qidoBaseURL}}{{qidoBasePath}}" -r "studyUID={{studyUID}}" --query-ext "&includedefaults=false" -H "Authorization: Bearer {{access_token}}"
  
  dn: dcmWebAppName=DCM4CHEE,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
  changetype: modify
  add: dcmProperty
  dcmProperty: IID_URL_TARGET=_self
  

• or use the Add Attribute... and Add Value... function of Apache Directory Studio to add attributes on Device level (e.g.: dicomDeviceName=dcm4chee-arc) in the Archive Configuration.

Note

• For more about the URL parameters and for configuration before dcm4chee-arc-light 5.22.2, see this page.
• For Secure Archive (both UI and RESTful secured), if you want users with user role to see the images as well, then configure also User Role Access to Viewer

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

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

Testing

Once the configuration is reloaded one will be able to see the eye icon against the patient and/or study by expanding the 3 vertical dots icon against each of the patient/study as shown below :