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

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

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.

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.

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.

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