Ändringar i DICOM-tjänstens API v2
Den här referensguiden ger dig en sammanfattning av ändringarna i V2-API:et för DICOM-tjänsten®. Om du vill se den fullständiga uppsättningen funktioner i v2 läser du DICOM Conformance Statement v2.
Sammanfattning av ändringar i v2
Store
Överseende validering av valfria attribut
I tidigare versioner misslyckas en Store-begäran om något av de obligatoriska eller sökbara attributen misslyckas med valideringen. Från och med v2 misslyckas begäran endast om nödvändiga attribut misslyckas med valideringen.
Misslyckad validering av attribut som inte krävs av API:et resulterar i att filen lagras med en varning i svaret. Varningar resulterar i en HTTP-returkod för 202 Accepted och svarsnyttolasten innehåller taggen WarningReason (0008, 1196).
En varning ges om varje felattribut per instans. När en sekvens innehåller ett attribut som inte kan valideras, eller om det finns flera problem med ett enda attribut, noteras endast den första orsaken till att attributet misslyckas.
Det finns några viktiga beteenden för valfria attribut som inte kan valideras:
- Söker efter attributet som misslyckades valideringen returnerar studien/serien/instansen om värdet korrigeras på något av de få sätt som anges här.
- Attributen returneras inte när metadata hämtas via WADO-slutpunkter
/metadata.
Om du hämtar en studie/serie/instans returneras alltid de ursprungliga binära filerna med de ursprungliga attributen, även om dessa attribut misslyckades med valideringen.
Om ett attribut är fyllt med null-värden indexeras attributet när det är sökbart och lagras som i dicom+json-metadata. Ingen verifieringsvarning har angetts.
Hämta
Stöd för hämtning av en bildruta
Hämtning av en bildruta stöds genom att följande rubrik läggs till Accept :
application/octet-stream; transfer-syntax=*
Sök
Sökresultaten kan vara ofullständiga för utökade frågetaggar med valideringsvarningar
I v1-API:et och fortsatte för v2, om en utökad frågetagg har några fel, eftersom en eller flera av de befintliga instanserna hade ett taggvärde som inte kunde indexeras, returnerar efterföljande sökfrågor som innehåller den utökade frågetaggen enligt erroneous-dicom-attributes beskrivningen i dokumentationen. Taggar (även kallade attribut) med valideringsvarningar från STOW-RS ingår dock inte i den här rubriken. Om en lagringsbegäran resulterar i valideringsvarningar för sökbara attribut när instansen lagrades, kanske dessa attribut inte används för att söka efter den lagrade instansen. Alla sökbara attribut som misslyckades med valideringen kan dock returnera resultat om värdena skrivs över av instanser i samma studie/serie som lagras efter den misslyckade, eller om värdena redan lagras korrekt av en tidigare instans. Om attributvärdena inte skrivs över kommer de inte att generera några sökresultat.
Ett attribut kan korrigeras på följande sätt:
- Ta bort den lagrade instansen och ladda upp en ny instans med rättade data
- Ladda upp en ny instans i samma studie/serie med korrigerade data
Färre study-, series- och instansattribut returneras som standard
Den uppsättning attribut som returneras som standard har reducerats för att förbättra prestandan. Se den detaljerade listan i dokumentationen för söksvar .
Attribut som nyligen har lagts till i standardtaggar.
| Taggnivå | Tagg | Attributnamn |
|---|---|---|
| Studera | (0008, 1030) | StudyDescription |
| Serie | (0008, 1090) | ManufacturerModelName |
Attribut som tagits bort från standardtaggar.
| Taggnivå | Tagg | Attributnamn |
|---|---|---|
| Studera | (0008, 0005) | SpecificCharacterSet |
| Studera | (0008, 0030) | StudyTime |
| Studera | (0008, 0056) | InstanceAvailability |
| Studera | (0008, 0201) | TimezoneOffsetFromUTC |
| Studera | (0010, 0040) | PatientSex |
| Studera | (0020, 0010) | StudyID |
| Serie | (0008, 0005) | SpecificCharacterSet |
| Serie | (0008, 0201) | TimezoneOffsetFromUTC |
| Serie | (0008, 103E) | SeriesDescription |
| Serie | (0040, 0245) | PerformedProcedureStepStartTime |
| Serie | (0040, 0275) | RequestAttributesSequence |
| Instans | (0008, 0005) | SpecificCharacterSet |
| Instans | (0008, 0016) | SOPClassUID |
| Instans | (0008, 0056) | InstanceAvailability |
| Instans | (0008, 0201) | TimezoneOffsetFromUTC |
| Instans | (0020, 0013) | InstanceNumber |
| Instans | (0028, 0010) | Rader |
| Instans | (0028, 0011) | Kolumner |
| Instans | (0028, 0100) | BitsAllocated |
| Instans | (0028, 0008) | NumberOfFrames |
Alla borttagna taggar är en del av ytterligare taggar som returneras när du frågar med includefield = all.
Null-vadderade attribut kan sökas efter med eller utan utfyllnad
När ett attribut har lagrats med null-utfyllnad kan det sökas efter med eller utan null-utfyllnad i URI-kodning. Resultat som hämtas är för attribut som lagras både med och utan null-utfyllnad.
Operations
Statusen completed har bytt namn till succeeded
Statusen completed har bytt namn till succeededför att överensstämma med Microsofts REST API-riktlinjer.
Ändringsflöde
Ändringsflödet accepterar nu ett tidsintervall
API:et för ändringsflöde accepterar nu valfria startTime parametrar och endTime parametrar som hjälper dig att begränsa resultatet. Ändringar inom ett tidsintervall kan fortfarande sidnumreras med hjälp av befintliga offset parametrar och limit parametrar. Förskjutningen är relativ till det tidsfönster som definieras av startTime och endTime. Den femte ändringsflödesposten från och med 2023-07-24 kl. 09:00 UTC använder frågesträngen ?startTime=2023-07-24T09:00:00Z&offset=5.
För v2 rekommenderar vi att du alltid tar med ett tidsintervall för att förbättra prestandan.
Kommentar
DICOM® är ett registrerat varumärke som tillhör National Electrical Manufacturers Association för dess standarder publikationer som rör digital kommunikation av medicinsk information.