Cambios de DICOM Service API v2
Esta guía de referencia proporciona un resumen de los cambios en la API V2 del servicio DICOM®. Para ver el conjunto completo de funcionalidades en v2, consulte la instrucción de conformidad diCOM v2.
Resumen de los cambios en la versión 2
Tienda
Validación lenciente de atributos opcionales
En versiones anteriores, se produce un error en una solicitud de la Tienda si alguno de los atributos necesarios o que se pueden buscar produce un error en la validación. A partir de la versión 2, la solicitud solo produce un error si los atributos necesarios no se validan.
La validación errónea de los atributos no requeridos por la API provoca que el archivo se almacene con una advertencia en la respuesta. Las advertencias dan como resultado un código de retorno HTTP de 202 Accepted y la carga de respuesta contiene la WarningReason etiqueta (0008, 1196).
Se da una advertencia sobre cada atributo con errores por instancia. Cuando una secuencia contiene un atributo que produce un error en la validación o cuando hay varios problemas con un único atributo, solo se indica el primer motivo del atributo con errores.
Hay algunos comportamientos importantes para los atributos opcionales que producen un error en la validación:
- Busca el atributo que ha producido un error en la validación devuelve el estudio, la serie o la instancia si el valor se corrige de una de las pocas maneras mencionadas aquí.
- Los atributos no se devuelven al recuperar metadatos a través de puntos de conexión WADO
/metadata.
La recuperación de una serie o una instancia de estudio siempre devuelve los archivos binarios originales con los atributos originales, incluso si esos atributos no se pudieron validar.
Si un atributo se rellena con valores NULL, el atributo se indexa cuando se puede buscar y se almacena tal como está en los metadatos dicom+json. No se proporciona ninguna advertencia de validación.
Recuperar
Compatibilidad con la recuperación de fotogramas únicos
Se admite la recuperación de fotogramas únicos agregando el siguiente Accept encabezado:
application/octet-stream; transfer-syntax=*
Buscar
Los resultados de la búsqueda podrían estar incompletos para las etiquetas de consulta extendidas con advertencias de validación
En la API v1 y continuó para v2, si una etiqueta de consulta extendida tiene errores, ya que una o varias de las instancias existentes tenían un valor de etiqueta que no se podía indexar, las consultas de búsqueda posteriores que contienen la etiqueta de consulta extendida devuelven erroneous-dicom-attributes como se detalla en la documentación. Sin embargo, las etiquetas (también conocidas como atributos) con advertencias de validación de STOW-RS no se incluyen en este encabezado. Si una solicitud de almacén da como resultado advertencias de validación para atributos que se pueden buscar en el momento en que se almacenó la instancia, es posible que esos atributos no se usen para buscar la instancia almacenada. Sin embargo, los atributos que se pueden buscar que no se validen podrán devolver resultados si las instancias de la misma serie o estudio que se almacenan después del error o si los valores ya están almacenados correctamente por una instancia anterior. Si los valores de atributo no se sobrescriben, no generarán ningún resultado de búsqueda.
Un atributo se puede corregir de las maneras siguientes:
- Eliminar la instancia almacenada y cargar una nueva instancia con los datos corregidos
- Carga de una nueva instancia en el mismo estudio o serie con datos corregidos
De forma predeterminada, se devuelven menos atributos Study, Series e Instance.
El conjunto de atributos devueltos de forma predeterminada se ha reducido para mejorar el rendimiento. Consulte la lista detallada en la documentación de respuesta de búsqueda.
Atributos agregados recientemente a etiquetas predeterminadas.
| Nivel de etiqueta | Etiqueta | Nombre del atributo |
|---|---|---|
| Estudio | (0008, 1030) | StudyDescription |
| serie | (0008, 1090) | ManufacturerModelName |
Atributos quitados de las etiquetas predeterminadas.
| Nivel de etiqueta | Etiqueta | Nombre del atributo |
|---|---|---|
| Estudio | (0008, 0005) | SpecificCharacterSet |
| Estudio | (0008, 0030) | StudyTime |
| Estudio | (0008, 0056) | InstanceAvailability |
| Estudio | (0008, 0201) | TimezoneOffsetFromUTC |
| Estudio | (0010, 0040) | PatientSex |
| Estudio | (0020, 0010) | StudyID |
| serie | (0008, 0005) | SpecificCharacterSet |
| serie | (0008, 0201) | TimezoneOffsetFromUTC |
| serie | (0008, 103E) | SeriesDescription |
| serie | (0040, 0245) | PerformedProcedureStepStartTime |
| serie | (0040, 0275) | RequestAttributesSequence |
| Instancia | (0008, 0005) | SpecificCharacterSet |
| Instancia | (0008, 0016) | SOPClassUID |
| Instancia | (0008, 0056) | InstanceAvailability |
| Instancia | (0008, 0201) | TimezoneOffsetFromUTC |
| Instancia | (0020, 0013) | NúmeroInstancia |
| Instancia | (0028, 0010) | Filas |
| Instancia | (0028, 0011) | Columnas |
| Instancia | (0028, 0100) | BitsAllocated |
| Instancia | (0028, 0008) | NumberOfFrames |
Todas las etiquetas eliminadas forman parte de etiquetas adicionales que se devolverán cuando se consulte con includefield = all.
Se pueden buscar atributos acolchados null con o sin relleno
Cuando un atributo se almacenó mediante relleno nulo, se puede buscar con o sin el relleno nulo en codificación URI. Los resultados recuperados son para atributos almacenados con y sin relleno nulo.
Operations
Se ha cambiado el nombre del completed estado a succeeded
Para alinearse con las directrices de la API REST de Microsoft, se ha cambiado el nombre del completed estado a succeeded.
Fuente de cambios
La fuente de cambios ahora acepta un intervalo de tiempo
La API de fuente de cambios ahora acepta parámetros y endTime opcionales startTime para ayudar a definir el ámbito de los resultados. Los cambios dentro de un intervalo de tiempo todavía se pueden paginar mediante los parámetros y limit existentesoffset. El desplazamiento es relativo al período de tiempo definido por startTime y endTime. Por ejemplo, la quinta entrada de fuente de cambios a partir del 24/7/2023 a las 09:00 UTC usaría la cadena ?startTime=2023-07-24T09:00:00Z&offset=5de consulta .
Para la versión 2, se recomienda incluir siempre un intervalo de tiempo para mejorar el rendimiento.
Nota:
DICOM® es la marca registrada de la Asociación Nacional de Fabricantes Eléctricos para sus publicaciones de normas relacionadas con las comunicaciones digitales de información médica.