Extract Scheduled Procedure Step Status - dcm4che/dcm4chee-arc-light GitHub Wiki

Overview

This feature helps the user to configure scheduled procedure step status for incoming Modality Worklist HL7 Order feed messages. Following Scheduled Procedure Step Statuses are currently supported by the archive :

  • SCHEDULED
  • ARRIVED
  • READY
  • STARTED
  • DEPARTED
  • CANCELED
  • DISCONTINUED
  • COMPLETED

Configuration

Note :

  • Extraction of Scheduled Procedure Step Status can be configured on Archive Device level or on Archive HL7 Application Extension level. The values configured on Archive HL7 Application Extension level will overwrite values configured on Archive Device level.
  • hl7OrderControlStatus attribute value as indicated in below configuration should be the ORC1_ORC5 fields of the HL7 message that is being sent. If the values in the HL7 message are different from those configured in the hl7OrderControlStatus, then MWL item is not created/updated in the archive. A log message will be generated indicating the same.
  • Ensure that one has Vendor data on Archive Device level.

Using Archive UI

  1. Select the level on which the feature needs to be configured :
    • To configure on Archive device level, go to Menu->Configuration, then on Devices page, Edit of dcm4chee-arc device. Go to Extensions and Edit extension of Device Extension. Again go to its Extensions and Edit extension of Archive device. Go to Child Objects and select + for adding SPS Status for HL7 Order.
    • To configure on Archive HL7 application extension level, go to Menu->Configuration, then on Devices page and Edit the dcm4chee-arc device. Go to Extensions and Edit extension of Device Extension. Go to Child Objects and select the HL7 application for which this feature needs to be configured. Go to Extensions and Edit extension of Archive HL7 Application. Go to Child Objects and select + for adding SPS Status for HL7 Order.
  2. Select value from Scheduled Procedure Step Status code field and select possible values for HL7 Order Control Status field as required by your application and Save.

Using LDAP

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

  • To configure on Archive device level,

      version: 1
      
      dn: dcmSPSStatus=SCHEDULED,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
      objectClass: top
      objectClass: hl7OrderSPSStatus
      dcmSPSStatus: SCHEDULED
      hl7OrderControlStatus: NW_SC
      hl7OrderControlStatus: NW_IP
      hl7OrderControlStatus: XO_SC
      
      dn: dcmSPSStatus=CANCELED,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
      objectClass: top
      objectClass: hl7OrderSPSStatus
      dcmSPSStatus: CANCELED
      hl7OrderControlStatus: CA_CA
      
      dn: dcmSPSStatus=DISCONTINUED,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
      objectClass: top
      objectClass: hl7OrderSPSStatus
      dcmSPSStatus: DISCONTINUED
      hl7OrderControlStatus: DC_CA
      
      dn: dcmSPSStatus=COMPLETED,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
      objectClass: top
      objectClass: hl7OrderSPSStatus
      dcmSPSStatus: COMPLETED
      hl7OrderControlStatus: XO_CM        
    
  • To configure on Archive HL7 application extension level,

      version: 1
    
      dn: dcmSPSStatus=SCHEDULED,hl7ApplicationName=*,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
      objectClass: hl7OrderSPSStatus
      dcmSPSStatus: SCHEDULED
      hl7OrderControlStatus: NW_SC
      hl7OrderControlStatus: NW_IP
      hl7OrderControlStatus: XO_SC
      
      dn: dcmSPSStatus=CANCELED,hl7ApplicationName=*,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
      objectClass: hl7OrderSPSStatus
      dcmSPSStatus: CANCELED
      hl7OrderControlStatus: CA_CA
      
      dn: dcmSPSStatus=DISCONTINUED,hl7ApplicationName=*,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
      objectClass: hl7OrderSPSStatus
      dcmSPSStatus: DISCONTINUED
      hl7OrderControlStatus: DC_CA
      
      dn: dcmSPSStatus=COMPLETED,hl7ApplicationName=*,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
      objectClass: hl7OrderSPSStatus
      dcmSPSStatus: COMPLETED
      hl7OrderControlStatus: XO_CM                
    

One may refer to SPS Status for HL7 Order to understand description of attributes.

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

Testing

  1. Send an order feed message to archive using hl7snd tool

          hl7snd -c localhost:2575 /path_to_orderMessage.hl7
    
  2. Using the archive UI, query for the MWL items to check if it is created/updated in the archive

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