Změny rozhraní API služby DICOM v2
Tato referenční příručka obsahuje souhrn změn v rozhraní API V2 služby DICOM®. Pokud chcete zobrazit úplnou sadu funkcí ve verzi 2, podívejte se na příkaz DICOM Conformance v2.
Shrnutí změn ve verzi 2
Uložit
Lenient validation of optional attributes
Pokud některý z požadovaných nebo prohledávatelných atributů selže v předchozích verzích, požadavek Store selže s ověřením. Od verze 2 požadavek selže pouze v případě, že požadované atributy selžou ověření.
Neúspěšné ověření atributů, které rozhraní API nevyžaduje, způsobí uložení souboru s upozorněním v odpovědi. Upozornění způsobí návratový kód 202 Accepted HTTP a datová část odpovědi obsahuje WarningReason značku (0008, 1196).
Každému atributu způsobujícím selhání na instanci se zobrazí upozornění. Pokud sekvence obsahuje atribut, který selže při ověřování nebo pokud existuje více problémů s jedním atributem, je zaznamenán pouze první důvod neúspěšného atributu.
U volitelných atributů, které selžou ověření, existuje několik velmi důležitého chování:
- Vyhledá atribut, který selhal při ověřování, vrátí studii, řadu nebo instanci, pokud je hodnota opravena jedním z několika způsobů uvedených zde.
- Atributy se nevrací při načítání metadat prostřednictvím koncových bodů WADO
/metadata.
Načtení studie, řady nebo instance vždy vrátí původní binární soubory s původními atributy, i když tyto atributy selhaly ověření.
Pokud je atribut vycpaný s hodnotou null, atribut se indexuje při hledání a uloží se tak, jak je v metadatech dicom+json. Není k dispozici žádné upozornění na ověření.
Načtení
Podpora načítání s jedním rámcem
Načtení jednoho rámce je podporováno přidáním následující Accept hlavičky:
application/octet-stream; transfer-syntax=*
Hledání
Výsledky hledání můžou být neúplné pro rozšířené značky dotazů s upozorněními ověřování.
Pokud má rozšířená značka dotazu v rozhraní API v1 a pokračovala pro v2, pokud má značka rozšířeného dotazu nějaké chyby, protože jedna nebo více existujících instancí měla hodnotu značky, která se nedala indexovat, vrátí následné vyhledávací dotazy obsahující rozšířenou značku erroneous-dicom-attributes dotazu, jak je podrobně popsáno v dokumentaci. Značky (označované také jako atributy) s upozorněními ověřování z FUNKCE STOW-RS však nejsou součástí této hlavičky. Pokud výsledkem požadavku úložiště jsou upozornění na ověření pro prohledávatelné atributy v době uložení instance, tyto atributy nemusí být použity k vyhledání uložené instance. Všechny prohledávatelné atributy, které selhaly ověřením, ale budou moct vrátit výsledky, pokud jsou hodnoty přepsány instancemi ve stejné studii nebo řadě, které jsou uloženy po neúspěšném ověření, nebo pokud jsou hodnoty již správně uloženy předchozí instancí. Pokud hodnoty atributů nejsou přepsány, nebudou vytvářet žádné výsledky hledání.
Atribut lze opravit následujícími způsoby:
- Odstraňte uloženou instanci a nahrajte novou instanci se opravenými daty.
- Nahrání nové instance ve stejné studii nebo řadě s opravenými daty
Ve výchozím nastavení se vrátí méně atributů Studie, Series a Instance.
Sada atributů vrácených ve výchozím nastavení byla snížena, aby se zlepšil výkon. Podívejte se na podrobný seznam v dokumentaci k odpovědi vyhledávání.
Atributy přidané nově do výchozích značek
| Úroveň značky | Značka | Název atributu |
|---|---|---|
| Studovat | (0008, 1030) | StudyDescription |
| Řada | (0008, 1090) | ManufacturerModelName |
Atributy odebrané z výchozích značek
| Úroveň značky | Značka | Název atributu |
|---|---|---|
| Studovat | (0008, 0005) | SpecificCharacterSet |
| Studovat | (0008, 0030) | StudyTime |
| Studovat | (0008, 0056) | Dostupnost instance |
| Studovat | (0008, 0201) | TimezoneOffsetFromUTC |
| Studovat | (0010, 0040) | PatientSex |
| Studovat | (0020, 0010) | ID studie |
| Řada | (0008, 0005) | SpecificCharacterSet |
| Řada | (0008, 0201) | TimezoneOffsetFromUTC |
| Řada | (0008, 103E) | Popis seriesDescription |
| Řada | (0040, 0245) | PerformedProcedureStepStartTime |
| Řada | (0040, 0275) | RequestAttributesSequence |
| Instance | (0008, 0005) | SpecificCharacterSet |
| Instance | (0008, 0016) | SOPClassUID |
| Instance | (0008, 0056) | Dostupnost instance |
| Instance | (0008, 0201) | TimezoneOffsetFromUTC |
| Instance | (0020, 0013) | InstanceNumber |
| Instance | (0028, 0010) | Řádky |
| Instance | (0028, 0011) | Sloupce |
| Instance | (0028, 0100) | BitsAllocated |
| Instance | (0028, 0008) | NumberOfFrames |
Všechny odebrané značky jsou součástí dalších značek, které se vrátí při dotazování na includefield = all.
Atributy s hodnotou Null lze vyhledat s odsazením nebo bez odsazení.
Když byl atribut uložen pomocí odsazení null, lze ho vyhledat s odsazením null nebo bez odsazení v kódování identifikátoru URI. Načtené výsledky jsou určené pro atributy uložené s odsazením null i bez odsazení null.
Operace
Stav completed byl přejmenován na succeeded
Kvůli sladění s pokyny rozhraní REST API Microsoftu completed se stav přejmenoval na succeeded.
Kanál změn
Kanál změn teď přijímá časový rozsah.
Rozhraní API kanálu změn teď přijímá volitelné startTime parametry, endTime které vám pomůžou určit rozsah výsledků. Změny v časovém rozsahu je možné stránkovat pomocí existujících offset a limit parametrů. Posun je relativní vzhledem k časovému intervalu definovanému operátorem startTime a endTime. Například pátá položka kanálu změn od 24. 7. 2023 v 09:00 UTC by použila řetězec ?startTime=2023-07-24T09:00:00Z&offset=5dotazu .
U verze 2 se doporučuje vždy zahrnout časový rozsah, aby se zlepšil výkon.
Poznámka:
DICOM® je registrovaná ochranná známka asociace National Electrical Manufacturers Association pro publikace standardů týkající se digitální komunikace s lékařskými informacemi.