Формат запроса «AdhocQueryRequest» приведен в 1.
Стандартным запросам транзакции ITI-18 «Запросить набор документов» профиля IHE XDS присвоены идентификаторы (Query IDs), указанные в таблице 6. Данные идентификаторы используются в параметре запроса (AdhocQueryRequest) для того, чтобы ссылаться на запрос, хранимый в Реестре документов (Document Registry). Идентификаторы имеют формат UUID. Параметры запросов приведены в
Если идентификатор не поддерживается, тогда должно возвращаться сообщение об ошибке.
Таблица 6 – Идентификаторы запросов
№ | Наименование запроса | Идентификатор запроса |
Найти документы (FindDocuments) | urn:uuid:14d4debf-8f97-4251-9a74-a90016b0af0d | |
Найти наборы представления (FindSubmissionSets) | urn:uuid:f26abbcb-ac74-4422-8a30- edb644bbc1a9 | |
Найти папки (FindFolders) | urn:uuid:958f3006-baad-4929-a4de-ff1114824431 | |
Получить все (GetAll) | urn:uuid:10b545ea-725c-446d-9b95-8aeb444eddf3 | |
Получить документы (GetDocuments) | urn:uuid:5c4f972b-d56b-40ac-a5fc-c8ca9b40b9d4 | |
Получить папки (GetFolders) | urn:uuid:5737b14c-8a1a-4539-b659-e03a34a5e1e4 | |
Получить связи/ассоциации (GetAssociations) | urn:uuid:a7ae438b-4bc2-4642-93e9-be891f7bb155 | |
Получить документы и связи/ассоциации (GetDocumentsAndAssociations) | urn:uuid:bab9529a-4a10-40b3-a01f-f68a615d247a | |
Получить наборы представления (GetSubmissionSets) | urn:uuid:51224314-5390-4169-9b91-b1980040715a | |
Получить наборы представления и содержимое (GetSubmissionSetAndContents) | urn:uuid:e8e3cb2c-e39c-46b9-99e4-c12f57260b83 | |
Получить папки и содержимое (GetFolderAndContents) | urn:uuid:b909a503-523d-4517-8acf-8e5834dfc4c7 | |
Получить папки для документов (GetFoldersForDocument) | urn:uuid:10cae35a-c7f9-4cf5-b61e-fc3278ffb578 | |
Получить связанные документы (GetRelatedDocuments) | urn:uuid:d90e5407-b356-4d91-a89f-873917b4b0e6 | |
Найти документы по идентификатору (FindDocumentsByReferenceId) | urn:uuid:12941a89-e02e-4be5-967c-ce4bfc8fe492 |
На рисунке 2
Рисунок 2 представлена диаграмма последовательности, отражающая обмен сообщениями в рамках транзакции ITI-18 «Запросить набор документов» (Registry Stored Query).

Рисунок 2 – Диаграмма последовательности транзакции ITI-18 «Запросить набор документов» (Registry Stored Query)
Основной сценарий:
Потребитель документов (Document Consumer) направляет запрос набора документов (Registry Stored Query) Реестру документов (Document Registry); Реестр документов (Document Registry) обрабатывает запрос и направляет ответ на запрос набора документов (RegistryStoredQueryResponse) Потребителю документов (Document Consumer).Пример SOAP-запроса (RegistryStoredQueryRequest) Потребителя документов (Document Consumer) в рамках транзакции ITI-18 «Запросить набор документов» приведен в Приложении 1.1.
Пример SOAP-ответа (RegistryStoredQueryResponse) Реестра документов (Document Registry) в рамках транзакции ITI-18 «Запросить набор документов» приведен в Приложении 1.2.
Каждый выполняемый запрос и ответ транзакции ITI-18 «Запросить набор документов» (Registry Stored Query) должен сопровождаться отправкой сообщений аудита (Audit message) в Журнал регистрации событий в соответствии c требованиями транзакции ITI-20 «Записать в журнал событий» (Record Audit Event) профиля IHE ATNA [RF-5]. Структура сообщений аудита приведена в приложении Г.1.
Общие требования, ограничения и допущения к транзакции ITI-18 «Запросить набор документов» (Registry Stored Query) приведены в таблице 7.
Таблица 7 – Общие требования, ограничения и допущения к транзакции IHE XDS ITI-18 «Запросить набор документов» (Registry Stored Query)
Код | Требование, ограничение или допущение | Источник возникновения | |||||||||
Потребитель документов (Document Consumer) должен поддерживать асинхронные веб-сервисы (Asynchronous Web Services Exchange) для транзакций [ITI-18] и [ITI-43] | IHE ITI TF [RF-4] Vol2a, раздел 3.18 | ||||||||||
Реестр документов (Document Registry) должен поддерживать асинхронные веб-сервисы (Asynchronous Web Services Exchange) для транзакций [ITI-18] и [ITI-42] | IHE ITI TF [RF-4] Vol2a, раздел 3.18 | ||||||||||
Запрос набора документов (RegistryStoredQueryRequest) должен содержать:
| IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1 | ||||||||||
Значение даты/времени создания документа (XDSDocumentEntry. CreationTime) считается удовлетворяющим параметрам запроса при соблюдении условия: «$XDSDocumentEntryCreationTimeFrom» <= <= «XDSDocumentEntry. CreationTime» < < «$XDSDocumentEntryCreationTimeTo», где «$XDSDocumentEntryCreationTimeFrom» - параметр запроса, определяющий нижнюю границу значения даты/времени создания документа, «$XDSDocumentEntryCreationTimeTo» - параметр запроса, определяющий верхнюю границу значения даты/времени создания документа. | IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1.2.3.3 | ||||||||||
Если атрибут «DocumentEntry. serviceStartTime» записи о документе (объекта «DocumentEntry») не содержит значения и запрос включает значение «$XDSDocumentEntryServiceStartTimeFrom» или «$XDSDocumentEntryServiceStartTimeTo», тогда эти параметры не должны быть использованы для определения, соответствует ли запросу данная запись о документе (объект «DocumentEntry»). | IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1.2.3.3.1 | ||||||||||
Если атрибут «DocumentEntry. serviceStopTime» записи о документе (объекта «DocumentEntry») не содержит значения и запрос включает значение «$XDSDocumentEntryServiceStopTimeFrom» или «$XDSDocumentEntryServiceStopTimeTo», тогда эти параметры не должны быть использованы для определения, соответствует ли запросу данный «DocumentEntry» | IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1.2.3.3.1 | ||||||||||
При определении параметра, содержащего кодированное значение, необходимо использовать сокращенную форму формата HL7 V2.5 CE. Только первый (идентификатор) и третий (схема кодирования) элементы должны быть указаны обязательно. Второй элемент должен быть пустым. Ограничения длины HL7 V2.5 не должны применяться. Пример формата приведен ниже:
Этот параметр может принимать несколько значений, таким образом, пример кодирования в рамках параметра «Slot» выглядит следующим образом:
или
| IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1.2.3.4 | ||||||||||
Должны соблюдаться следующие правила:
В предикате LIKE:
Формат для множественных значений:
или
При кодировании множественных значений может возникнуть потенциальный конфликт между необходимостью кодирования длинного списка значений и ограничением длины схемы на размер значения элемента <Value/>. Значение «Slot» никогда не должно превышать обозначенные схемой ограничения. Таким образом, использование множественных значений внутри «Slot» допускается. Разделение может произойти только между значениями, где каждый элемент «Value» заключен в скобки. | IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1.2.3.5 | ||||||||||
Семантика «AND/OR» для кодированных элементов должна быть доступна только для параметров с множественными значениями (например, «$XDSDocumentEntryEventCodeList»). Параметры с множественными значениями должны быть закодированы одним из двух способов, примеры которых приведены далее. Параметр, указанный как «Slot» с несколькими значениями должен толковаться как дизъюнкция (семантика OR). Например: <rim:Slot name="$XDSDocumentEntryEventCodeList"> <rim:ValueList> <rim:Value>('a')</rim:Value> <rim:Value>('b')</rim:Value> </rim:ValueList> </rim:Slot> должен соответствовать объекту «XDSDocumentEntry» с атрибутом «eventCodeList», содержащим 'a' или 'b'. Следующий пример аналогичен предыдущему в части результата: <rim:Slot name="$XDSDocumentEntryEventCodeList"> <rim:ValueList> <rim:Value>('a','b')</rim:Value> </rim:ValueList> </rim:Slot> Параметр, указанный как несколько элементов «Slot» должен толковаться как конъюнкция (семантика «AND»). Например: <rim:Slot name="$XDSDocumentEntryEventCodeList"> <rim:ValueList> <rim:Value>('a')</rim:Value> </rim:ValueList> </rim:Slot> <rim:Slot name="$XDSDocumentEntryEventCodeList"> <rim:ValueList> <rim:Value>('b')</rim:Value> </rim:ValueList> </rim:Slot> должен соответствовать объекту «XDSDocumentEntry» с атрибутом «eventCodeList», содержащим одновременно 'a' и 'b'. | IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1.2.3.5 | ||||||||||
Значение статуса объектов реестра может быть следующим:
Если Реестр документов (Document Registry) получает посредством транзакции [ITI-18] «Запросить набор документов» значение параметра «$XDSDocumentEntryStatus», которое он не может распознать, тогда Реестр документов (Document Registry) должен игнорировать это значение и обрабатывать транзакцию [ITI-18] «Запросить набор документов» таким образом, если бы данное значение не было указано. | IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1.2.3.6 | ||||||||||
Атрибут status элемента «AdhocQueryResponse» должен содержать одно из следующих значений:
| IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1.2.3.6.1 | ||||||||||
Транзакция [ITI-18] «Запросить набор документов» использует «homeCommunityId», который является глобальным уникальным идентификатором сообщества и используется для конечных точек веб-сервисов для сервисов, которые предоставляют доступ к данным в этом сообществе. «homeCommunityId» структурирован как OID, ограниченный 64 знаками и указанный в синтаксисе URI. Например, «homeCommunityId» - 1.2.3 должен формироваться как «urn: oid:1.2.3» | IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1.2.3.8 | ||||||||||
Наличие или отсутствие необязательного параметра «$XDSDocumentEntryType» вызывает различное поведение Реестра документов (Document Registry). Если данный параметр указан, но Реестр документов (Document Registry) не поддерживает его, тогда Реестр документов (Document Registry) должен игнорировать его. Если данный параметр указан, и Реестр документов (Document Registry) поддерживает его, тогда Реестр документов (Document Registry) возвращает соответствующую информацию:
| IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1.2.5 | ||||||||||
ebXML версии 3.0 поддерживает постраничное разбиение результатов запроса. Взаимодействия между возможностями хранения запросов и возможностями разбиения результатов запроса в рамках стандарта не могут гармонично сочетаться и не рекомендуются к совместному применению. Вместо этого рекомендуется использование возможности постраничного разбиения результатов, реализованного на стороне Потребителя документов (Document Consumer). Это может быть достигнуто путем указания returnType=”ObjectRef” для больших запросов. Вследствие чего будет возвращен список ссылок «UUID» вместо объектов (структур XML). Это практикуется для запросов, возвращающих тысячи объектов. Например, следующая последовательность запросов может быть использована для списка большого количества документов:
ИЛИ
| IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1.2.6 | ||||||||||
Запрос набора документов (RegistryStoredQueryRequest) и ответ на данный запрос (RegistryStoredQueryResponse) должны передаваться с использованием веб-сервисов. | IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1.2.7 | ||||||||||
Реестр документов (Document Registry) должен принимать запрос набора документов (RegistryStoredQueryRequest) в формате сообщения SOAP и формировать ответ на него (RegistryStoredQueryResponse) в формате сообщения SOAP. | IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1.2.7 | ||||||||||
Потребитель документов (Document Consumer) должен генерировать запрос набора документов (RegistryStoredQueryRequest) в формате сообщения SOAP и принимать ответ на него (RegistryStoredQueryResponse) в формате сообщения SOAP | IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1.2.7 | ||||||||||
Атрибут /wsdl:definitions/@name должен иметь значение «DocumentRegistry» | IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1.2.7 | ||||||||||
Должны быть применены следующие соглашения о наименованиях в WSDL: wsdl:definitions/@name="DocumentRegistry": query message -> "RegistryStoredQuery_Message" query response -> "RegistryStoredQuery_Response_Message" portType -> "DocumentRegistry_PortType" operation -> "RegistryStoredQuery" SOAP 1.2 binding -> "DocumentRegistry_Binding_Soap12" SOAP 1.2 port -> "DocumentRegistry_Port_Soap12" | IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1.2.7 | ||||||||||
«targetNamespace» в WSDL должен иметь значение «urn:ihe:iti:xds-b:2007» | IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1.2.7 | ||||||||||
Следующее значение должно быть импортировано (xsd:import) в секцию /definitions/types:
| IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1.2.7 | ||||||||||
Атрибут /definitions/message/part/@element в сообщении запроса набора документов (RegistryStoredQueryRequest) должен быть определен как «query:AdhocQueryRequest» | IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1.2.7 | ||||||||||
Атрибут /definitions/message/part/@element в сообщении ответа по набору документов (RegistryStoredQueryResponse) должен быть определен как «query:AdhocQueryResponse» | IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1.2.7 | ||||||||||
Дополнительные требования к атрибутам:
| IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1.2.7 | ||||||||||
Для поддержки опции «Асинхронные веб-сервисы (Asynchronous Web Services Exchange Option)» на стороне Потребителя документа (Document Consumer), Реестр документов (Document Registry) должен поддерживать использование неанонимного ответа, содержащего структуру «Endpoint Reference(EPR)» в заголовке «replyTo» WS-Addressing | IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1.2.7 | ||||||||||
Реестр документов (Document Registry) должен:
Транзакция [ITI-18] «Запросить набор документов» может содержать в одном сообщении «AdhocQueryResponse» и результат, и ошибки. Для этих целей сообщение «AdhocQueryResponse» содержит в себе одновременно и элемент «RegistryObjectList», и элемент «RegistryErrorList». | IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1.3 | ||||||||||
Если реализована опция «Обеспечение базовой конфиденциальности пациента (Basic Patient Privacy Enforcement Option)», тогда:
| IHE ITI TF [RF-4] Vol2a, раздел 3.18.4.1.3.5 |
Выходной информацией транзакции ITI-18 «Запросить набор документов» профиля IHE XDS является ответ «AdhocQueryResponse» на запрос «AdhocQueryRequest».
|
Из за большого объема этот материал размещен на нескольких страницах:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 |


