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

Формат ответа «AdhocQueryResponse» приведен в 2.

XDS. UC-2 [ITI-41] «Предоставить и зарегистрировать набор документов» (Provide and Register Document Set-b) Введение

Транзакция ITI-41 «Предоставить и зарегистрировать набор документов» (Provide and Register Document Set-b) используется для передачи набора документов и связанных метаданных из Источника документов в Репозиторий документов. Документы и метаданные могут храниться в Репозиторий документов для дальнейшего извлечения или обработки набора документов в зависимости от рабочего процесса и потребностей.

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

Входной информацией транзакции ITI-41 «Предоставить и зарегистрировать набор документов» профиля IHE XDS является запрос «ProvideAndRegisterDocumentSetRequest» Источника документов (Document Source) на предоставление и регистрацию набора документов, запрос содержит метаданные и документы, представляемые для регистрации в Репозитории документов (Document Repository).

Формат запроса «ProvideAndRegisterDocumentSetRequest» приведен в 3.

Обработка

На рисунке 3 представлена диаграмма последовательности, отражающая обмен сообщениями в рамках транзакции ITI-41 «Предоставить и зарегистрировать набор документов» (Provide and Register Document Set-b).

Рисунок 3 – Диаграмма последовательности транзакции ITI-41 «Предоставить и зарегистрировать набор документов» (Provide and Register Document Set-b)

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

Источник документа (Document Source) направляет запрос на предоставление и регистрацию набора документов (Provide And Register Document Set) Репозиторию документов (Document Repository); Репозиторий документов (Document Repository) обрабатывает запрос и направляет ответ на запрос на предоставление и регистрацию набора документов (Provide And Register Document Set Response) Источнику документа (Document Source).

Пример SOAP-запроса Источника документов (Document Source) в рамках транзакции ITI-41 «Предоставить и зарегистрировать набор документов» приведен в 2.1.

Пример SOAP-ответа Репозитория документов (Document Repository) в рамках транзакции ITI-41 «Предоставить и зарегистрировать набор документов» приведен в 2.2.

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

Общие требования, ограничения и допущения к транзакции ITI-41 «Предоставить и зарегистрировать набор документов» (Provide and Register Document Set-b) приведены в таблице 8.

Таблица 8 – Общие требования, ограничения и допущения к транзакции IHE XDS ITI-41 «Предоставить и зарегистрировать набор документов» (Provide and Register Document Set-b)

Код	Требование, ограничение или допущение	Источник возникновения
Отправитель данных (Content Sender) должен генерировать запрос в рамках транзакции [ITI-41] «Предоставить и зарегистрировать набор документов» (Provide and Register Document Set-b) в формате MTOM/XOP.	IHE ITI TF [RF-4] Vol2b, раздел 3.41.4.1.2
Получатель данных (Content Receiver) должен принимать документы в рамках транзакции [ITI-41] «Предоставить и зарегистрировать набор документов» (Provide and Register Document Set-b) в формате MTOM/XOP.	IHE ITI TF [RF-4] Vol2b, раздел 3.41.4.1.2
При получении запроса на предоставление и регистрацию набора документов Получатель данных (Content Receiver) должен обработать запрос. Если обнаружена ошибка во время обработки, Получатель данных (Content Receiver) должен вернуть сообщение об ошибке Отправителю данных (Content Sender), таким образом, завершая эту транзакцию.	IHE ITI TF [RF-4] Vol2b, раздел 3.41.4.1.3
Получатель данных (Content Receiver) должен иметь возможность принимать запрос, включающий несколько документов (Отправитель данных (Content Sender) может отправить один документ или несколько в зависимости от потребностей).	IHE ITI TF [RF-4] Vol2b, раздел 3.41.4.1.3
Получатель данных (Content Receiver) должен проверять полученные метаданные. Для каждого полученного документа Получатель данных (Content Receiver) должен: Проверить атрибут «hash» (если полученное значение хеш-кода отличается от вычисляемого, представленного документа, Получатель данных (Content Receiver) должен отклонить регистрацию и отправить сообщение об ошибке «XDSRepositoryMetadataError»); Проверить атрибут «size» (если полученное значение размера отличается от бинарного размера полученного документа, Получатель данных (Content Receiver) должен отклонить регистрацию и отправить сообщение об ошибке «XDSRepositoryMetadataError»).	IHE ITI TF [RF-4] Vol2b, раздел 3.41.4.1.3
Следующие допущения должны быть соблюдены: Представленные метаданные включают папки «Folders», и Получатель данных (Content Receiver) не может обрабатывать содержимое папки. Ответ должен содержать предупреждение «PartialFolderContentNotProcessed» и текстовое сообщение, что содержимое папке не было обработано; Представленные метаданные включают ассоциации/связи, и Получатель данных (Content Receiver) не может обработать содержание определенных ассоциаций/связей. Для каждой неподдерживаемой ассоциации ответ должен включать предупреждение и текстовое сообщение, что семантика сообщения не была обработана. Определенные предупреждения зависят от ассоциации/связи: «PartialAppendContentNotProcessed», «PartialReplaceContentNotProcessed», «PartialTransformContentNotProcessed», «PartialTransformReplaceContentNotProcessed».	IHE ITI TF [RF-4] Vol2b, раздел 3.41.4.1.3.1
При получении запроса в рамках транзакции [ITI-41] «Предоставить и зарегистрировать набор документов» (Provide and Register Document Set-b) Репозиторий документов (Document Repository) должен: Валидировать и обновлять полученные метаданные документов; Обеспечивать доступность для поиска и извлечения любых полученных документов посредством транзакции [ITI-43] «Извлечь набор документов» (Retrieve Document Set); Передать на регистрацию обновленные метаданные в Реестр документов (Document Registry) посредством транзакции [ITI-42] «Зарегистрировать набор документов» (Register Document Set-b); Сгенерировать ответ в рамках транзакции [ITI-41] «Предоставить и зарегистрировать набор документов». Если встречаются некоторые ошибки во время обработки запроса Репозиторий документов (Document Repository) или Реестр документов (Document Registry) может отменить любые изменения в хранилище данных Репозитория документов (Document Repository).	IHE ITI TF [RF-4] Vol2b, раздел 3.41.4.1.3.2
Перед отправкой запроса на регистрацию набора документов в рамках транзакции [ITI-42] «Зарегистрировать набор документов» (Register Document Set-b) Репозиторий документов (Document Repository) должен обновить полученные метаданные. Для каждого полученного документа Репозиторий документов (Document Repository) должен: Добавить или заменить атрибут «repositoryUniqueId». Данное значение должно определять хранилище документов Репозитория документов (Document Repository); Добавить атрибут «hash», если он не установлен. Данное значение должно быть установлено на основании  хеш-кода полученного документа, сформированного по алгоритму SHA1 (Secure Hash Algorithm 1 — алгоритм криптографического хеширования); Добавить атрибут «size», если он не установлен. Данное значение должно соответствовать размеру полученного документа.	IHE ITI TF [RF-4] Vol2b, раздел 3.41.4.1.3.2
Для каждого полученного документа Репозиторий документов (Document Repository) может валидировать атрибут «uniqueId». Запрос может быть отклонен и возвращена ошибка, если атрибут «uniqueId» полученного документа соответствует документу в Репозитории документов (Document Repository), а размер «sizes» или «hash» двух документов отличаются. Сообщение ошибки зависит от того, какие атрибуты различаются (XDSNonIdenticalSize – отличается размер, XDSNonIdenticalHash – отличается хэш). Репозиторий документов (Document Repository) не должен генерировать сообщение об ошибке связанное с дублированием, если атрибут «uniqueId» соответствует документу в Репозитории документов (Document Repository), а также значения параметров «sizes» и «hash» двух документов совпадают.	IHE ITI TF [RF-4] Vol2b, раздел 3.41.4.1.3.2
Репозиторий документов (Document Repository) должен обеспечивать доступность для поиска и извлечения любых полученных документов посредством транзакции [ITI-43] «Извлечь набор документов» (Retrieve Document Set). Если «uniqueId» документа уже известен Репозиторию документов (Document Repository), то никаких действий не требуется. Иначе Репозиторию документов (Document Repository) должен: Сохранить полученный бинарный поток документа; Сохранить полученные «mimeType» и «uniqueId» документа и связывать их с полученным бинарным потоком документа.	IHE ITI TF [RF-4] Vol2b, раздел 3.41.4.1.3.2
Репозиторий документов (Document Repository) должен инициировать запрос на регистрацию набора документов в рамках транзакции [ITI-42] «Зарегистрировать набор документов» (Register Document Set-b) в Реестр документа (Document Registry) с полученными (обновленными) метаданными. Если ответ в рамках транзакции [ITI-42] «Зарегистрировать набор документов» (Register Document Set-b) включает какие-либо ошибки или предупреждения, Репозиторий документов (Document Repository) должен включить все полученные ошибки и предупреждения в ответ в рамках транзакции [ITI-41] «Предоставить и зарегистрировать набор документов» (Provide and Register Document Set-b).	IHE ITI TF [RF-4] Vol2b, раздел 3.41.4.1.3.2
Получатель данных (Content Receiver) должен генерировать ответ на запрос в рамках транзакции [ITI-41] «Предоставить и зарегистрировать набор документов» (Provide and Register Document Set-b) в формате MTOM/XOP.	IHE ITI TF [RF-4] Vol2b, раздел 3.41.4.2.1.2
Отправитель данных (Content Sender) должен принимать ответ на запрос в рамках транзакции [ITI-41] «Предоставить и зарегистрировать набор документов» (Provide and Register Document Set-b) в формате MTOM/XOP.	IHE ITI TF [RF-4] Vol2b, раздел 3.41.4.2.1.2
Репозиторий документов (Document Repository) должен поддерживать асинхронные веб-сервисы запроса и ответа (Asynchronous Web Services Exchange) для транзакции [ITI-41] «Предоставить и зарегистрировать набор документов» (Provide and Register Document Set-b).	IHE ITI TF [RF-4] Vol2b, раздел 3.41.4.2.2.1

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

Выходной информацией транзакции ITI-41 «Предоставить и зарегистрировать набор документов» (Provide and Register Document Set-b) профиля IHE XDS является ответ «RegistryResponse» на запрос «ProvideAndRegisterDocumentSetRequest».