Обмен документами между медицинскими учреждениями (стр. 8 )

Рисунок 5 – Диаграмма последовательности транзакции ITI-43 «Извлечь набор документов» (Retrieve Document Set)

Основной сценарий:

Потребитель документов (Document Consumer) направляет запрос на извлечение набора документов (Retrieve Document Set Request) Репозиторию документов (Document Repository), Инициализирующему шлюзу (Initiating Gateway) или Источнику документов по требованию (On-demand document source); Репозиторий документов (Document Repository), Инициализирующий шлюз (Initiating Gateway) или Источник документов по требованию (On-demand document source) обрабатывает запрос и направляет ответ по извлечению набора документов (Retrieve Document Set Response) Потребителю документов (Document Consumer).

Пример SOAP-запроса (RetrieveDocumentSetRequest) в рамках транзакции ITI-43 «Извлечь набор документов» (Retrieve Document Set) приведен в 4.1.

Пример SOAP-ответа (RetrieveDocumentSetResponse) в рамках транзакции ITI-43 «Извлечь набор документов» (Retrieve Document Set)  приведен в 4.2.

Каждый выполняемый запрос и ответ транзакции ITI-43 «Извлечь набор документов» (Retrieve Document Set) должен сопровождаться отправкой сообщений аудита (Audit message) в Журнал регистрации событий в соответствии c требованиями транзакции ITI-20 «Записать в журнал событий» (Record Audit Event) профиля IHE ATNA [RF-5]. Структура сообщений аудита приведена в приложении Г.4.

Общие требования, ограничения и допущения к транзакции ITI-43 «Извлечь набор документов» (Retrieve Document Set) приведены в таблице 10.

Таблица 10 – Общие требования, ограничения и допущения к транзакции IHE XDS ITI-43 «Извлечь набор документов» (Retrieve Document Set)

Код	Требование, ограничение или допущение	Источник возникновения
Потребитель документов (Document Consumer) должен соблюдать Политику области действия XDS (XDS Affinity Domain Policies), представленную кодом конфиденциальности (confidentialityCode) в метаданных, связанных с документом	IHE ITI TF [RF-4] Vol2b, раздел 3.43.4.1.3.1
Потребитель документов (Document Consumer) должен иметь возможность настройки в соответствии с Политикой конфиденциальности пациента (Patient Privacy Policies), идентификаторами политики конфиденциальности пациента (OIDs) и связанной информацией, необходимой для понимания и применения Политики области действия XDS (XDS Affinity Domain Policies)	IHE ITI TF [RF-4] Vol2b, раздел 3.43.4.1.3.1
Ответ в рамках транзакции ITI-43 «Извлечь набор документов» (Retrieve Document Set)  должен содержать следующую информацию по каждому возвращаемому документу: Элемент «homeCommunityId», значение которого должно соответствовать значению элемента «homeCommunityId», полученного в запросе на извлечение набора документов (Retrieve Document Set Request). Если «homeCommunityId» не указано в запросе на извлечение набора документов (Retrieve Document Set Request), то оно не должно быть указано и в ответе по извлечению документов (Retrieve Document Set Response Message); Элемент «repositoryUniqueId», который определяет репозиторий, из которого документ извлечен. Значение данного элемента должно соответствовать значению элемента «repositoryUniqueId» из запроса на извлечение набора документов (Retrieve Document Set Request). Это значение соответствует XDSDocumentEntry. repositoryUniqueId; Элемент «documentUniqueId», который определяет документ внутри репозитория. Значение данного элемента должно соответствовать значению элемента documentUniqueId из запроса на извлечение набора документов (Retrieve Document Set Request). Это значение соответствует XDSDocumentEntry. uniqueId; Извлеченный документ в качестве набора данных XOP (XOP Infoset); MIME-тип извлеченного документа; Ошибки или предупреждения в случае, если документ не был успешно извлечен.	IHE ITI TF [RF-4] Vol2b, раздел 3.43.4.2.2
Если идентификатор «documentUniqueId» ассоциирован с записью документа по требованию (On-Demand Document Entry), тогда ответ в рамках транзакции ITI-43 «Извлечь набор документов» (Retrieve Document Set) должен содержать элемент NewDocumentUniqueId, который определяет возвращаемый в ответе документ. Данный идентификатор должен отличаться от элемента «DocumentUniqueId», который определяет запись документа по требованию (On-Demand Document Entry).	IHE ITI TF [RF-4] Vol2b, раздел 3.43.4.2.2
Если у нескольких полученных документов совпадают значения элементов «DocumentUniqueId», а также совпадают значения элементов «NewDocumentUniqueId», тогда содержимое документов должно быть идентично.	IHE ITI TF [RF-4] Vol2b, раздел 3.43.4.2.2
Источник документов по требованию (On-demand document source), поддерживающий опцию «Хранение извлеченных документов» (Persistence of Retrieved Documents Option), должен сохранять содержимое документа, возвращаемого в ответе, и регистрировать запись документа (Stable Document Entry), которая описывает сохраненный документ. Источник документов по требованию (On-demand document source) должен завершить регистрацию записи документа (Stable Document Entry) до отправки ответа в рамках транзакции ITI-43 «Извлечь набор документов» (Retrieve Document Set).	IHE ITI TF [RF-4] Vol2b, раздел 3.43.4.2.3
Исполнители транзакции ITI-43 «Извлечь набор документов» (Retrieve Document Set) должны соответствовать требованиям спецификации IHE ITI TF [RF-4] (Vol 2x, раздел Appendix V: Web Services for IHE Transactions).	IHE ITI TF [RF-4] Vol2b, раздел 3.43.5
Транзакция ITI-43 «Извлечь набор документов» (Retrieve Document Set) должна использовать SOAP 1.2 и MTOM в кодировке XOP (MTOM/XOP).	IHE ITI TF [RF-4] Vol2b, раздел 3.43.5
Репозиторий документов (Document Repository) должен принимать запрос в рамках транзакции ITI-43 «Извлечь набор документов» (Retrieve Document Set) в формате MTOM/XOP	IHE ITI TF [RF-4] Vol2b, раздел 3.43.5
Репозиторий документов (Document Repository) должен генерировать ответа в рамках транзакции ITI-43 «Извлечь набор документов» (Retrieve Document Set) в формате MTOM/XOP	IHE ITI TF [RF-4] Vol2b, раздел 3.43.5
Потребитель документов (Document Consumer) должен генерировать запрос в рамках транзакции ITI-43 «Извлечь набор документов» (Retrieve Document Set) в формате MTOM/XOP	IHE ITI TF [RF-4] Vol2b, раздел 3.43.5
Потребитель документов (Document Consumer) должен принимать ответ в рамках транзакции ITI-43 «Извлечь набор документов» (Retrieve Document Set) в формате MTOM/XOP	IHE ITI TF [RF-4] Vol2b, раздел 3.43.5
Должны быть определены следующие пространства имен в WSDL: ihe: «urn:ihe:iti:xds-b:2007»; rs: «urn:oasis:names:tc:ebxml-regrep:xsd:rs:3.0»; lcm: «urn:oasis:names:tc:ebxml-regrep:xsd:lcm:3.0»; query: «urn:oasis:names:tc:ebxml-regrep:xsd:query:3.0».	IHE ITI TF [RF-4] Vol2b, раздел 3.43.5
Следующее значение должно быть импортировано (xsd:import) в секцию /definitions/types: namespace=" urn:ihe:iti:xds-b:2007", schema="IHEXDS. xsd"	IHE ITI TF [RF-4] Vol2b, раздел 3.43.5
Атрибут /definitions/message/part/@element должен быть определен как “ihe:RetrieveDocumentSetRequest” для запроса в рамках транзакции ITI-43 «Извлечь набор документов» (Retrieve Document Set).	IHE ITI TF [RF-4] Vol2b, раздел 3.43.5
Атрибут /definitions/message/part/@element должен быть определен как “ihe:RetrieveDocumentSetResponse” ответа в рамках транзакции ITI-43 «Извлечь набор документов» (Retrieve Document Set).	IHE ITI TF [RF-4] Vol2b, раздел 3.43.5
Дополнительные требования к атрибутам: Атрибут Значение /definitions/portType/ operation@name DocumentConsumer_ RetrieveDocumentSet /definitions/portType/ peration/input/@wsaw:Action urn:ihe:iti:2007: RetrieveDocumentSet /definitions/portType/ operation/output/@wsaw:Action urn:ihe:iti:2007: RetrieveDocumentSetResponse /definitions/binding/ operation/soap12:operation/ @soapAction urn:ihe:iti:2007: RetrieveDocumentSet	IHE ITI TF [RF-4] Vol2b, раздел 3.43.5
Для поддержки опции «Асинхронные веб-сервисы» (Asynchronous Web Services Exchange Option) на стороне Потребителя документа (Document Consumer), Репозиторий документов (Document Repository) должен поддерживать использование неанонимного ответа, содержащего  структуру «Endpoint Reference(EPR)» в заголовке «replyTo» WS-Addressing	IHE ITI TF [RF-4] Vol2b, раздел 3.43.5
Элемент <ihe:RetrieveDocumentSetRequest/> должен быть определен как: 1..* элементов <ihe:DocumentRequest/>, каждый из которых представлен индивидуальным документом, который Потребитель документов (Document Consumer) желает получить от Репозитория документов (Document Repository). Каждый элемент <ihe:DocumentRequest/> должен содержать: Обязательный элемент <ihe:RepositoryUniqueId/>, который идентифицирует репозиторий, из которого должны быть извлечены документы; Обязательный элемент <ihe:DocumentUniqueId/>, который идентифицирует документ, внутри репозитория; Необязательный элемент <ihe:HomeCommunityId/>.	IHE ITI TF [RF-4] Vol2b, раздел 3.43.5
Элемент <ihe:RetrieveDocumentResponse/> должен быть определен как: Обязательный элемент /ihe:RetrieveDocumentSetResponse/rs:RegistryResponse; Необязательная последовательность элементов <ihe:DocumentResponse/>, которые содержат: Элемент <ihe:HomeCommunityId/>. Значение этого элемента должно быть идентичным значению элемента /RetrieveDocumentSetRequest/ DocumentRequest/HomeCommunityId запроса на извлечение набора документов (Retrieve Document Set Request). Если элемент <ihe:HomeCommunityId/> не представлен в запросе на извлечение набора документов (Retrieve Document Set Request), тогда и в ответе данное значение не должно быть указано; Обязательный элемент <ihe:RepositoryUniqueId/>, который идентифицирует репозиторий, из которого должны быть извлечены документы. Его значение должно быть идентичным значению элемента /RetrieveDocumentSetRequest/DocumentRequest/ RepositoryUniqueId сообщения запроса на извлечение набора документов (Retrieve Document Set Request). Это значение соответствует XDSDocumentEntry. repositoryUniqueId; Обязательный элемент <ihe:DocumentUniqueId/>, который идентифицирует документ, внутри репозитория. Его значение должно быть идентичным значению элемента /RetrieveDocumentSetRequest/DocumentRequest/ DocumentUniqueId сообщения запроса на извлечение набора документов (Retrieve Document Set Request). Это значение соответствует XDSDocumentEntry. uniqueId. Обязательный элемент <ihe:Document/>, который содержит извлеченный документ в кодировке base64binary; Обязательный элемент <ihe:mimeType/>, который определят MIME-тип извлеченного документа; Необязательный элемент <ihe:NewDocumentUniqueId/>, который идентифицирует документ, возвращаемый в ответе, когда извлекается документ по требованию. Этот элемент является обязательным, если извлекается документ по требованию; Необязательный элемент <ihe:NewRepositoryUniqueId/>, который идентифицирует Репозиторий документов (Document Repository), который будет поддерживать извлечение документа, созданного в качестве результата запроса документа по требованию. Этот элемент является обязательным, если Источник документа по требованию (On-Demand Document Source) поддерживает опцию «Хранение извлеченного документа» (Persistence of Retrieved Documents Option).	IHE ITI TF [RF-4] Vol2b, раздел 3.43.5
Атрибут /RetrieveDocumentSetResponse/rs:RegistryResponse/@status предоставляет общий статус запроса: он может содержать одно из следующих значений: urn:oasis:names:tc:ebxml-regrep:ResponseStatusType:Success (успешно); urn:ihe:iti:2007:ResponseStatusType:PartialSuccess (частично успешно); urn:oasis:names:tc:ebxml-regrep:ResponseStatusType:Failure (неудачно).	IHE ITI TF [RF-4] Vol2b, раздел 3.43.5
Для каждого документа, запрошенного в элементе /RetrieveDocumentSetRequest/DocumentRequest: Если возникло предупреждение при извлечении документа, тогда элемент /RetrieveDocumentSetResponse/rs:RegistryResponse/ rs:RegistryErrorList/rs:RegistryError должен быть возвращен со следующими значениями атрибутов: @severity = urn:oasis:names:tc:ebxml-regrep:ErrorSeverityType:Warning; @errorCode содержит код предупреждения; @codeContext содержит сообщение предупреждения; @location содержит DocumentUniqueId запрошенного документа. Документ должен быть возвращен в составе экземпляра /RetrieveDocumentSetResponse/DocumentResponse/Document в качестве набора данных XOP (XOP Infoset). Возвращенный документ и предупреждения должны коррелироваться по DocumentUniqueId; Если возникла ошибка при извлечении документа, тогда элемент /RetrieveDocumentSetResponse/rs:RegistryResponse/ rs:RegistryErrorList/rs:RegistryError должен быть возвращен со следующими значениями атрибутов: @severity = urn:oasis:names:tc:ebxml-regrep:ErrorSeverityType:Error; @errorCode содержит код ошибки; @codeContext содержит сообщение ошибки; @location содержит DocumentUniqueId запрошенного документа. Никаких соответствующих элементов RetrieveDocumentSetResponse/DocumentResponse не должно быть возвращено; Если документ извлечен успешно (без предупреждений), тогда элемент /RetrieveDocumentSetResponse/rs:RegistryResponse/ rs:RegistryErrorList/rs:RegistryError не должен быть представлен, и элемент /RetrieveDocumentSetResponse/DocumentResponse/Document должен быть возвращен с содержанием набора данных документа в формате XOP (XOP Infoset).	IHE ITI TF [RF-4] Vol2b, раздел 3.43.5
Элемент /RetrieveDocumentSetResponse/rs:RegistryResponse/rs:ResponseSlotList не используется в транзакции [ITI-43] «Извлечь набор документов» (Retrieve Document Set)	IHE ITI TF [RF-4] Vol2b, раздел 3.43.5
Элемент /RetrieveDocumentSetResponse/rs:RegistryResponse/@requestId не используется в транзакции [ITI-43] «Извлечь набор документов» (Retrieve Document Set)	IHE ITI TF [RF-4] Vol2b, раздел 3.43.5
Если одна часть документов была извлечена успешно, а другая – нет, тогда участники должны генерировать событие аудита об успешном извлечении «success» для тех документов, которые были извлечены успешно, и событие аудита о неуспешном извлечении «failure» для остальных.	IHE ITI TF [RF-4] Vol2b, раздел 3.43.6.1

Выходная информация

Выходной информацией транзакции ITI-43 «Извлечь набор документов» (Retrieve Document Set) профиля IHE XDS является ответ «RetrieveDocumentSetResponse» на запрос «RetrieveDocumentSetRequest».