Изменения API службы DICOM версии 2
Это справочное руководство содержит сводку изменений в API версии 2 службы DICOM®. Чтобы просмотреть полный набор возможностей в версии 2, см . инструкцию о соответствии DICOM версии 2.
Сводка изменений в версии 2
Store (Сохранить)
Проверка необязательных атрибутов
В предыдущих версиях запрос Магазина завершается ошибкой, если какой-либо из обязательных или доступных для поиска атрибутов завершается ошибкой проверки. Начиная с версии 2 запрос завершается ошибкой, только если необходимые атрибуты завершаются проверкой.
Сбой проверки атрибутов, не необходимых API, приводит к тому, что файл хранится с предупреждением в ответе. Предупреждения приводят к получению кода 202 Accepted возврата HTTP и полезных данных ответа содержит WarningReason тег (0008, 1196).
Предупреждение предоставляется о каждом неудачном атрибуте для каждого экземпляра. Если последовательность содержит атрибут, завершающийся ошибкой проверки или при наличии нескольких проблем с одним атрибутом, отмечается только первая причина сбоя атрибута.
Существует несколько заметных действий для необязательных атрибутов, которые завершаются проверкой отказа:
- Выполняет поиск атрибута, который завершился ошибкой проверки, возвращает исследование или ряд или экземпляр, если значение исправляется одним из нескольких способов, упоминание указанных ниже.
- Атрибуты не возвращаются при получении метаданных через конечные точки WADO
/metadata.
Получение исследования или ряда или экземпляра всегда возвращает исходные двоичные файлы с исходными атрибутами, даже если эти атрибуты не прошли проверку.
Если атрибут заполняется значением NULL, атрибут индексируется при возможности поиска и хранится как в метаданных dicom+json. Предупреждение проверки не предоставляется.
Извлечь
Поддержка извлечения одного кадра
Извлечение одного кадра поддерживается путем добавления следующего Accept заголовка:
application/octet-stream; transfer-syntax=*
Search
Результаты поиска могут быть неполными для тегов расширенных запросов с предупреждениями проверки
В API версии 1 и продолжается для версии 2, если тег расширенного запроса имеет какие-либо ошибки, так как один или несколько существующих экземпляров имели значение тега, которое не удалось индексировать, а затем последующие поисковые запросы, содержащие расширенный тег запроса, возвращаются erroneous-dicom-attributes , как описано в документации. Однако теги (также известные как атрибуты) с предупреждениями проверки из STOW-RS не включены в этот заголовок. Если запрос хранилища приводит к предупреждениям проверки для атрибутов, доступных для поиска во время хранения экземпляра, эти атрибуты могут не использоваться для поиска хранимого экземпляра. Однако любые атрибуты , доступные для поиска, которые не удалось проверить, смогут возвращать результаты, если значения перезаписываются экземплярами в одном исследовании или рядах, хранящихся после сбоя, или если значения уже хранятся правильно предыдущим экземпляром. Если значения атрибутов не перезаписаны, они не будут создавать результаты поиска.
Атрибут можно исправить следующим образом:
- Удаление сохраненного экземпляра и отправка нового экземпляра с исправленными данными
- Отправка нового экземпляра в том же исследовании или серии с исправленными данными
Меньше атрибутов исследования, ряда и экземпляра возвращаются по умолчанию
Набор атрибутов, возвращаемых по умолчанию, был сокращен для повышения производительности. Подробный список см. в документации по поиску.
Атрибуты добавлены только что к тегам по умолчанию.
| Уровень тега | Тег | Имя атрибута |
|---|---|---|
| Исследование | (0008, 1030) | StudyDescription |
| Series | (0008, 1090) | ManufacturerModelName |
Атрибуты удалены из тегов по умолчанию.
| Уровень тега | Тег | Имя атрибута |
|---|---|---|
| Исследование | (0008, 0005) | SpecificCharacterSet |
| Исследование | (0008, 0030) | StudyTime |
| Исследование | (0008, 0056) | InstanceAvailability |
| Исследование | (0008, 0201) | TimezoneOffsetFromUTC |
| Исследование | (0010, 0040) | Пациенты |
| Исследование | (0020, 0010) | StudyID |
| Series | (0008, 0005) | SpecificCharacterSet |
| Series | (0008, 0201) | TimezoneOffsetFromUTC |
| Series | (0008, 103E) | SeriesDescription |
| Series | (0040, 0245) | PerformedProcedureStepStartTime |
| Series | (0040, 0275) | RequestAttributesSequence |
| Экземпляр | (0008, 0005) | SpecificCharacterSet |
| Экземпляр | (0008, 0016) | SOPClassUID |
| Экземпляр | (0008, 0056) | InstanceAvailability |
| Экземпляр | (0008, 0201) | TimezoneOffsetFromUTC |
| Экземпляр | (0020, 0013) | InstanceNumber |
| Экземпляр | (0028, 0010) | Строки |
| Экземпляр | (0028, 0011) | Столбцы |
| Экземпляр | (0028, 0100) | BitsAllocated |
| Экземпляр | (0028, 0008) | NumberOfFrames |
Все удаленные теги являются частью дополнительных тегов, которые будут возвращены при запросе.includefield = all
Атрибуты с заполнением null можно искать с заполнением или без нее
При хранении атрибута с помощью заполнения null его можно искать с помощью или без кодирования URI или без него. Полученные результаты предназначены для атрибутов, хранящихся как с заполнением null, так и без заполнения null.
Operations
Состояние completed было переименовано в succeeded
Чтобы соответствовать рекомендациям ПО REST API Майкрософт, completed состояние было переименовано succeededв .
Канал изменений
Канал изменений теперь принимает диапазон времени
API канала изменений теперь принимает необязательные startTime параметры, endTime чтобы помочь область результатов. Изменения в диапазоне времени по-прежнему могут быть разбиены на страницы с помощью существующих offset и limit параметров. Смещение относительно периода времени, определенного startTime и endTime. Например, пятая запись канала изменений начиная с 7.24.2023 в 09:00 UTC будет использовать строку ?startTime=2023-07-24T09:00:00Z&offset=5запроса.
Для версии 2 рекомендуется всегда включать диапазон времени для повышения производительности.
Примечание.
DICOM® является зарегистрированным товарным знаком Национальной ассоциации производителей электрических технологий для публикаций по стандартам, касающихся цифровых коммуникаций медицинской информации.