Export prior Studies on receive of DICOM composite objects - dcm4che/dcm4chee-arc-light GitHub Wiki
One can choose to export some or all relevant prior studies of a patient on receive of new studies for the same patient.
Configure one or more DICOM Exporter for each destination.
- Select the level on which the feature needs to be configured :
- To configure on Archive device level, go to
Menu->Configuration
, then onDevices
page,Edit
thedcm4chee-arc
device. Go toExtensions
andEdit extension
ofDevice Extension
. Again go to itsExtensions
andEdit extension
ofArchive device
. - To configure on Archive Application Entity level, go to
Menu->Configuration
, then onDevices
page and
Edit
thedcm4chee-arc
device. Go toChild Objects
and select theApplication Entity
for which this feature needs to be configured. Go toExtensions
andEdit extension
ofNetwork AE extension
. Again go to itsExtensions
and click onEdit extension
ofArchive Network AE
.
- To configure on Archive device level, go to
- In its
Child Objects
addExport Priors Rule
. SpecifyName
,Exporter ID
,Suppress Duplicate Export Interval
and one or more optional fieldsAttribute Conditions
,Time Conditions
andEntity Selector
andSave
.
Doing so will trigger export of studies for patients whenever any processed HL7 Message referencing this patient is received by archive.
- Trigger export of studies only on specific condition(s).
-
Add one or more
Attribute Conditions
andSave
.This ensures that some or all relevant prior studies of a patient shall be exported only if attribute(s) present in the incoming object(s) of the studies of this patient matched the attribute condition(s) specified in this rule.
- Trigger export only for some studies based on certain conditions pertaining to the study/patient
-
Add one or more
Entity Selector
andSave
.For eg. if you set value as
priors=2&StudyAge=-5Y&ModalitiesInStudy=CT
, it meansselect at most 2 prior Studies not older than 5 years containing at least one CT Series
.
- Export Prior Studies only if rule is triggered in certain time schedules.
-
Add one or more
Time Conditions
andSave
.This ensures that if new studies of a patient was received in the specified time schedule(s) and the Export Priors Rule matched any remaining condition(s), if specified, then some or all relevant prior studies of this patient shall be exported.
One may either create a LDIF file (e.g.):
-
To configure on Archive device level,
version: 1 dn: cn=Default Export Prior Rule,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org objectClass: dcmExportPriorsRule cn: Default Export Prior Rule dcmDuration: PT1H dcmExporterID: STORESCP dcmSchedule: hour=22-23 dayOfWeek=0 dcmProperty: SendingApplicationEntityTitle=FORWARD dcmEntitySelector: priors=2&StudyAge=-5Y&ModalitiesInStudy=CT
-
To configure on Archive Application Entity level,
version: 1 dn: cn=Default Export Prior Rule,dicomAETitle=DCM4CHEE,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org objectClass: dcmExportPriorsRule cn: Default Export Prior Rule dcmDuration: PT1H dcmExporterID: STORESCP dcmSchedule: hour=22-23 dayOfWeek=0 dcmProperty: SendingApplicationEntityTitle=FORWARD dcmEntitySelector: priors=2&StudyAge=-5Y&ModalitiesInStudy=CT
and import it to the LDAP Server by using the ldapmodify command line utility.
-
or directly use its New Entry... function to create corresponding Export Priors Rule entries of Apache Directory Studio on Device Level (e.g.:
dicomDeviceName=dcm4chee-arc
) or on Application Entity Level (e.g:dicomAETitle=DCM4CHEE
) of the Archive Configuration.
One may refer to Export Priors Rule to understand the description of attributes.
Refer ISO-8601 Duration format for more know-how on Durations.
Go to the Control tab on Configuration page in archive UI and reload the configuration.
- storescu simulating the external object source (e.g. modality) STORESCU, from which objects are being received.
- storescp simulating the external object destination (e.g. central archive) STORESCP, to which received objects are forwarded.
-
Start STORESCP tool.
storescp -b <AET>:<port>
-
Send study to archive
storescu -c <AET>@<hostname>:<port> /pathToStudy
-
The patient to which above study belongs, if is already present in the archive and has studies, then you will see in the storescp tool window that the prior studies of this patient have been exported to the STORESCP destination.
-
If the patient was not present in the archive, then send again a second study for the same patient to the archive and you will notice that the first study sent (in point 2 above) has been exported to the STORESCP destination.