Prefetch WADO Bulkdata

Предварительное получение WADO Bulkdata

Этот вариант использования определяет, как можно включить предварительное получение (pre-fetch) только JPEG-данных изображений объектов.

Экспортёр

Настройте Экспортёр как описано ниже. Добавьте дескриптор экспортёра посредством :

Использование UI архива

Перейдите на Configuration page -> Devices tab -> dcm4chee-arc -> Device Extension -> Archive Device Extension -> Child Objects -> Exporter Descriptor (Add)
Настройте следующие поля для дескриптора экспорта
До версии архива 5.23.1 Exporter ID : WADO-JPEG Queue Name : Export2 URI : wado:http://localhost:8080/dcm4chee-arc/aets/DCM4CHEE/wado?requestType=WADO&studyUID=[0]&seriesUID=[1]&objectUID=[2]&frameNumber=[3] Archive Application Entity (AE) title : DCM4CHEE Exporter Description : Prefetch WADO JPEG Property : Cache-Control=no-cache Property : StorageID=wado-jpeg Property : KeycloakClientID=wado-export
Начиная с версии архива 5.23.2 Exporter ID : WADO-JPEG Queue Name : Export2 URI : wado:DCM4CHEE-WADO Archive Application Entity (AE) title : DCM4CHEE Exporter Description : Prefetch WADO bulkdata Property : Cache-Control=no-cache Property : StorageID=wado-jpeg Property : WadoService=?requestType=WADO&studyUID=[0]&seriesUID=[1]&objectUID=[2]&frameNumber=[3]

Использование LDAP

Создайте LDIF-файл (напр.)

До версии архива 5.23.1 dn: dcmExporterID=WADO-JPEG,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org objectClass: dcmExporter dcmExporterID: WADO-JPEG dcmQueueName: Export2 dcmURI: wado:http://localhost:8080/dcm4chee-arc/aets/DCM4CHEE/wado?requestType=WADO&studyUID=[0]&seriesUID=[1]&objectUID=[2]&frameNumber=[3]&contentType=image/jpeg dcmProperty: Cache-Control=no-cache dcmProperty: StorageID=wado-jpeg dcmProperty: KeycloakClientID=wado-export dicomAETitle: DCM4CHEE dicomDescription: Prefetch WADO metadata
Начиная с версии архива 5.23.2 dn: dcmExporterID=WADO-JPEG,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org objectClass: dcmExporter dcmExporterID: WADO-JPEG dcmQueueName: Export2 dcmURI: wado:DCM4CHEE-WADO dcmProperty: Cache-Control=no-cache dcmProperty: StorageID=wado-jpeg dcmProperty: WadoService=?requestType=WADO&studyUID=[0]&seriesUID=[1]&objectUID=[2]&frameNumber=[3]&contentType=image/jpeg dicomAETitle: DCM4CHEE dicomDescription: Prefetch WADO bulkdata

и импортируйте его на LDAP-сервер с помощью утилиты командной строки ldapmodify.

Можно обратиться к Exporter Descriptor для понимания описания атрибутов.

Перейдите на вкладку Control на странице Configuration в UI архива и перезагрузите конфигурацию.

Примечание : В вышеуказанных конфигурациях : - До версии архива 5.23.1 - Свойство KeycloakClientID=wado-export ОПЦИОНАЛЬНО. См. Keycloak Client, если дополнительная функциональность, предоставляемая этим свойством, требуется вашему приложению. - Можно добавить дополнительные опциональные свойства TLSAllowAnyHostname и TLSDisableTrustManager со значениями true или false (напр. Property : TLSAllowAnyHostname=true), если вы хотите вызывать WADO-сервисы по защищённому http. т.е. URI : wado:https://localhost:8443/dcm4chee-arc/aets/DCM4CHEE/wado?requestType=WADO&studyUID=[0]&seriesUID=[1]&objectUID=[2]&frameNumber=[3] - Краткий обзор и короткое описание параметров dcmURI : Для идентификации DICOM-объекта требуется только один UID, поскольку любой UID глобально уникален. Однако стандарт требует указания UID более высоких уровней в DICOM Information Model (т.е. серии и исследования), для поддержки использования DICOM-устройств, поддерживающих только базовую иерархическую (а не расширенную реляционную) модель Query/Retrieve, требующую определения Study Instance UID и Series Instance UID при получении SOP Instance. - studyUID — Этот параметр ОБЯЗАТЕЛЕН. Должен быть Study Instance UID. - seriesUID — Этот параметр ОБЯЗАТЕЛЕН. Должен быть Series Instance UID. - objectUID — Этот параметр ОБЯЗАТЕЛЕН. Должен быть SOP Instance UID. - frameNumber — Этот параметр ОПЦИОНАЛЕН. Указывает, что должен быть возвращён одиночный кадр с этим номером внутри объекта многокадрового изображения. - contentType — Этот параметр ОПЦИОНАЛЕН. Его значение должно содержать один или несколько media types. - Можно опционально вернуть высоту и ширину изображений, используя опциональные параметры запроса в URL, как

        dcmURI: wado:http://localhost:8080/dcm4chee-arc/aets/DCM4CHEE/wado?requestType=WADO&studyUID=[0]&seriesUID=[1]&objectUID=[2]&frameNumber=[3]&rows=64&columns=64&contentType=image/jpeg

  где : 
   - rows : Значение должно быть выражено как целое число, представляющее высоту возвращаемого изображения.
   - columns : Значение должно быть выражено как целое число, представляющее ширину возвращаемого изображения.

Начиная с версии архива 5.23.2
- Свойство WadoService ОБЯЗАТЕЛЬНО с относительным URL, указанным как URI Service
- См. пункт 2 в вызове WADO-сервиса по защищённому http и/или вызове WADO-сервиса защищённого архива если это требуется вашему приложению.
См. Storage относительно свойства StorageID=wado-jpeg
HTTP-заголовки могут быть определены в dcmProperty.
Cache-Control=no-cache указывает, что при каждом изменении исследования кэш будет аннулирован и WADO-данные должны быть повторно загружены из архива.

Правило экспорта

Настройте также Export Rule, если этот предварительный запрос должен запускаться при получении исследований архивом. Добавьте правило экспорта посредством :

Использование UI архива

Перейдите на Configuration page -> Devices tab -> dcm4chee-arc -> Device Extension -> Archive Device Extension -> Child Objects -> Export Rule (Add)
Настройте следующие поля для правила экспорта
```
Name : Cache WADO JPEG
Entity : Series
Exporter ID : WADO-JPEG
Export Delay : PT1M
```

Использование LDAP

Создайте LDIF-файл (напр.):

     dn: cn=Cache WADO JPEG,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
     objectClass: dcmExportRule
     cn: Cache WADO JPEG
     dcmEntity: Series
     dcmExporterID: WADO-JPEG
     dcmDuration: PT1M

и импортируйте его на LDAP-сервер с помощью утилиты командной строки ldapmodify.

Можно обратиться к Export Rule для понимания описания атрибутов.

См. ISO-8601 Duration format для получения дополнительной информации о длительностях.

Причины, по которым предварительное получение JPEG-данных изображений WADO-объектов не выполняется на : - уровне STUDY : При получении новой серии исследования, скажем, через день (напр. Structured Reports), для всего исследования предварительное получение выполняется заново. - уровне INSTANCE : Чтобы избежать дорогостоящих операций с базой данных.