Modifications de l’API du service DICOM v2
Ce guide de référence vous fournit un résumé des modifications apportées à l’API V2 du service DICOM®. Pour afficher l’ensemble complet de fonctionnalités dans v2, consultez l’instruction de conformité DICOM v2.
Résumé des modifications dans v2
Magasin
Validation leniente des attributs facultatifs
Dans les versions précédentes, une requête Store échoue si l’un des attributs requis ou pouvant faire l’objet d’une recherche échoue à la validation. À compter de la version v2, la requête échoue uniquement si les attributs requis échouent à la validation.
Échec de la validation des attributs non requis par l’API entraîne le stockage du fichier avec un avertissement dans la réponse. Les avertissements entraînent un code de retour HTTP de et la charge utile de 202 Accepted réponse contient la WarningReason balise (0008, 1196).
Un avertissement est donné à chaque attribut défaillant par instance. Lorsqu’une séquence contient un attribut qui échoue à la validation ou lorsqu’il existe plusieurs problèmes avec un attribut unique, seule la première raison de l’attribut défaillant est notée.
Il existe des comportements notables pour les attributs facultatifs qui échouent à la validation :
- Recherche l’attribut qui a échoué la validation retourne l’étude/série/instance si la valeur est corrigée de l’une des différentes façons mentionnées ci-dessous.
- Les attributs ne sont pas retournés lors de la récupération des métadonnées via des points de terminaison WADO
/metadata.
La récupération d’une étude/série/instance retourne toujours les fichiers binaires d’origine avec les attributs d’origine, même si ces attributs ont échoué.
Si un attribut est rembourré avec des valeurs Null, l’attribut est indexé lorsqu’il peut faire l’objet d’une recherche et est stocké tel qu’il se trouve dans des métadonnées dicom+json. Aucun avertissement de validation n’est fourni.
Récupération
Prise en charge de la récupération d’images unique
La récupération d’images unique est prise en charge en ajoutant l’en-tête suivant Accept :
application/octet-stream; transfer-syntax=*
Recherche
Les résultats de la recherche peuvent être incomplets pour les balises de requête étendues avec des avertissements de validation
Dans l’API v1 et poursuivie pour v2, si une balise de requête étendue a des erreurs, car une ou plusieurs des instances existantes avaient une valeur d’étiquette qui n’a pas pu être indexée, les requêtes de recherche suivantes contenant la balise de requête étendue retournent erroneous-dicom-attributes comme indiqué dans la documentation. Toutefois, les balises (également appelées attributs) avec des avertissements de validation de STOW-RS ne sont pas incluses dans cet en-tête. Si une demande de magasin génère des avertissements de validation pour les attributs pouvant faire l’objet d’une recherche au moment où l’instance a été stockée, ces attributs peuvent ne pas être utilisés pour rechercher l’instance stockée. Toutefois, tous les attributs pouvant faire l’objet d’une recherche ayant échoué seront en mesure de retourner des résultats si les valeurs sont remplacées par des instances dans la même étude/série stockée après l’échec, ou si les valeurs sont déjà stockées correctement par une instance précédente. Si les valeurs d’attribut ne sont pas remplacées, elles ne produisent aucun résultat de recherche.
Un attribut peut être corrigé de la manière suivante :
- Supprimer l’instance stockée et charger une nouvelle instance avec les données corrigées
- Charger une nouvelle instance dans la même étude/série avec des données corrigées
Moins d’attributs Study, Series et Instance sont retournés par défaut
L’ensemble d’attributs retournés par défaut a été réduit pour améliorer les performances. Consultez la liste détaillée dans la documentation de la réponse de recherche.
Attributs ajoutés récemment aux balises par défaut.
| Niveau de balise | Tag | Nom de l’attribut |
|---|---|---|
| Étude | (0008, 1030) | StudyDescription |
| Série | (0008, 1090) | ManufacturerModelName |
Attributs supprimés des balises par défaut.
| Niveau de balise | Tag | Nom de l’attribut |
|---|---|---|
| Étude | (0008, 0005) | SpecificCharacterSet |
| Étude | (0008, 0030) | StudyTime |
| Étude | (0008, 0056) | InstanceAvailability |
| Étude | (0008, 0201) | TimezoneOffsetFromUTC |
| Étude | (0010, 0040) | PatientSex |
| Étude | (0020, 0010) | StudyID |
| Série | (0008, 0005) | SpecificCharacterSet |
| Série | (0008, 0201) | TimezoneOffsetFromUTC |
| Série | (0008, 103E) | SeriesDescription |
| Série | (0040, 0245) | PerformProcedureStepStartTime |
| Série | (0040, 0275) | RequestAttributesSequence |
| Instance | (0008, 0005) | SpecificCharacterSet |
| Instance | (0008, 0016) | SOPClassUID |
| Instance | (0008, 0056) | InstanceAvailability |
| Instance | (0008, 0201) | TimezoneOffsetFromUTC |
| Instance | (0020, 0013) | NuméroInstance |
| Instance | (0028, 0010) | Lignes |
| Instance | (0028, 0011) | Colonnes |
| Instance | (0028, 0100) | BitsAllocated |
| Instance | (0028, 0008) | NumberOfFrames |
Toutes les balises supprimées font partie des balises supplémentaires qui seront retournées lors de la requête includefield = all.
Les attributs rembourrés Null peuvent être recherchés avec ou sans remplissage
Lorsqu’un attribut a été stocké à l’aide du remplissage null, il peut être recherché avec ou sans remplissage null dans l’encodage d’URI. Les résultats récupérés sont destinés aux attributs stockés avec et sans remplissage null.
Opérations
L’état completed a été renommé en succeeded
Pour s’aligner sur les instructions de l’API REST de Microsoft, l’état completed a été renommé succeededen .
Modifier le flux
Le flux de modification accepte désormais un intervalle de temps
L’API Flux de modification accepte désormais les paramètres facultatifs startTime et endTime les paramètres pour vous aider à étendre les résultats. Les modifications dans un intervalle de temps peuvent toujours être paginés à l’aide des paramètres et limit existantsoffset. Le décalage est relatif à la fenêtre de temps définie par startTime et endTime. Par exemple, la cinquième entrée de flux de modification à partir du 24/7/2023 à 09 :00 UTC utilise la chaîne ?startTime=2023-07-24T09:00:00Z&offset=5de requête.
Pour v2, il est recommandé d’inclure toujours un intervalle de temps pour améliorer les performances.
Remarque
DICOM® est une marque déposée de la National Electrical Manufacturers Association pour ses publications de standards relatifs aux communications numériques des informations médicales.