← Навигация по документации

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

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

Экспортёр

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

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

• Перейдите на Configuration page -> Devices tab -> dcm4chee-arc -> Device Extension -> Archive Device Extension -> Child Objects -> Exporter Descriptor (Add)

• Настройте следующие поля для дескриптора экспорта

• До версии архива 5.23.1 Exporter ID : WADO 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 and metadata Property : Cache-Control=no-cache Property : StorageID=wado-jpeg Property : StorageID.1=wado-json Property : Accept.1=application/json Property : URL.1=wado:http://localhost:8080/dcm4chee-arc/aets/DCM4CHEE/rs/studies/[0]/metadata Property : KeycloakClientID=wado-export

• Начиная с версии архива 5.23.2 : Создайте отдельные экспортёры для предварительного получения метаданных и bulkdata объектов, как описано в
  - Metadata exporter - Bulkdata exporter

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

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

• До версии архива 5.23.1 dn: dcmExporterID=WADO,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org objectClass: dcmExporter dcmExporterID: WADO 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: Accept.1=application/json dcmProperty: StorageID.1=wado-json dcmProperty: StorageID=wado-jpeg dcmProperty: URL.1=wado:http://localhost:8080/dcm4chee-arc/aets/DCM4CHEE/rs/studies/[0]/metadata dcmProperty: KeycloakClientID=wado-export dicomAETitle: DCM4CHEE dicomDescription: Prefetch WADO jpeg and metadata
• Начиная с версии архива 5.23.2 : Создайте отдельные экспортёры для предварительного получения метаданных и bulkdata объектов, как описано в
  • Metadata exporter
  • Bulkdata exporter

и импортируйте его на 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] или URL.1 : wado:https://localhost:8443/dcm4chee-arc/aets/DCM4CHEE/rs/studies/[0]/metadata - Краткий обзор и короткое описание параметров 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 : Значение должно быть выражено как целое число, представляющее ширину возвращаемого изображения.
- См. [Storage](/wp-content/uploads/dcm4chee-ru/howTo-guides/archiveFeatures/restfulServices/wado-prefetch/Pre-fetch-of-WADO-objects.html#storage) относительно свойства `StorageID=wado-jpeg` и `StorageID.1=wado-json`

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

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

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

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

• Перейдите на Configuration page -> Devices tab -> dcm4chee-arc -> Device Extension -> Archive Device Extension -> Child Objects -> Export Rule (Add)

• Настройте следующие поля для правила экспорта

• До версии архива 5.23.1 Name : Cache WADO Entity : Series Exporter ID : WADO Export Delay : PT1M

• Начиная с версии архива 5.23.2 Name : Cache WADO Entity : Series Exporter ID : WADO-JPEG Exporter ID : WADO-JSON Export Delay : PT1M

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

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

• До версии архива 5.23.1 dn: cn=Cache WADO,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org objectClass: dcmExportRule cn: Cache WADO dcmEntity: Series dcmExporterID: WADO dcmDuration: PT1M
• Начиная с версии архива 5.23.2 dn: cn=Cache WADO,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org objectClass: dcmExportRule cn: Cache WADO dcmEntity: Series dcmExporterID: WADO-JPEG dcmExporterID: WADO-JSON dcmDuration: PT1M

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

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

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

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