Sdílet prostřednictvím

Změny rozhraní API služby DICOM v2

  • Článek

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 níže.
  • 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číst

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=*

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 (tag) Název atributu
Studie (0008, 1030) StudyDescription
Řada (0008, 1090) ManufacturerModelName

Atributy odebrané z výchozích značek

Úroveň značky Značka (tag) Název atributu
Studie (0008, 0005) SpecificCharacterSet
Studie (0008, 0030) StudyTime
Studie (0008, 0056) Dostupnost instance
Studie (0008, 0201) TimezoneOffsetFromUTC
Studie (0010, 0040) PatientSex
Studie (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.