Accessing external archive Web Services

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.