DICOM-service-API v2-wijzigingen
Deze naslaghandleiding bevat een overzicht van de wijzigingen in de V2-API van de DICOM-service®. Als u de volledige set mogelijkheden in v2 wilt zien, raadpleegt u de DICOM Conformance-instructie v2.
Overzicht van wijzigingen in v2
Opslaan
Lenient validatie van optionele kenmerken
In eerdere versies mislukt een Store-aanvraag als een van de vereiste of doorzoekbare kenmerken de validatie mislukt. Vanaf v2 mislukt de aanvraag alleen als de validatie van vereiste kenmerken mislukt.
Validatie van kenmerken die niet vereist zijn voor de API, resulteert in het bestand dat wordt opgeslagen met een waarschuwing in het antwoord. Waarschuwingen resulteren in een HTTP-retourcode van 202 Accepted en de nettolading van het antwoord bevat de WarningReason tag (0008, 1196).
Er wordt een waarschuwing gegeven over elk mislukt kenmerk per exemplaar. Wanneer een reeks een kenmerk bevat dat mislukt, of wanneer er meerdere problemen zijn met één kenmerk, wordt alleen de eerste reden van het mislukte kenmerk genoteerd.
Er zijn enkele belangrijke gedragingen voor optionele kenmerken die niet kunnen worden gevalideerd:
- Zoekt naar het kenmerk dat mislukte validatie retourneert de studie/reeks/instantie als de waarde op een van de onderstaande manieren wordt gecorrigeerd.
- De kenmerken worden niet geretourneerd bij het ophalen van metagegevens via WADO-eindpunten
/metadata.
Het ophalen van een studie/reeks/exemplaar retourneert altijd de oorspronkelijke binaire bestanden met de oorspronkelijke kenmerken, zelfs als de validatie van deze kenmerken is mislukt.
Als een kenmerk wordt opgevuld met null-waarden, wordt het kenmerk geïndexeerd wanneer het doorzoekbaar is en wordt opgeslagen als in dicom+json-metagegevens. Er is geen validatiewaarschuwing opgegeven.
Ophalen
Ondersteuning voor ophalen van één frame
Ophalen van één frame wordt ondersteund door de volgende Accept header toe te voegen:
application/octet-stream; transfer-syntax=*
Orders zoeken
Zoekresultaten zijn mogelijk onvolledig voor uitgebreide querytags met validatiewaarschuwingen
Als in de v1-API en v2, als een uitgebreide querytag fouten bevat, omdat een of meer van de bestaande exemplaren een tagwaarde hadden die niet kon worden geïndexeerd, worden volgende zoekquery's met de uitgebreide querytag geretourneerd erroneous-dicom-attributes zoals beschreven in de documentatie. Tags (ook wel kenmerken genoemd) met validatiewaarschuwingen van STOW-RS zijn echter niet opgenomen in deze header. Als een winkelaanvraag resulteert in validatiewaarschuwingen voor doorzoekbare kenmerken op het moment dat het exemplaar is opgeslagen, worden deze kenmerken mogelijk niet gebruikt om naar het opgeslagen exemplaar te zoeken. Doorzoekbare kenmerken die niet kunnen worden gevalideerd, kunnen echter resultaten retourneren als de waarden worden overschreven door instanties in dezelfde studie/reeks die zijn opgeslagen na de mislukte, of als de waarden al correct zijn opgeslagen door een eerder exemplaar. Als de kenmerkwaarden niet worden overschreven, worden er geen zoekresultaten geproduceerd.
Een kenmerk kan op de volgende manieren worden gecorrigeerd:
- Het opgeslagen exemplaar verwijderen en een nieuw exemplaar uploaden met de gecorrigeerde gegevens
- Een nieuw exemplaar uploaden in dezelfde studie/reeks met gecorrigeerde gegevens
Minder studie-, reeks- en instantiekenmerken worden standaard geretourneerd
De set kenmerken die standaard worden geretourneerd, is verminderd om de prestaties te verbeteren. Zie de gedetailleerde lijst in de documentatie voor zoekantwoorden .
Kenmerken die nieuw zijn toegevoegd aan standaardtags.
| Tagniveau | Tag | Kenmerknaam |
|---|---|---|
| Studie | (0008, 1030) | StudyDescription |
| Reeks | (0008, 1090) | ManufacturerModelName |
Kenmerken die zijn verwijderd uit standaardtags.
| Tagniveau | Tag | Kenmerknaam |
|---|---|---|
| Studie | (0008, 0005) | SpecificCharacterSet |
| Studie | (0008, 0030) | StudyTime |
| Studie | (0008, 0056) | InstanceAvailability |
| Studie | (0008, 0201) | TijdzoneOffsetFromUTC |
| Studie | (0010, 0040) | PatientSex |
| Studie | (0020, 0010) | StudyID |
| Reeks | (0008, 0005) | SpecificCharacterSet |
| Reeks | (0008, 0201) | TijdzoneOffsetFromUTC |
| Reeks | (0008, 103E) | SeriesDescription |
| Reeks | (0040, 0245) | PerformedProcedureStepStartTime |
| Reeks | (0040, 0275) | RequestAttributesSequence |
| Exemplaar | (0008, 0005) | SpecificCharacterSet |
| Exemplaar | (0008, 0016) | SOPClassUID |
| Exemplaar | (0008, 0056) | InstanceAvailability |
| Exemplaar | (0008, 0201) | TijdzoneOffsetFromUTC |
| Exemplaar | (0020, 0013) | InstanceNumber |
| Exemplaar | (0028, 0010) | Rijen |
| Exemplaar | (0028, 0011) | Kolommen |
| Exemplaar | (0028, 0100) | BitsAllocated |
| Exemplaar | (0028, 0008) | NumberOfFrames |
Alle verwijderde tags maken deel uit van extra tags die worden geretourneerd wanneer er query's worden uitgevoerd.includefield = all
Null-opgevulde kenmerken kunnen worden gezocht met of zonder opvulling
Wanneer een kenmerk is opgeslagen met behulp van null-opvulling, kan het worden gezocht met of zonder de null-opvulling in URI-codering. Resultaten die worden opgehaald, zijn voor kenmerken die zowel met als zonder null-opvulling zijn opgeslagen.
Operations
De naam van de completed status is gewijzigd in succeeded
Als u wilt in overeenstemming zijn met de REST API-richtlijnen van Microsoft, is de naam van de completed status gewijzigd in succeeded.
Feed wijzigen
Wijzigingenfeed accepteert nu een tijdsbereik
De WIJZIGINGENfeed-API accepteert nu optioneel startTime en endTime parameters om de resultaten te bepalen. Wijzigingen binnen een tijdsbereik kunnen nog steeds worden gepagineerd met behulp van de bestaande offset parameters.limit De offset is relatief ten opzichte van het tijdvenster dat is gedefinieerd door startTime en endTime. De vijfde invoer van de wijzigingenfeed vanaf 24-7-2023 om 09:00 uur UTC gebruikt bijvoorbeeld de querytekenreeks ?startTime=2023-07-24T09:00:00Z&offset=5.
Voor v2 is het raadzaam altijd een tijdsbereik op te nemen om de prestaties te verbeteren.
Notitie
DICOM® is het gedeponeerde handelsmerk van de National Electrical Manufacturers Association voor haar standaardenpublicaties met betrekking tot digitale communicatie van medische informatie.