Import Report as DICOM - dcm4che/dcm4chee-arc-light GitHub Wiki

Overview

The Report Manager transmits verified Structured Reports or Encapsulated PDFs as unsolicited HL7 observations to the archive. This feature can be enabled to store the text reports or encapsulated documents in incoming HL7 ORU^R01 messages as DICOM SRs or Encapsulated PDF DOCs in the archive.

Configuration

  • Ensure that one has Vendor data on Archive Device level.

Using Archive UI

  1. Go to Menu->Configuration, then on Devices page, Edit the dcm4chee-arc device. Go to Extensions and Edit extension of Device Extension. Go to Child Objects and select an option from HL7 Applications.
  2. Add value ORU^R01 in Accepted Message Type if not present already and Save.
  3. Next got to its Extensions and Edit extension of Archive HL7 Application. Enter value DCM4CHEE in AE Title field and Save.
  4. By default on archive device extension level, HL7 Import Report Template URI is already present, if absent the one may add value to this field as ${jboss.server.temp.url}/dcm4chee-arc/hl7-oru2dsr.xsl.
  5. On archive device level or on archive HL7 application extension level, select IMPORT_REPORT as an action for the field HL7 ORU Action.

Using LDAP

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

    version: 1
    dn: hl7ApplicationName=*,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dicomAETitle
    dicomAETitle: DCM4CHEE

    dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: hl7ImportReportTemplateURI
    hl7ImportReportTemplateURI: ${jboss.server.temp.url}/dcm4chee-arc/hl7-oru2dsr.xsl

    dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: hl7ORUAction
    hl7ORUAction: IMPORT_REPORT

    dn: hl7ApplicationName=*,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: hl7AcceptedMessageType
    hl7AcceptedMessageType: ORU^R01
  • or use the Add Attribute... and Add Value... function of Apache Directory Studio to add attributes on Archive Device level (e.g.: dicomDeviceName=dcm4chee-arc) or Archive HL7 Application level (eg.: hl7ApplicationName=*) in the Archive Configuration.

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

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

Testing

Test this feature using hl7snd tool and archive UI.

  • Send a HL7 ORU^R01 message to archive

       hl7snd -c localhost:2575  /path_to_msg.hl7
    
  • Query for studies from Archive UI. An encapsulated CDA document or a text report is stored with Modality as SR. An encapsulated PDF document is stored with Modality as DOC.

  • Expand to object level and verify the attributes of object with those from the HL7 message that was sent to the archive.

⚠️ **GitHub.com Fallback** ⚠️