Notify external HL7 Receivers on Procedure Status Updates

Обзор

Отправка HL7 Order OMG^O19-сообщения Procedure Status Update или Observation Reporting ORU^R01-сообщений одному или нескольким внешним HL7 Receiver при получении исследований либо при получении Modality Performed Procedure Steps. Эти уведомления можно отправлять независимо от того, ассоциированы ли исследование или MPPS с MWL.

Общая конфигурация для уведомлений, инициируемых приёмом MPPS или исследования

Настройте один или несколько HL7 Receiver
Загрузите Vendor Data, если это ещё не сделано.
По умолчанию архив преднастроен HL7-приложением * HL7 Application, что означает возможность приёма HL7-сообщений от любой системы, в том числе от тех, которые не способны корректно указать Application and Facility name HL7-приложения архива в сегменте MSH.
Когда архив выступает в роли отправителя HL7-сообщений, рекомендуется клонировать это HL7-приложение, чтобы корректно отразить конкретные Sending Application и Facility Name в исходящих из архива HL7-сообщениях. Поэтому перейдите в Menu -> Configuration -> Devices -> dcm4chee-arc -> Device Extension -> Child Objects -> HL7 Application -> * -> Clone this HL7 application. Укажите подходящее имя, например HL7SND|DCM4CHEE, и нажмите Save.
Далее, чтобы настроить остальные параметры для активации этой функции, вернитесь в Device Extension -> Archive Device Extension.
Задайте подходящие значения для HL7 Procedure Status Update Task Polling Interval.
Необязательные атрибуты, которые можно задать / настроить в зависимости от нужд вашего приложения:
HL7 Procedure Status Update Attribute Conditions
HL7 Procedure Status Update Tasks Fetch Size
Следующие атрибуты с преднастроенными значениями по умолчанию доступны только до версии 5.29.0
```
HL7 Procedure Status Update Accession Number       : {StudyInstanceUID,hash}
HL7 Procedure Status Update Placer Order Number    : {StudyInstanceUID,hash}
HL7 Procedure Status Update Filler Order Number    : {StudyInstanceUID,hash}
HL7 Procedure Status Update Requested Procedure ID : {StudyInstanceUID,hash}
```
Начиная с версии 5.29.1 эти поля заменены на HL7 Procedure Status Update Parameters
```
HL7 Procedure Status Update Parameters : AccessionNumber={StudyInstanceUID,hash}
                                         PlacerOrderNumber={StudyInstanceUID,hash}
                                         FillerOrderNumber={StudyInstanceUID,hash}
                                         RequestedProcedureID={StudyInstanceUID,hash}
```
- Выберите HL7 Procedure Status Message Type как OMG_O19 или ORU_R01.
- Чтобы отправлять сведения о пациенте и визите в уведомлениях OMG_O19, установите HL7 Procedure Status Update PID PV1 в True. Для ORU_R01 сведения о пациенте и визите отправляются всегда, независимо от значения HL7 Procedure Status Update PID PV1.
- Выберите настроенный HL7 Receiver в качестве HL7 Procedure Status Update Receiving Application, а клонированное HL7-приложение на уровне расширения устройства — в качестве HL7 Procedure Status Update Sending Application, и нажмите Save.

Примечание: Уведомления HL7 Procedure Status Update можно отправлять только либо при приёме MPPS, либо при приёме исследования. Чтобы включить отправку уведомлений и при приёме MPPS, и при приёме исследования, пользователю придётся создать два отдельных AE Title(s) of the Archive, настроить соответствующие Storage / MPPS-специфичные Transfer Capabilities на каждом AE архива и настроить указанную выше / нижеследующую конфигурацию для приёма исследования / MPPS на уровне расширения archive network AE.

Конфигурация, специфичная для триггера MPPS

На уровне расширения archive device настройте HL7 Procedure Status Update Timeout.
Установите HL7 Procedure Status Update on Timeout в True, чтобы отправлять уведомления, если экземпляры исследования, на которое ссылается MPPS, не отправлены модальностью в архив либо если превышен таймаут ожидания приёма экземпляров, на которые ссылается исследование.

Конфигурация, специфичная для триггера приёма исследования

На уровне расширения archive device настройте HL7 Procedure Status Update Delay.

Конфигурация для MWL

На уровне расширения archive device при необходимости настройте: - HL7 Procedure Status Update MWL - HL7 Procedure Status Update MWL Matching Key - HL7 Procedure Status Update for Requested Procedure Примечание: если этот поле установлено в True, уведомление о полученных исследованиях отправляется только тогда, когда исследования ассоциированы с MWL.

Тестирование и проверка

Необходимые инструменты dcm4che

storescu эмулирует внешний источник объектов (например, модальность) STORESCU, от которого поступают объекты.
hl7snd эмулирует HL7-отправителя (например, DSS/Order Filler), который отправляет HL7-сообщения в архив.
hl7rcv эмулирует HL7-приёмник (например, DSS/Order Filler), который принимает HL7-сообщения.
mppsscu эмулирует SCU для Modality Performed Procedure Step (MPPS) SOP Class и для Verification SOP Class. Требуется только для тестирования уведомлений, отправляемых по триггеру MPPS.

Проверка

Триггер MPPS

Запустите HL7-приёмник с помощью инструмента hl7rcv.
```
    hl7rcv -b 2576
```
- При необходимости отправьте HL7 Order-сообщения, ассоциированные с сохраняемым исследованием либо с MPPS.
hl7snd -c localhost:2575 /path-to-hl7-order-messages - Отправьте MPPS в архив с помощью инструмента mppsscu. Убедитесь, что PlacerOrderNumberImagingServiceRequest и FillerOrderNumberImagingServiceRequest присутствуют в ScheduledStepAttributesSequence в отправляемом в архив MPPS.
```
    mppsscu -s ScheduledStepAttributesSequence.PlacerOrderNumberImagingServiceRequest=P1 -s ScheduledStepAttributesSequence.FillerOrderNumberImagingServiceRequest=F1 -c  DCM4CHEE@localhost:11112  /path-to-study
```
- При необходимости отправьте исследования в архив с помощью инструмента storescu, который эмулирует отправку исследований модальностями в архив.
storescu -c DCM4CHEE@localhost:11112 /path-to-study - После истечения настроенных HL7 Procedure Status Update Task Polling Interval и HL7 Procedure Status Update Timeout проверьте в окне инструмента hl7rcv, что для исследований, сохранённых в архив, получены сообщения OMG^O19 или ORU^R01. Кроме того, эти сообщения также сохраняются по пути в файловой системе, где был запущен инструмент.
При необходимости проверьте на странице Monitoring на вкладке Queues, выбрав HL7 Forward Tasks, что задачи HL7Send находятся в состоянии COMPLETED.

Триггер приёма исследования

Запустите инструмент hl7rcv, который эмулирует внешнюю систему, способную принимать HL7-сообщения.

hl7rcv -b 2576 - При необходимости отправьте HL7 Order-сообщения, ассоциированные с сохраняемым исследованием.

hl7snd -c localhost:2575 /path-to-hl7-order-messages
Отправьте исследования в архив с помощью инструмента storescu, который эмулирует отправку исследований модальностями в архив.

storescu -c DCM4CHEE@localhost:11112 /path-to-studies
После истечения настроенных HL7 Procedure Status Update Task Polling Interval и HL7 Procedure Status Update Delay проверьте в окне инструмента hl7rcv, что для исследований, сохранённых в архив, получены сообщения OMG^O19 или ORU^R01. Кроме того, эти сообщения также сохраняются по пути в файловой системе, где был запущен инструмент.
При необходимости проверьте на странице Monitoring на вкладке Queues, выбрав HL7 Forward Tasks, что задачи HL7Send находятся в состоянии COMPLETED.

Обновление статуса MWL

Если в архив были отправлены HL7 order-сообщения при отправке MPPS в архив либо при сохранении исследований в архив и - в архиве есть Конфигурация для MWL ИЛИ - HL7 Procedure Status Update Receiving Application и HL7 Procedure Status Update Receiving Application настроены для отправки уведомлений,

то Scheduled Procedure Step Status связанных записей Modality Worklist обновляется до COMPLETED / DISCONTINUED и может быть проверён через атрибуты MWL на странице Navigation -> вкладка MWL.