Conditional extraction of Scheduled Protocol Code

Overview

This feature can be enabled when one wants to extract the Scheduled Protocol code in OBR segment field 4 either from
component 1 or component 4 in the incoming HL7 Order message.

Configuration

Note :

• One may configure this feature on Archive Device extension 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.
• 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.
   • 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.
2. Select a value from dropdown for the field HL7 Schedule Protocol Code in Order and Save.

Using LDAP

One may either create 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: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
   changetype: modify
   add: hl7ScheduledProtocolCodeInOrder
   hl7ScheduledProtocolCodeInOrder: OBR_4_1
  

• To configure on Archive HL7 application extension level,

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

• 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 or Archive HL7 Application to understand the description of attribute.

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

Testing

Test this feature using dcm4che tools and archive UI.

1. Send a HL7 Order message to archive

     hl7snd -c localhost:2575  /path_to_msg.hl7
   

2. Query for modality worklist entries from Archive UI, and verify the value of Scheduled Protocol Code Order (depending on the value of hl7ScheduledProtocolCodeInOrder in one's LDAP configuration) in the attributes of the MWL whether it is taken from component 1 or component 4 of field 4 of OBR segment in the HL7 Order message.