Включив эту функцию, пользователь может настроить предварительное получение (pre fetch) WADO-объектов proxy-сервером. Proxy-сервер кэширует WADO-ответы и делает эти объекты доступными по мере необходимости для Viewer (просмотрщика).
Примечание : Код и конфигурация Wado Exporter были переработаны в рамках issue,
где требуется специфичное для WADO-сервиса Web Application. Обычно варианты использования для экспорта WADO могут быть следующими:
1. Предварительно получать изображения и/или метаданные на некоторый сервер кэширования для более быстрого доступа. В
таких вариантах использования требуется, чтобы пользователь настроил отдельное устройство и настроил на нём соединения,
специфичные для протокола HTTP, которые затем используются для ссылок в Web Application, настраиваемом на этом новом
созданном устройстве, используемом в качестве устройства кэширования.
2. Использовать этот экспортёр для создания копий изображений и/или файлов метаданных на том же устройстве для дальнейшей
обработки сторонним приложением. Приведённые ниже конфигурации относятся к этому варианту использования.
- Поскольку в конфигурации устройства архива по умолчанию dcm4chee-arc нет соединений, специфичных для протокола HTTP,
создайте их, перейдя в Configuration -> Devices -> dcm4chee-arc -> Child Objects -> Network Connections ->
Add new network connections(+). Укажите Name, Hostname и Port и нажмите Save. Затем перейдите в Extensions ->
Network Connection Extension -> Add dcm4che proprietary Network Connection attributes (+). Выберите HTTP как
Protocol и нажмите Save. Повторите шаг, если сервис должен вызываться по защищённому HTTP, т.е. https.
Дополнительно для соединения https настройте также требуемые TLS cipher suites.
- Ссылайтесь на новые созданные HTTP-соединения в 2 предварительно настроенных web Applications DCM4CHEE и DCM4CHEE-WADO,
которые содержат классы WADO-сервисов WADO_RS и WADO_URI соответственно, поскольку эти веб-приложения
использовались в приведённых конфигурациях.
- См. Keycloak Client и укажите Keycloak Client ID в веб-приложениях,
если вызываются защищённые WADO-сервисы архива.
- Ниже приведённые конфигурации описывают настройки как для версий до/после версии архива 5.23.2, где пользователь
может захотеть предварительно получать bulkdata, или метаданные, или и то и другое:
- Prefetch WADO Bulkdata
- Prefetch WADO Metadata
- Prefetch WADO Bulkdata and Metadata
Этот раздел следует рассматривать совместно со вторым вариантом использования, описанным выше. Он кратко объясняет конфигурацию хранилища JPEG-данных изображений объектов и/или метаданных, вызываемых через WADO-сервисы, в файловой системе.
Настройте дескрипторы хранилища, как описано в Generic Storage. Примеры конфигураций для каталогов хранения wado-jpeg и/или wado-metadata приведены ниже :
Использование UI архива :
Configuration page -> Devices tab -> dcm4chee-arc -> Device Extension -> Archive Device Extension -> Child Objects
-> Storage DescriptorsДля Prefetch WADO Bulkdata и Prefetch WADO Bulkdata and Metadata добавьте новый Storage Descriptor со следующими значениями полей :
Storage ID : wado-jpeg Storage URI : ${jboss.server.data.url}/wado/ Storage Property : pathFormat={0020000D}/{0020000E}/{00080018}/{00081160}.jpeg Storage Property : checkMountFile=NO_MOUNT - Для Prefetch WADO Metadata и Prefetch WADO Bulkdata and Metadata добавьте новый Storage Descriptor со следующими значениями полей :
Storage ID : wado-json Storage URI : ${jboss.server.data.url}/wado/ Storage Property : pathFormat={0020000D}.json Storage Property : checkMountFile=NO_MOUNT
Использование LDAP :
Для Prefetch WADO Bulkdata и Prefetch WADO Bulkdata and Metadata
version: 1
dn: dcmStorageID=wado-jpeg,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
objectClass: dcmStorage
dcmStorageID: wado-jpeg
dcmURI: ${jboss.server.data.url}/wado/
dcmProperty: pathFormat={0020000D}/{0020000E}/{00080018}/{00081160}.jpeg
dcmProperty: checkMountFile=NO_MOUNT
Для Prefetch WADO Metadata и Prefetch WADO Bulkdata and Metadata
version: 1
dn: dcmStorageID=wado-json,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
objectClass: dcmStorage
dcmStorageID: wado-json
dcmURI: ${jboss.server.data.url}/wado/
dcmProperty: pathFormat={0020000D}.json
dcmProperty: checkMountFile=NO_MOUNT
Можно обратиться к Storage Descriptor для понимания описания атрибутов.
Перейдите на вкладку Control на странице Configuration в UI архива и перезагрузите конфигурацию.
Следующие конфигурации необходимы только если экспорт WADO используется с защищённой версией архива (UI и RESTful-сервисы защищены). Эти конфигурации требуются для передачи Authorization Bearer Token при вызове WADO-запросов.
http[s]://<host>:<port>/auth/admin/dcm4che/console Создайте новый клиент
Client Id : wado-export (Потребуется для dcmKeycloakClientID в конфигурации LDAP)
Access Type : Confidential
Service Accounts Enabled : ON
Standard Flow Enabled : OFF
Запишите его Secret-Key на вкладке Credentials (Потребуется для dcmKeycloakClientSecret в конфигурации LDAP)
После создания клиента перейдите на вкладку Service Account Roles и назначьте роль user.
Настройте Keycloak Client в архиве
Использование UI архива :
Configuration page -> Devices tab -> dcm4chee-arc -> Device Extension -> Child Objects -> Keycloak ClientsKeycloak Client ID : wado-export
Server URL : http://localhost:8880/auth
Keycloak Realm : dcm4che
Keycloak grant type : client_credentials
Keycloak Client secret : 1e04f856-9c76-46f3-91ae-c5624a82fa6d
TLS Allow Any Hostname : True
Использование LDAP :
version: 1
dn: dcmKeycloakClientID=wado-export,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
objectClass: dcmKeycloakClient
dcmKeycloakClientID: wado-export
dcmKeycloakRealm: dcm4che
dcmURI: http://localhost:8880/auth
dcmKeycloakGrantType: client_credentials
dcmKeycloakClientSecret: 1e04f856-9c76-46f3-91ae-c5624a82fa6d
dcmTLSAllowAnyHostname: TRUE
ПРИМЕЧАНИЕ : Значение Server URL или dcmURI должно совпадать с URL auth-сервера Keycloak, настроенным при настройке
защищённого архива.
Перейдите на вкладку Control на странице Configuration в UI архива и перезагрузите конфигурацию.
Export Delay и Export Polling Interval, проверьте на Monitoring page -> Export tab,
выбрав настроенный Exporter ID, завершена ли задача экспорта WADO (статус COMPLETED). Если не было настроено
никакого Export Rule, всё ещё можно использовать UI архива для экспорта объектов через WADO-экспортёр.