Etiquetas de consulta expandidas

Descrição Geral

Por predefinição, o serviço DICOM suporta a consulta nas etiquetas DICOM especificadas na instrução de conformidade. Ao ativar etiquetas de consulta expandidas, a lista de etiquetas pode ser facilmente expandida com base nas necessidades da aplicação.

Com as APIs listadas abaixo, os utilizadores podem indexar os respetivos estudos, séries e instâncias DICOM em etiquetas DICOM padrão e privadas, de modo a poderem ser especificadas em consultas QIDO-RS.

APIs

Versão: v1

Para ajudar a gerir as etiquetas suportadas numa determinada instância do serviço DICOM, foram adicionados os seguintes pontos finais da API.

Adicionar etiquetas de consulta expandidas

Adiciona uma ou mais etiquetas de consulta expandidas e inicia uma operação de execução prolongada que reindexa as instâncias DICOM atuais com as etiquetas especificadas.

POST .../extendedquerytags

Cabeçalho do pedido

Corpo do pedido

Limitações

São suportados os seguintes tipos de VR:

Respostas

Listar etiquetas de consulta expandidas

Listas de todas as etiquetas de consulta expandidas.

GET .../extendedquerytags

Respostas

Obter etiqueta de consulta expandida

Obtenha uma etiqueta de consulta expandida.

GET .../extendedquerytags/{tagPath}

Parâmetros URI

Respostas

Eliminar etiqueta de consulta expandida

Elimine uma etiqueta de consulta expandida.

DELETE .../extendedquerytags/{tagPath}

Parâmetros URI

Respostas

Atualizar etiqueta de consulta expandida

Atualize uma etiqueta de consulta expandida.

PATCH .../extendedquerytags/{tagPath}

Parâmetros URI

Cabeçalho do pedido

Corpo do pedido

Respostas

Listar erros de etiquetas de consulta expandida

Apresenta uma lista de erros numa etiqueta de consulta expandida.

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

Parâmetros do URI

Respostas

Obter operação

Obtenha uma operação de execução prolongada.

GET .../operations/{operationId}

Parâmetros do URI

Respostas

QIDO com etiquetas de consulta expandidas

Estado da etiqueta

O Estado da etiqueta de consulta expandida indica o estado atual. Quando uma etiqueta de consulta expandida é adicionada pela primeira vez, o respetivo estado é definido como Addinge é iniciada uma operação de execução prolongada para reindexar instâncias DICOM existentes. Após a conclusão da operação, o estado da etiqueta é atualizado para Ready. A etiqueta de consulta expandida pode agora ser utilizada no QIDO.

Por exemplo, se a etiqueta Nome do Modelo do Fabricante (0008,1090) for adicionada e, posteriormente Ready , as seguintes consultas puderem ser utilizadas para filtrar instâncias armazenadas pelo Nome do Modelo do Fabricante.

../instances?ManufacturerModelName=Microsoft

Também podem ser utilizadas com etiquetas existentes. Por exemplo:

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

Estado da consulta de etiquetas

QueryStatus indica se qIDO é permitido para a etiqueta. Quando uma operação de reindexação não processa uma ou mais instâncias DICOM para uma etiqueta, o QueryStatus dessa etiqueta é definido como Disabled automaticamente. Pode optar por ignorar os erros de indexação e permitir que as consultas utilizem esta etiqueta ao definir como através da QueryStatusEnabled API Atualizar Etiqueta de Consulta Expandida . Quaisquer pedidos QIDO que referenciem pelo menos uma etiqueta ativada manualmente incluirão o conjunto de etiquetas com erros de indexação no cabeçalho erroneous-dicom-attributesde resposta .

Por exemplo, suponha que a etiqueta PatientAge de consulta expandida teve erros durante a reindexação, mas que foi ativada manualmente. Para a consulta seguinte, poderá ver PatientAge no erroneous-dicom-attributes cabeçalho.

../instances?PatientAge=035Y

Definições

Etiqueta de consulta expandida

Uma etiqueta DICOM que será suportada para QIDO-RS.

O exemplo de código 1 é uma etiqueta padrão (0008 0070) no Ready estado.

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

O exemplo de código 2 é uma etiqueta padrão (0010,1010) no Adding estado. Uma operação com o ID 1a5d0306d9624f699929ee1a59ed57a0 está em execução e ocorreram 21 erros até ao momento.

{
    "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"
}

Referência da operação

Referência a uma operação de execução prolongada.

Operação

Representa uma operação de execução prolongada.

O exemplo de código seguinte é uma operação de reindexação em execução.

{
    "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
}

Estado da operação

Representa um estado de tempo de execução da operação de execução prolongada.

Erro de etiqueta de consulta expandida

Erro que ocorreu durante uma operação de indexação de etiquetas de consulta expandida.

O seguinte exemplo de código contém um erro de comprimento de valor inesperado numa instância DICOM. Ocorreu em 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."
}

Referência de erros de etiquetas de consulta expandida

Referência a erros de etiquetas de consulta expandidas.

Tipo de operação

O tipo de operação de execução prolongada.

Estado da etiqueta de consulta expandida

O estado da etiqueta de consulta expandida.

Nível de etiqueta de consulta expandida

O nível da hierarquia de informações DICOM em que esta etiqueta se aplica.

Estado da consulta da etiqueta de consulta expandida

O estado da consulta da etiqueta de consulta expandida.

Etiqueta de consulta expandida para atualização

Representa uma etiqueta de consulta expandida para atualização.

Etiqueta de consulta expandida para adicionar

Representa uma etiqueta de consulta expandida para adicionar.

O exemplo de código 1MicrosoftPC é definir a etiqueta privada (0401.1001) com a representação de SS valor ao nível da instância.

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

O exemplo de código 2 utiliza a etiqueta padrão com a palavra-chave ManufacturerModelName com a LO representação de valor definida ao nível da série.

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

O exemplo de código 3 utiliza a etiqueta padrão (0010 0040) e é definido em estudos. A representação de valor já está definida pela norma DICOM.

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

Resumo

Este artigo conceptual forneceu-lhe uma descrição geral da funcionalidade Etiqueta de Consulta Expandida no serviço DICOM.

Passos seguintes

Para obter mais informações sobre como implementar o serviço DICOM, consulte