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
Armazenamento
Validação branda de atributos opcionais
Em versões anteriores, uma solicitação da Loja falhará se algum dos atributos necessá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 resulta no armazenamento do arquivo com um aviso na resposta. Os avisos resultam em um código de retorno HTTP de e a carga útil de 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, somente o primeiro motivo de falha do atributo é anotado.
Existem alguns comportamentos notáveis para atributos opcionais que falham na validação:
- Procura o atributo que falhou na validação retorna 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 nulls, o atributo será indexado quando pesquisável e será armazenado como está nos metadados dicom+json. Nenhum aviso de validação é fornecido.
Retrieve
Suporte para 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 v2, se uma tag de consulta estendida tiver algum erro, 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 contendo 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 neste 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, quaisquer 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 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 carregue uma nova instância com os dados corrigidos
- Carregar uma nova instância no mesmo estudo/série com dados corrigidos
Menos atributos Study, Series e Instance 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 à pesquisa.
Atributos adicionados recentemente às tags padrão.
| Nível da etiqueta | Etiqueta | Nome do Atributo |
|---|---|---|
| Estudo | (0008, 1030) | EstudoDescrição |
| Série | (0008, 1090) | FabricanteModelName |
Atributos removidos das tags padrão.
| Nível da etiqueta | Etiqueta | Nome do Atributo |
|---|---|---|
| Estudo | (0008, 0005) | SpecificCharacterSet |
| Estudo | (0008, 0030) | Tempo de Estudo |
| Estudo | (0008, 0056) | InstanceAvailability |
| Estudo | (0008, 0201) | Fuso horárioOffsetFromUTC |
| Estudo | (0010, 0040) | Sexo do Paciente |
| Estudo | (0020, 0010) | ID do Estudo |
| Série | (0008, 0005) | SpecificCharacterSet |
| Série | (0008, 0201) | Fuso horárioOffsetFromUTC |
| Série | (0008, 103E) | SérieDescrição |
| Série | (0040, 0245) | PerformedProcedureStepStartTime |
| Série | (0040, 0275) | RequestAttributesSequence |
| Instância | (0008, 0005) | SpecificCharacterSet |
| Instância | (0008, 0016) | SOPClassUID |
| Instância | (0008, 0056) | InstanceAvailability |
| Instância | (0008, 0201) | Fuso horárioOffsetFromUTC |
| Instância | (0020, 0013) | Número da instância |
| 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 acolchoados 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 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 com as diretrizes da API REST da Microsoft, o completed status foi renomeado para succeeded.
Feed de Alterações
Alterar feed agora aceita um intervalo de tempo
A API Change Feed agora aceita parâmetros opcionais startTime para endTime ajudar a definir o escopo dos resultados. As alterações dentro de um intervalo de tempo ainda podem ser paginadas usando os parâmetros e limit existentesoffset. O deslocamento é relativo à janela de tempo definida por startTime e endTime. Por exemplo, a quinta entrada de feed de alteração a partir de 24/07/2023 às 09:00 UTC usaria a cadeia de caracteres de ?startTime=2023-07-24T09:00:00Z&offset=5consulta .
Para a v2, recomenda-se sempre incluir um intervalo de tempo para melhorar o desempenho.
Nota
DICOM® é a marca registrada da National Electrical Manufacturers Association para suas publicações de padrões relacionados a comunicações digitais de informações médicas.