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

Содержание - Обзор - Особенности конфигурации - Настройки, общие для всех типов коэрсии - Настройка, специфичная для типа коэрсии Supplementing from Device - Настройка, специфичная для типа коэрсии Merge or Nullify Attributes - Настройки, специфичные для типов коэрсии Merge from MWL или Coerce from XSL - Сравнение Legacy и New Coercions - Функциональное сравнение - Сравнение конфигурации по типам коэрсии - Дополнение из устройства - Слияние из local MWL - Слияние из external MWL - Коэрсия атрибутов из произвольного XSL - Коэрсия атрибутов из Leading Archive - Слияние атрибутов - Обнуление атрибутов - Обнуление Issuer of Patient ID - Обнуление Pixel Data - Де-идентификация атрибутов - Извлечение атрибутов объекта как полученных - Коэрсия Use Calling AE Title as - Trim ISO 2022 Character Set - Пример сценария использования коэрсии в настройке клиента — Legacy vs New

Обзор

С помощью New Archive Attribute Coercion к входящим / исходящим наборам данных для сценария использования можно применить несколько коэрсий без зависимости от жёстко заданной последовательности применения коэрсий, как это было в legacy archive attribute coercions.

Плюсы

• С новыми archive attribute coercions пользователи теперь свободны применять столько правил коэрсии, сколько требуется для конкретного сценария использования, и не ограничены конкретной каскадной последовательностью применения коэрсий с использованием только одного правила, как это было в legacy archive attribute coercion.
• Больше гибкости в решении, следует ли применять правила меньшего приоритета, на основе значений, настроенных для Attribute Coercion Priority и Attribute Coercion Sufficient

Минусы

• Для достижения одного сценария использования требуется несколько правил. Раньше с legacy archive attribute coercions пользователи могли применить несколько коэрсий, используя только одно правило коэрсии, тогда как теперь пользователям нужно разбивать одну коэрсию на несколько коэрсий, чтобы достичь того же конечного результата применения коэрсий для заданного набора данных. (Это будет более понятно из примера, приведённого ниже)
• Раздувает конфигурацию коэрсий для клиентских площадок, сильно полагающихся на коэрсии, которые используются как обходные решения для неисправных рабочих процессов больниц.

Особенности конфигурации

Настройки, общие для всех типов коэрсии

Attribute Coercion Priority

Attribute Coercion Sufficient

Attribute Coercion on Failure

• Определяет поведение при сбое применения данной (текущей) Attribute Coercion.
• Значение по умолчанию RETHROW
• Настраиваемые значения

DIMSE

• DICOM Message Element, к которому применяется Attribute Coercion
• Настраиваемые значения

DICOM Transfer Role

SOP Class UID

Conditions

• Коэрсии применяются, когда наборы данных совпадают с заданными Conditions.

Attribute Coercion URI

• Определяет URI-схему типа коэрсии, применяемого к набору данных.

Настройка, специфичная для типа коэрсии Supplementing from Device

Device Name Coercion Parameter

Применимо только для типа коэрсии Supplement attributes from Device, описанного в Attribute Coercion URI

Дополняет атрибуты для: - входящих C-STORE-запросов при получении исследований в архив - входящих (MWL) C-FIND-запросов в архив - входящих (MWL) C-FIND-ответов в архив - исходящих (MWL) C-FIND-запросов из архива - входящих MPPS N-CREATE-запросов в архив

если DICOM-атрибуты присутствуют в устройстве и отсутствуют в указанных выше входящих / исходящих запросах / ответах к / из архива. Атрибуты уровня устройства, применяемые на каждом уровне сущности, следующие:

Настройка, специфичная для типа коэрсии Merge or Nullify Attributes

DICOM Attribute Coercion Parameters

• Применимо только для типа коэрсии Merge Attributes, описанного в Attribute Coercion URI
• DICOM Attribute Coercion Parameters в формате {attributeID}={value}, где указанный {attributeID} может быть Keyword или номером Tag, некоторые примеры:
  • PatientID=JMS{PatientID}
  • PatientID={PatientID,slice,3}
  • IssuerOfPatientID={00100010,hash}-{00100030}
• {attributeID} внутри {value} будет заменён значением этого атрибута в исходном наборе данных. См. различные Attributes Formatting Options on Coercions, которые можно использовать.
• Чтобы обнулить атрибут, просто укажите атрибут без значения {attributeID}=, например:
  • AccessionNumber=
  • аналогично Legacy archive attribute coercion — Nullify Attribute Tag(s)

Настройка, специфичная для типа коэрсии Coerce from Leading Archive

Attribute Update Policy

• Определяет применяемую Attribute Update Policy и применимо только для типа коэрсии Coerce from leading archive, описанного в Attribute Coercion URI
• Значение по умолчанию MERGE
• См. значения применяемой Attribute Update Policy
• Примечание: политика обновления атрибутов REPLACE в коэрсиях не используется.

Настройки, специфичные для типов коэрсии Merge from MWL или Coerce from XSL

Other Coercion Parameters

Other Coercion Parameters — слияние атрибутов из local MWL SCP — примечания

1. match-by - Эквивалентно Merge MWL Matching Key legacy-коэрсии - Указывает атрибут полученного объекта для поиска элемента MWL, используемого для коэрсии атрибутов запроса. Если отсутствует, атрибуты запроса полученных объектов коэрсированы не будут. - Настраиваемые значения ключа match-by:

2. local-mwl-scp - Эквивалентно Merge Local MWL Worklist Label(s) legacy-коэрсии - Примечание: до v5.29.2 legacy-коэрсия содержала Merge Local MWL SCP(s) вместо текущей настройки Merge Local MWL Worklist Label(s) (доступна начиная с v5.30.0). - AE Title MWL SCP архива, используемый для поиска элемента MWL для коэрсии атрибутов запроса полученных объектов. Если отсутствует, к базе данных архива выполняется запрос на совпадающий элемент MWL, предоставленный любым Archive MWL AE. - Несколько значений для local MWL SCP можно указать через разделитель (|), например, в CUF local-mwl-scp=CBLM_CUFVNA|HPRT_CUFVNA
3. local-mwl-status - Эквивалентно Merge Local MWL With Status(s) - Учитываются только элементы MWL с одним из указанных кодов статуса Scheduled Procedure Step.
   • SCHEDULED
   • ARRIVED
   • READY
   • STARTED
   • DEPARTED
   • CANCELED
   • DISCONTINUED
   • COMPLETED
   • Несколько значений для local MWL status можно указать через разделитель (|), например local-mwl-status=READY|ARRIVED

Other Coercion Parameters — слияние атрибутов из external MWL SCP — примечания

1. match-by: то же, что и выше
2. mwl-scp - Может иметь только одно значение, т.е. можно указать только один AET external MWL SCP. - Эквивалентно Merge MWL SCP legacy-коэрсии. - AE Title External MWL SCP, используемый для поиска элемента MWL для коэрсии атрибутов запроса полученных объектов. Если настроен, external MWL SCP опрашивается путём вызова C-FIND RQ службы DICOM MWL, а Merge Local MWL Worklist Label(s) игнорируются.
3. filter-by-scu - Эквивалентно Merge MWL Filter by SCU legacy-коэрсии - Указывает применить заданный фильтр к совпадениям, возвращённым external MWL SCP.

Сравнение Legacy и New Coercions

Существуют значительные различия в том, как функционируют и настраиваются legacy и new archive attribute coercions.

Функциональное сравнение

Сравнение конфигурации по типам коэрсии

Дополнение из устройства

См. Supplement Dataset Attributes from Device для общего понимания этого типа коэрсии.

Слияние из local MWL

Примечание: - До v5.29.2 legacy-коэрсия содержала Merge Local MWL SCP(s) вместо текущей настройки Merge Local MWL Worklist Label(s) (доступна начиная с v5.30.0).

Слияние из external MWL

Коэрсия атрибутов из произвольного XSL

Коэрсия атрибутов из Leading Archive

Слияние атрибутов

Обнуление атрибутов

Обнуление Issuer of Patient ID

Обнуление Issuer of Patient ID на основе совпадающих или несовпадающих Issuer

Дополнение Issuer of Patient ID

Обнуление Pixel Data

Де-идентификация атрибутов

Поддерживаемые профили де-идентификации: - BasicApplicationConfidentialityProfile - RetainLongitudinalTemporalInformationFullDatesOption - RetainDeviceIdentityOption - RetainInstitutionIdentityOption - RetainUIDsOption - (proprietary) RetainPatientIDHashOption

Извлечение атрибутов объекта как полученных

Коэрсия Use Calling AE Title As

AE Title вызывающей системы / клиента в основном используется для коэрсии входящих (MWL) C-FIND / C-STORE-запросов в архив.

Trim ISO 2022 Character Set

См. Trim ISO 2022 Character Sets using Coercions для общего понимания этого типа коэрсии.

Пример сценария использования коэрсии в настройке клиента — Legacy vs New

В качестве примера из клиентской среды рассмотрим legacy-коэрсию для слияния атрибутов входящего объекта, отправляемого модальностями (использующими OMI stream worklist), с помощью (собственного архивного) local MWL SCP.

Следующее правило коэрсии применяет типы коэрсии в порядке возрастания применения: - Обнуление атрибутов: для обнуления следующих атрибутов, если они отправлены модальностями: - Issuer of Accession Number Sequence (0008,0051) - Issuer of Patient ID Qualifiers Sequence (0010,0024) - Issuer of Admission ID Sequence (0038,0014) - Слияние атрибутов: для коэрсии атрибута SpecificCharacterSet=ISO_IR 100 в сохранённом наборе данных. - Обнуление Issuer of Patient ID: для ALWAYS-обнуления Issuer of Patient ID (0010,0021), отправленного модальностью, перед его дополнением из поля Issuer of Patient ID устройства ehCOS-ADT. - Дополнение из устройства: для дополнения значения Issuer of Patient ID (0010,0021) как JMS из поля Issuer of Patient ID устройства ehCOS-ADT. - Слияние атрибутов из local MWL: для слияния атрибутов входящих объектов из элементов MWL в БД архива (созданных HL7 OMI-сообщениями)

Legacy archive Attribute Coercion

Через UI

Name                         : coerce-c-store-rq - moo-pwo2vna
DIMSE                        : C_STORE_RQ
DICOM Transfer Role          : SCU
Conditions                   : ReceivingApplicationEntityTitle=VNADEVA_MOO.*|VNADEVB_MOO.*|VNADEVA_PWO.*|VNADEVB_PWO.*
Nullify Issuer Of Patient ID : ALWAYS
Nullify Attribute Tag(s)     : 00080051
                               00100024
                               00380014
Supplement from Device       : ehCOS-ADT
Merge Attributes             : SpecificCharacterSet=ISO_IR 100
Merge MWL Matching Key       : AccessionNumber
Merge MWL Template URI       : ${jboss.server.temp.url}/dcm4chee-arc/mwl2study-cuf.xsl
Merge MWL Local SCP(s)       : CBLM_CUFVNA
                               CALM_CUFVNA
                               CALV_CUFVNA
                               HTJO_CUFVNA
                               HSTR_CUFVNA

Через Ldif

dn: cn=coerce-c-store-rq - moo-pwo2vna,dicomDeviceName=arc1-a,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
objectClass: dcmArchiveAttributeCoercion
cn: coerce-c-store-rq - moo-pwo2vna
dcmDIMSE: C_STORE_RQ
dicomTransferRole: SCU
dcmMergeMWLMatchingKey: AccessionNumber
dcmMergeMWLTemplateURI: ${jboss.server.temp.url}/dcm4chee-arc/mwl2study-cuf.xsl
dcmNullifyIssuerOfPatientID: ALWAYS
dcmNullifyTag: 00080051
dcmNullifyTag: 00100024
dcmNullifyTag: 00380014
dcmProperty: ReceivingApplicationEntityTitle=VNADEVA_MOO.*|VNADEVB_MOO.*|VNADEVA_PWO.*|VNADEVB_PWO.*
dcmSupplementFromDeviceReference: dicomDeviceName=ehCOS-ADT,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
dcmMergeLocalMWLSCP: CBLM_CUFVNA
dcmMergeLocalMWLSCP: CALV_CUFVNA
dcmMergeLocalMWLSCP: HTJO_CUFVNA
dcmMergeLocalMWLSCP: CALM_CUFVNA
dcmMergeLocalMWLSCP: HSTR_CUFVNA

New archive Attribute Coercion

Чтобы применить ту же последовательность типов коэрсии с помощью new archive attribute coercion, приведённая выше одна legacy-коэрсия должна быть разбита на несколько новых коэрсий для описанного сценария использования. - Сначала применяется наивысший Attribute Coercion Priority. - Используются точно те же DIMSE / DICOM Transfer Role / Conditions.

Через UI

Name                         : coerce-c-store-rq - moo-pwo2vna - nullifyIssuers
DIMSE                        : C_STORE_RQ
DICOM Transfer Role          : SCU
Conditions                   : ReceivingApplicationEntityTitle=VNADEVA_MOO.*|VNADEVB_MOO.*|VNADEVA_PWO.*|VNADEVB_PWO.*
Attribute Coercion Priority  : 3
Attribute Coercion URI       : merge-attrs:
DICOM Attribute Coercion     : 00080051 
Parameter(s)                   00100021
                               00100024
                               00380014

Name                         : coerce-c-store-rq - moo-pwo2vna - mergeSpecificCharSet
DIMSE                        : C_STORE_RQ
DICOM Transfer Role          : SCU
Conditions                   : ReceivingApplicationEntityTitle=VNADEVA_MOO.*|VNADEVB_MOO.*|VNADEVA_PWO.*|VNADEVB_PWO.*
Attribute Coercion Priority  : 2
Attribute Coercion URI       : merge-attrs:
DICOM Attribute Coercion     : SpecificCharacterSet=ISO_IR 100
Parameter(s)

Name                         : coerce-c-store-rq - moo-pwo2vna - mergeSpecificCharSet
DIMSE                        : C_STORE_RQ
DICOM Transfer Role          : SCU
Conditions                   : ReceivingApplicationEntityTitle=VNADEVA_MOO.*|VNADEVB_MOO.*|VNADEVA_PWO.*|VNADEVB_PWO.*
Attribute Coercion Priority  : 1
Attribute Coercion URI       : sup-from-dev:
Device Name Coercion         : ehCOS-ADT
Parameter

Name                         : coerce-c-store-rq - moo-pwo2vna - mergeSpecificCharSet
DIMSE                        : C_STORE_RQ
DICOM Transfer Role          : SCU
Conditions                   : ReceivingApplicationEntityTitle=VNADEVA_MOO.*|VNADEVB_MOO.*|VNADEVA_PWO.*|VNADEVB_PWO.*
Attribute Coercion Priority  : 0
Attribute Coercion URI       : merge-mwl:${jboss.server.temp.url}/dcm4chee-arc/mwl2study-cuf.xsl
Other Coercion Parameter(s)  : match-by=AccessionNumber
                               local-mwl-scp=CBLM_CUFVNA|CALM_CUFVNA|CALV_CUFVNA|HTJO_CUFVNA|HSTR_CUFVNA

Через Ldif

dn: cn=coerce-c-store-rq - moo-pwo2vna - nullifyIssuers,dicomDeviceName=arc1-a,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
objectClass: dcmArchiveAttributeCoercion2
cn: coerce-c-store-rq - moo-pwo2vna - nullifyIssuers
dcmDIMSE: C_STORE_RQ
dicomTransferRole: SCU
dcmRulePriority: 3
dcmProperty: ReceivingApplicationEntityTitle=VNADEVA_MOO.*|VNADEVB_MOO.*|VNADEVA_PWO.*|VNADEVB_PWO.*
dcmURI: merge-attrs:
dcmCoercionParam: 00080051=
dcmCoercionParam: 00100021=
dcmCoercionParam: 00100024=
dcmCoercionParam: 00380014=

dn: cn=coerce-c-store-rq - moo-pwo2vna - mergeSpecificCharSet,dicomDeviceName=arc1-a,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
objectClass: dcmArchiveAttributeCoercion2
cn: coerce-c-store-rq - moo-pwo2vna - mergeSpecificCharSet
dcmDIMSE: C_STORE_RQ
dicomTransferRole: SCU
dcmRulePriority: 2
dcmProperty: ReceivingApplicationEntityTitle=VNADEVA_MOO.*|VNADEVB_MOO.*|VNADEVA_PWO.*|VNADEVB_PWO.*
dcmURI: merge-attrs:
dcmCoercionParam: 00080005=ISO_IR 100

dn: cn=coerce-c-store-rq - moo-pwo2vna - supplementIssuerOfPIDFromDevice,dicomDeviceName=arc1-a,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
objectClass: dcmArchiveAttributeCoercion2
cn: coerce-c-store-rq - moo-pwo2vna - supplementIssuerOfPIDFromDevice
dcmDIMSE: C_STORE_RQ
dicomTransferRole: SCU
dcmRulePriority: 1
dcmProperty: ReceivingApplicationEntityTitle=VNADEVA_MOO.*|VNADEVB_MOO.*|VNADEVA_PWO.*|VNADEVB_PWO.*
dcmURI: sup-from-dev:
dcmSupplementFromDeviceReference: dicomDeviceName=ehCOS-ADT,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org

dn: cn=coerce-c-store-rq - moo-pwo2vna - mergeMWL,dicomDeviceName=arc1-a,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
objectClass: dcmArchiveAttributeCoercion2
cn: coerce-c-store-rq - moo-pwo2vna - mergeMWL
dcmDIMSE: C_STORE_RQ
dicomTransferRole: SCU
dcmRulePriority: 0
dcmProperty: ReceivingApplicationEntityTitle=VNADEVA_MOO.*|VNADEVB_MOO.*|VNADEVA_PWO.*|VNADEVB_PWO.*
dcmURI: merge-mwl:${jboss.server.temp.url}/dcm4chee-arc/mwl2study-cuf.xsl
dcmSupplementFromDeviceReference: dicomDeviceName=ehCOS-ADT,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org