Accessing external archive Web Services - dcm4che/dcm4chee-arc-light GitHub Wiki

Configuration

If the external archive supports DICOM Web Services, configuration of a http network connection is required.

Using Archive UI

  • Configure a http network connection for the external archive : Go to Configuration page -> Devices tab -> dcm4chee-arc -> Child Objects -> Network Connections -> Add new Network Connection. Specify a Name, Hostname shall be IP address or host name where your external archive is running. Port shall be the http port which is enabled for the external archive and Save. Next go to its Extensions and add Network Connection Extension; select Protocol as HTTP and Save.
  • Add a Web Application for QIDO, WADO, STOW DICOM Web Services on external archive : Go to Configuration page -> Devices tab -> dcm4chee-arc -> Device Extension -> Child Objects -> Web Application -> Add new Web Application. Specify
    • Web Application name
    • Web Service Path : /dcm4chee-arc/aets/DCM4CHEE_CLONE/rs (Replace DCM4CHEE_CLONE by AE of your external archive)
    • Web Service Classes : WADO_RS, STOW_RS, and QIDO_RS.
    • AE Title : DCM4CHEE_CLONE (Replace DCM4CHEE_CLONE by AE of your external archive) and Save.
  • Add a Web Application for WADO_URI on external archive : Go to Configuration page -> Devices tab -> dcm4chee-arc -> Device Extension -> Child Objects -> Web Application -> Add new Web Application. Specify
    • Web Application name
    • Web Service Path : /dcm4chee-arc/aets/DCM4CHEE_CLONE/wado (Replace DCM4CHEE_CLONE by AE of your external archive)
    • Web Service Classes : WADO_URI
    • AE Title : DCM4CHEE_CLONE (Replace DCM4CHEE_CLONE by AE of your external archive) and Save.

Using LDAP

One may either

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

      version: 1
      
      dn: cn=http,dicomDeviceName=dcm4chee-arc-2,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
      objectClass: dicomNetworkConnection
      objectClass: dcmNetworkConnection
      dicomHostname: localhost
      cn: http
      dcmProtocol: HTTP
      dicomPort: 8880
      
      dn: dcmWebAppName=DCM4CHEE_CLONE,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
      dicomDescription: Hide instances rejected for Quality Reasons
      dcmWebServiceClass: WADO_RS
      dcmWebServiceClass: STOW_RS
      dcmWebServiceClass: QIDO_RS
      objectClass: dcmWebApp
      dicomAETitle: DCM4CHEE_CLONE
      dcmWebAppName: DCM4CHEE_CLONE
      dcmWebServicePath: /dcm4chee-arc/aets/DCM4CHEE_CLONE/rs
    
      dn: dcmWebAppName=DCM4CHEE-WADO_CLONE,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
      dicomDescription: Hide instances rejected for Quality Reasons
      dcmWebServiceClass: WADO_URI
      objectClass: dcmWebApp
      dicomAETitle: DCM4CHEE_CLONE
      dcmWebAppName: DCM4CHEE-WADO_CLONE
      dcmWebServicePath: /dcm4chee-arc/aets/DCM4CHEE_CLONE/wado
    

    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-arc2) in the Archive Configuration.

Refer to Web Application and Network Connection
to understand the description of attributes.

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

Tests

  • Go to Navigation page -> Studies tab, select DCM4CHEE_CLONE from Web App Service dropdown and proceed with :
    • SUBMIT : To see list of studies.
    • On any of the Study from the list :
      • Toggle Attributes : To view the study attributes.
      • Upload file : To upload either an image, video or pdf file to study.
      • Show Series : To see series of study.
    • On any of the Series of Study from the list :
      • Show Attributes : To view the series attributes.
      • Show Instances : To see instances of series.
    • On any of the Instance of Series from the list :
      • Show Attributes : To view the instance attributes.
      • Download DICOM object : To retrieve DICOM object as stored at the archive. CURRENTLY NOT WORKING
      • Download Uncompressed DICOM object : To retrieve uncompressed DICOM object. CURRENTLY NOT WORKING
      • View DICOM object : To view the DICOM object as image, video or pdf.
    • From More functions dropdown :
      • Upload DICOM object : To upload/store one or more DICOM objects to archive.
⚠️ **GitHub.com Fallback** ⚠️