Alterações na API de serviço DICOM v2
Este guia de referência fornece um resumo das alterações na API V2 do serviço DICOM®. Para ver o conjunto completo de recursos na v2, consulte a Declaração de Conformidade DICOM v2.
Resumo das alterações na v2
Store
Validação branda de atributos opcionais
Nas versões anteriores, uma solicitação da Store falhará se qualquer um dos atributos obrigatórios ou pesquisáveis falhar na validação. A partir da v2, a solicitação falhará somente se os atributos necessários falharem na validação.
A validação com falha de atributos não exigidos pela API faz com que o arquivo seja armazenado com um aviso na resposta. Os avisos resultam em um código de retorno HTTP e a carga útil da 202 Accepted resposta contém a WarningReason tag (0008, 1196).
Um aviso é dado sobre cada atributo com falha por instância. Quando uma sequência contém um atributo que falha na validação ou quando há vários problemas com um único atributo, apenas o primeiro motivo do atributo com falha é anotado.
Há alguns comportamentos notáveis para atributos opcionais que falham na validação:
- As pesquisas pelo atributo que falhou na validação retornam o estudo/série/instância se o valor for corrigido de uma das poucas maneiras mencionadas aqui.
- Os atributos não são retornados ao recuperar metadados por meio de pontos de extremidade WADO
/metadata.
A recuperação de um estudo/série/instância sempre retorna os arquivos binários originais com os atributos originais, mesmo que esses atributos tenham falhado na validação.
Se um atributo for preenchido com nulos, o atributo será indexado quando pesquisável e armazenado como está nos metadados dicom+json. Nenhum aviso de validação é fornecido.
Recuperar
Suporte à recuperação de quadro único
A recuperação de quadro único é suportada adicionando o seguinte Accept cabeçalho:
application/octet-stream; transfer-syntax=*
Pesquisar
Os resultados da pesquisa podem estar incompletos para tags de consulta estendidas com avisos de validação
Na API v1 e continuada para a v2, se uma tag de consulta estendida tiver erros, porque uma ou mais das instâncias existentes tinham um valor de tag que não pôde ser indexado, as consultas de pesquisa subsequentes que contêm a tag de consulta estendida retornarão erroneous-dicom-attributes conforme detalhado na documentação. No entanto, as tags (também conhecidas como atributos) com avisos de validação do STOW-RS não são incluídas nesse cabeçalho. Se uma solicitação de armazenamento resultar em avisos de validação para atributos pesquisáveis no momento em que a instância foi armazenada, esses atributos não poderão ser usados para pesquisar a instância armazenada. No entanto, todos os atributos pesquisáveis que falharam na validação poderão retornar resultados se os valores forem substituídos por instâncias no mesmo estudo/série que são armazenadas após a falha ou se os valores já estiverem armazenados corretamente por uma instância anterior. Se os valores de atributo não forem substituídos, eles não produzirão nenhum resultado de pesquisa.
Um atributo pode ser corrigido das seguintes maneiras:
- Exclua a instância armazenada e faça upload de uma nova instância com os dados corrigidos
- Carregar uma nova instância no mesmo estudo/série com dados corrigidos
Menos atributos de estudo, série e instância são retornados por padrão
O conjunto de atributos retornados por padrão foi reduzido para melhorar o desempenho. Consulte a lista detalhada na documentação de resposta de pesquisa.
Atributos adicionados recentemente às tags padrão.
| Nível de tag | Marca | Nome do atributo |
|---|---|---|
| Estudar | (0008, 1030) | Descrição do estudo |
| Série | (0008, 1090) | Nome_do_FabricanteModelo |
Atributos removidos das tags padrão.
| Nível de tag | Marca | Nome do atributo |
|---|---|---|
| Estudar | (0008, 0005) | Conjunto de caracteres específicos |
| Estudar | (0008, 0030) | Tempo de estudo |
| Estudar | (0008, 0056) | InstanceAvailability |
| Estudar | (0008, 0201) | TimezoneOffsetFromUTC |
| Estudar | (0010, 0040) | Sexo do paciente |
| Estudar | (0020, 0010) | ID do estudo |
| Série | (0008, 0005) | Conjunto de caracteres específicos |
| Série | (0008, 0201) | TimezoneOffsetFromUTC |
| Série | (0008, 103E) | Descrição da série |
| Série | (0040, 0245) | PerformedProcedureStepStartTime |
| Série | (0040, 0275) | Sequência de Atributos de Solicitação |
| Instância | (0008, 0005) | Conjunto de caracteres específicos |
| Instância | (0008, 0016) | SOPClassUID |
| Instância | (0008, 0056) | InstanceAvailability |
| Instância | (0008, 0201) | TimezoneOffsetFromUTC |
| Instância | (0020, 0013) | InstanceNumber |
| Instância | (0028, 0010) | Linhas |
| Instância | (0028, 0011) | Colunas |
| Instância | (0028, 0100) | BitsAlocados |
| Instância | (0028, 0008) | NumberOfFrames |
Todas as tags removidas fazem parte de tags adicionais que serão retornadas quando consultadas com includefield = all.
Atributos preenchidos nulos podem ser pesquisados com ou sem preenchimento
Quando um atributo foi armazenado usando preenchimento nulo, ele pode ser pesquisado com ou sem o preenchimento nulo na codificação de uri. Os resultados recuperados são para atributos armazenados com e sem preenchimento nulo.
Operações
O completed status foi renomeado para succeeded
Para se alinhar às diretrizes da API REST da Microsoft, o completed status foi renomeado para succeeded.
Feed de Alterações
O feed de alterações agora aceita um intervalo de tempo
A API do feed de alterações agora aceita parâmetros opcionais startTime e endTime para ajudar a definir o escopo dos resultados. As alterações dentro de um intervalo de tempo ainda podem ser paginadas usando os parâmetros and limit existentesoffset. O deslocamento é relativo à janela de tempo definida por startTime e endTime. Por exemplo, a quinta entrada do feed de alterações a partir de 24/07/2023 às 09:00 UTC usaria a string de consulta ?startTime=2023-07-24T09:00:00Z&offset=5.
Para a v2, é recomendável sempre incluir um intervalo de tempo para melhorar o desempenho.
Observação
DICOM® é a marca registrada da National Electrical Manufacturers Association para suas publicações de padrões relacionados às comunicações digitais de informações médicas.