Теги расширенных запросов

Общие сведения

По умолчанию служба DICOM поддерживает запросы к тегам DICOM, указанным в инструкции соответствия. Включив расширенные теги запросов, список тегов можно легко расширить в соответствии с потребностями приложения.

С помощью перечисленных ниже API пользователи могут индексировать свои исследования DICOM, ряды и экземпляры как в стандартных, так и в частных тегах DICOM, чтобы их можно было указать в запросах QIDO-RS.

Программные интерфейсы

Версия: v1

Для управления поддерживаемыми тегами в данном экземпляре службы DICOM добавлены следующие конечные точки API.

Добавление тегов расширенных запросов

Добавляет один или несколько расширенных тегов запроса и запускает долго выполняющуюся операцию, которая переиндексирует текущие экземпляры DICOM с указанными тегами.

POST .../extendedquerytags

Заголовок запроса

Текст запроса

Ограничения

Поддерживаются следующие типы виртуальной реальности:

Ответы

Вывод списка тегов расширенных запросов

Списки всех расширенных тегов запросов.

GET .../extendedquerytags

Ответы

Получение тега расширенного запроса

Получение тега расширенного запроса.

GET .../extendedquerytags/{tagPath}

Параметры универсального кода ресурса (URI)

Ответы

Удаление тега расширенного запроса

Удаление тега расширенного запроса.

DELETE .../extendedquerytags/{tagPath}

Параметры универсального кода ресурса (URI)

Ответы

Обновление тега расширенного запроса

Обновление тега расширенного запроса.

PATCH .../extendedquerytags/{tagPath}

Параметры универсального кода ресурса (URI)

Заголовок запроса

Текст запроса

Ответы

Вывод списка ошибок тега расширенного запроса

Выводит список ошибок в расширенном теге запроса.

GET .../extendedquerytags/{tagPath}/errors

Параметры универсального кода ресурса (URI)

Ответы

Операция получения

Получение длительной операции.

GET .../operations/{operationId}

Параметры универсального кода ресурса (URI)

Ответы

QIDO с расширенными тегами запросов

Состояние тега

Тег "Состояние расширенного запроса" указывает текущее состояние. При первом добавлении тега расширенного запроса для его состояния устанавливается значение Adding, и запускается длительная операция для повторной индексации существующих экземпляров DICOM. После завершения операции состояние тега обновляется на Ready. Теперь в QIDO можно использовать тег расширенного запроса.

Например, если добавляется тег Manufacturer Model Name (0008,1090) и находится в Ready состоянии , в дальнейшем следующие запросы можно использовать для фильтрации хранимых экземпляров по имени модели производителя.

../instances?ManufacturerModelName=Microsoft

Их также можно использовать с существующими тегами. Пример:

../instances?00081090=Microsoft&PatientName=Jo&fuzzyMatching=true

Состояние запроса тега

QueryStatus указывает, разрешено ли QIDO для тега. Если операции повторной индексации не удается обработать один или несколько экземпляров DICOM для тега, параметру QueryStatus этого тега присваивается Disabled значение автоматически. Вы можете игнорировать ошибки индексирования и разрешить запросам использовать этот тег, задав для значение QueryStatus с Enabled помощью API обновления расширенного тега запроса . Все запросы QIDO, ссылающиеся по крайней мере на один тег, включенный вручную, будут содержать набор тегов с ошибками индексирования в заголовке erroneous-dicom-attributesответа .

Например, предположим, что в теге PatientAge расширенного запроса произошли ошибки во время повторного индексирования, но он был включен вручную. Для следующего запроса вы увидите PatientAge в заголовке erroneous-dicom-attributes .

../instances?PatientAge=035Y

Определения

Тег расширенного запроса

Тег DICOM, который будет поддерживаться для QIDO-RS.

Пример кода 1 — это стандартный тег (0008 0070) в Ready состоянии.

{
    "status": "Ready",
    "level": "Instance",
    "queryStatus": "Enabled",
    "path": "00080070",
    "vr": "LO"
}

Пример кода 2 — это стандартный тег (0010 1010) в Adding состоянии. На нем выполняется операция с идентификатором 1a5d0306d9624f699929ee1a59ed57a0 , и на данный момент произошла 21 ошибка.

{
    "status": "Adding",
    "level": "Study",
    "errors": {
        "count": 21,
        "href": "https://localhost:63838/extendedquerytags/00101010/errors"
    },
    "operation": {
        "id": "1a5d0306d9624f699929ee1a59ed57a0",
        "href": "https://localhost:63838/operations/1a5d0306d9624f699929ee1a59ed57a0"
    },
    "queryStatus": "Disabled",
    "path": "00101010",
    "vr": "AS"
}

Справочник по операции

Ссылка на долго выполняющуюся операцию.

Операция

Представляет длительную операцию.

В следующем примере кода выполняется операция переиндексации.

{
    "resources": [
        "https://localhost:63838/extendedquerytags/00101010"
    ],
    "operationId": "a99a8b51-78d4-4fd9-b004-b6c0bcaccf1d",
    "type": "Reindex",
    "createdTime": "2021-10-06T16:40:02.5247083Z",
    "lastUpdatedTime": "2021-10-06T16:40:04.5152934Z",
    "status": "Running",
    "percentComplete": 10
}

Состояние операции

Представляет состояние длительной операции во время выполнения.

Ошибка тега расширенного запроса

Ошибка, которая произошла во время расширенной операции индексирования тегов запроса.

В следующем примере кода содержится непредвиденная ошибка длины значения в экземпляре DICOM. Это произошло в 2021-10-06T16:41:44.4783136.

{
    "studyInstanceUid": "2.25.253658084841524753870559471415339023884",
    "seriesInstanceUid": "2.25.309809095970466602239093351963447277833",
    "sopInstanceUid": "2.25.225286918605419873651833906117051809629",
    "createdTime": "2021-10-06T16:41:44.4783136",
    "errorMessage": "Value length is not expected."
}

Справочник по ошибкам расширенного тега запроса

Ссылка на ошибки расширенного тега запроса.

Operation type (Тип операции)

Тип длительной операции.

Состояние тега расширенного запроса

Состояние тега расширенного запроса.

Расширенный уровень тега запроса

Уровень иерархии сведений DICOM, на котором применяется этот тег.

Состояние запроса расширенного тега запроса

Состояние запроса расширенного тега запроса.

Расширенный тег запроса для обновления

Представляет расширенный тег запроса для обновления.

Расширенный тег запроса для добавления

Представляет расширенный тег запроса для добавления.

В примере кода 1MicrosoftPC определяется закрытый тег (0401,1001) с представлением SS значения на уровне экземпляра.

{
    "Path": "04011001",
    "VR": "SS",
    "PrivateCreator": "MicrosoftPC",
    "Level": "Instance"
}

В примере кода 2 используется стандартный тег с ключевое слово ManufacturerModelName с представлением LO значения, определенного на уровне рядов.

{
    "Path": "ManufacturerModelName",
    "VR": "LO",
    "Level": "Series"
}

В примере кода 3 используется стандартный тег (0010 0040) и он определяется в исследованиях. Представление значения уже определено стандартом DICOM.

{
    "Path": "00100040",
    "Level": "Study"
}

Итоги

В этой концептуальной статье представлен обзор функции расширенного тега запроса в службе DICOM.

Дальнейшие действия

Дополнительные сведения о развертывании службы DICOM см. в статье.