Accessing Own Archive - dcm4che/dcm4chee-arc-light GitHub Wiki

Configuration

The default configuration of archive already provides the below two Web Applications.

Using Archive UI

  • Add a Web Application for QIDO, WADO, STOW and all other proprietary DCM4CHEE Archive RESTful services. 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/rs (Replace DCM4CHEE by your AE if you have renamed the AE
    • Web Service Classes : WADO_RS, STOW_RS, QIDO_RS, QIDO_COUNT and DCM4CHEE_ARC_AET
    • AE Title : DCM4CHEE (Replace DCM4CHEE by your AE if you have renamed the AE and Save.
  • Add a Web Application for WADO_URI: 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/wado (Replace DCM4CHEE by your AE if you have renamed the AE
    • Web Service Classes : WADO_URI
    • AE Title : DCM4CHEE (Replace DCM4CHEE by your AE if you have renamed the AE and Save.

Using LDAP

One may either

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

      version: 1
      dn: dcmWebAppName=DCM4CHEE,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
      dcmWebServiceClass: QIDO_COUNT
      dcmWebServiceClass: DCM4CHEE_ARC_AET
      objectClass: dcmWebApp
      dicomAETitle: DCM4CHEE
      dcmWebAppName: DCM4CHEE
      dcmWebServicePath: /dcm4chee-arc/aets/DCM4CHEE/rs
    
      dn: dcmWebAppName=DCM4CHEE-WADO,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
      dcmWebAppName: DCM4CHEE-WADO
      dcmWebServicePath: /dcm4chee-arc/aets/DCM4CHEE/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-arc) in the Archive Configuration.

Refer to Web Application 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 from Web App Service dropdown, (you may specify one or more filters) and proceed with :
    • SUBMIT : To see list of studies.
    • COUNT : To see count of studies.
    • SIZE : To see size of studies.
    • On any of the Study from the list :
      • Toggle Attributes : To view the study attributes.
      • Edit this Study : To update one or more study attributes.
      • Set/Change Expired Date : To retain study until a certain period in future.
      • Verify Storage Commitment : To schedule storage verification of study.
      • Export Study : To export study to a remote destination (eg. storescp utility) using
        • Synchronised DICOM exporter
        • Queued exporter : DICOM Exporter configuration required.
      • Download as CSV : To save list of series of study as a CSV file.
      • Upload file : To upload either an image, video or pdf file to study.
      • Retrieve Study as stored at the archive : To retrieve study as stored at the archive as a zip file.
      • Retrieve Study uncompressed : To retrieve uncompressed study as a zip file.
      • Show Series : To see series of study.
      • Delete study permanently : To delete a study permanently. (Allow Delete Study Permanently configuration required)
      • Reject Study : To reject a study.
    • On any of the Series of Study from the list :
      • Show Attributes : To view the series attributes.
      • Verify Storage Commitment : To schedule storage verification of series.
      • Export Series : To export series to a remote destination (eg. storescp utility) using
        • Synchronised DICOM exporter
        • Queued exporter : DICOM Exporter configuration required.
      • Download as CSV : To save list of instances of series as a CSV file.
      • Retrieve Series as stored at the archive : To retrieve series as stored at the archive as a zip file.
      • Retrieve Series uncompressed : To retrieve uncompressed series as a zip file.
      • Show Instances : To see instances of series.
    • On any of the Instance of Series from the list :
      • Show Attributes : To view the instance attributes as stored in database.
      • Show Attributes from file : To view the instance attributes from DICOM file.
      • Verify Storage Commitment : To schedule storage verification of instance.
      • Export Instance : To export instance to a remote destination (eg. storescp utility) using
        • Synchronised DICOM exporter
        • Queued exporter : DICOM Exporter configuration required.
      • Download DICOM object : To retrieve DICOM object as stored at the archive.
      • Download Uncompressed DICOM object : To retrieve uncompressed DICOM object.
      • 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.
      • Export matching studies : To export all of the matching studies to a remote destination (eg. storescp utility) using Queued DICOM Exporter configuration.
      • Storage Verification : To schedule storage verification of all matching studies.
      • Download Studies as CSV : To save list of all matching studies as a CSV file.
      • Reject matching studies : To reject all matching studies.
    • Select Toggle checkboxes from Actions for selections dropdown
      • Select any study/series/instance and Mark selected study for copy. Next select any other Patient or Study and Start process of copying/moving/linking or merging and Copy
      • Select any study/series/instance and Mark selected study for move. Next select any other Patient or Study and Start process of copying/moving/linking or merging; next Select rejected type and Move.
      • Select any study/series/instance and Mark selected study for linking with MWL. Next go to MWLs tab and SUBMIT to see list of Modality Worklist entries. Select a MWL and Start process of copying/moving/linking or merging; next Select rejected type and Link.
  • Select Patients tab, (you may specify one or more filters) and proceed with :
    • SUBMIT : To see list of patients.
    • COUNT : To see count of patients.
    • On any of the Patient from the list :
      • Toggle Attributes : To view the patient attributes.
      • Edit this Patient : To update one or more patient attributes.
      • Add new MWL : To update one or more patient attributes.
      • Upload file : To upload either an image, video or pdf file to patient.
      • Download as CSV : To save list of studies of patient as a CSV file.
      • Show Studies : To see studies of patient.
      • Delete this Patient : To delete a patient permanently. (Allow Delete Patient configuration required)
    • From More functions dropdown :
      • Create patient : To create a new patient.
    • Select Toggle checkboxes from Actions for selections dropdown
      • Select any patient and Mark selected patient for merge. Next select any other patient and Start process of copying/moving/linking or merging and Merge.
  • Select MWLs tab, (you may specify one or more filters) and proceed with :
    • SUBMIT : To see list of Modality Worklist entries.
    • COUNT : To see count of Modality Worklist entries.
    • On any of the Modality Worklist entries from the list :
      • Show Attributes : To view the Modality Worklist entry attributes.
      • Edit MWL : To update one or more Modality Worklist entry attributes.
      • Delete MWL : To delete Modality Worklist entry.
      • Upload file : To upload either an image, video or pdf file to study.
  • Select UWLs tab, (you may specify one or more filters) and proceed with :
    • SUBMIT : To see list of Unified Worklist entries.
    • On any of the Unified Worklist entries from the list :
      • Show Attributes : To view the Unified Worklist entry attributes.
⚠️ **GitHub.com Fallback** ⚠️