DICOM Hizmet API'si v2 Değişiklikleri
Bu başvuru kılavuzu, DICOM® hizmetinin V2 API'sindeki değişikliklerin özetini sağlar. v2'deki tüm özellikleri görmek için bkz . DICOM Uyumluluk Bildirimi v2.
v2'deki değişikliklerin özeti
Store
İsteğe bağlı özniteliklerin uzunluklu doğrulaması
Önceki sürümlerde, gerekli veya aranabilir özniteliklerden herhangi biri doğrulamada başarısız olursa Mağaza isteği başarısız olur. v2 sürümünden başlayarak, istek yalnızca gerekli özniteliklerin doğrulanamaması durumunda başarısız olur.
API tarafından gerekli olmayan özniteliklerin doğrulanamaması, dosyanın yanıtta bir uyarıyla depolanmasına neden olur. Uyarılar http dönüş koduyla 202 Accepted
sonuçlanır ve yanıt yükü etiketi ()0008, 1196
içerirWarningReason
.
Örnek başına her başarısız öznitelik hakkında bir uyarı verilir. Bir dizi doğrulamada başarısız olan bir öznitelik içerdiğinde veya tek bir öznitelikle ilgili birden çok sorun olduğunda, yalnızca ilk başarısız öznitelik nedeni not edilir.
Doğrulamada başarısız olan isteğe bağlı öznitelikler için bazı önemli davranışlar vardır:
- Doğrulama başarısız olan özniteliği arar, değer aşağıda belirtilen birkaç yoldan biriyle düzeltilirse etüt/seri/örneği döndürür.
- WADO
/metadata
uç noktaları aracılığıyla meta veriler alınırken öznitelikler döndürülmüyor.
Bir çalışma/seri/örnek alınırken, bu öznitelikler doğrulanamadıysa bile özgün özniteliklere sahip özgün ikili dosyaları her zaman döndürür.
Bir öznitelik null değerlerle doldurulursa, öznitelik aranabilir olduğunda dizine alınır ve dicom+json meta verilerinde olduğu gibi depolanır. Doğrulama uyarısı sağlanmadı.
Al
Tek çerçeve alma desteği
Aşağıdaki Accept
üst bilgi eklenerek tek çerçeveli alma desteklenir:
application/octet-stream; transfer-syntax=*
Arama yap
Doğrulama uyarılarıyla genişletilmiş sorgu etiketleri için arama sonuçları eksik olabilir
v1 API'sinde ve v2 için devam ettiyse, genişletilmiş sorgu etiketinde herhangi bir hata varsa, mevcut örneklerden biri veya daha fazlası dizine alınamayan bir etiket değerine sahipse, genişletilmiş sorgu etiketini içeren sonraki arama sorguları belgelerde ayrıntılı olarak gösterildiği gibi dönererroneous-dicom-attributes
. Ancak, STOW-RS'den doğrulama uyarılarına sahip etiketler (öznitelik olarak da bilinir) bu üst bilgide yer almaz . Bir depo isteği, örneğin depolandığı sırada aranabilir öznitelikler için doğrulama uyarılarıyla sonuçlanırsa, depolanan örneği aramak için bu öznitelikler kullanılamayabilir. Ancak, doğrulama başarısız olan aranabilir öznitelikler , başarısız olandan sonra depolanan aynı çalışma/serideki örnekler tarafından üzerine yazılırsa veya değerler önceki bir örnek tarafından zaten doğru depolanmışsa sonuçları döndürebilir. Öznitelik değerlerinin üzerine yazılmazsa, hiçbir arama sonucu üretmez.
Bir öznitelik aşağıdaki yollarla düzeltilebilir:
- Depolanan örneği silin ve düzeltilen verileri içeren yeni bir örneği karşıya yükleyin
- Düzeltilmiş verilerle aynı çalışma/seriye yeni bir örnek yükleme
Varsayılan olarak daha az Çalışma, Seri ve Örnek özniteliği döndürülür
Performansı artırmak için varsayılan olarak döndürülen öznitelik kümesi azaltıldı. Arama yanıtı belgelerindeki ayrıntılı listeye bakın.
Varsayılan etiketlere yeni eklenen öznitelikler.
Etiket düzeyi | Etiket | Öznitelik Adı |
---|---|---|
Çalışma | (0008, 1030) | StudyDescription |
Seriler | (0008, 1090) | ManufacturerModelName |
Öznitelikler varsayılan etiketlerden kaldırıldı.
Etiket düzeyi | Etiket | Öznitelik Adı |
---|---|---|
Çalışma | (0008, 0005) | SpecificCharacterSet |
Çalışma | (0008, 0030) | StudyTime |
Çalışma | (0008, 0056) | InstanceAvailability |
Çalışma | (0008, 0201) | TimezoneOffsetFromUTC |
Çalışma | (0010, 0040) | PatientSex |
Çalışma | (0020, 0010) | StudyID |
Seriler | (0008, 0005) | SpecificCharacterSet |
Seriler | (0008, 0201) | TimezoneOffsetFromUTC |
Seriler | (0008, 103E) | SeriesDescription |
Seriler | (0040, 0245) | PerformedProcedureStepStartTime |
Seriler | (0040, 0275) | RequestAttributesSequence |
Örnek | (0008, 0005) | SpecificCharacterSet |
Örnek | (0008, 0016) | SOPClassUID |
Örnek | (0008, 0056) | InstanceAvailability |
Örnek | (0008, 0201) | TimezoneOffsetFromUTC |
Örnek | (0020, 0013) | ÖrnekSayısı |
Örnek | (0028, 0010) | Satırlar |
Örnek | (0028, 0011) | Sütunlar |
Örnek | (0028, 0100) | BitsAllocated |
Örnek | (0028, 0008) | NumberOfFrames |
Kaldırılan tüm etiketler, ile includefield = all
sorgulandığında döndürülecek ek etiketlerin bir parçasıdır.
Boş doldurulmuş öznitelikler doldurma ile veya doldurma olmadan aranabilir
Bir öznitelik null doldurma kullanılarak depolandığında, uri kodlamasında null doldurma ile veya olmadan aranabilir. Alınan sonuçlar, hem ile hem de null doldurma olmadan depolanan özniteliklere yöneliktir.
Operations
Durum completed
olarak yeniden adlandırıldı succeeded
Microsoft'un REST API yönergeleriyle completed
uyumlu hale getirmek için durum olarak yeniden adlandırıldı.succeeded
Değişiklik Akışı
Değişiklik akışı artık bir zaman aralığını kabul ediyor
Değişiklik Akışı API'si artık sonuçların kapsamını belirlemeye yardımcı olmak için isteğe bağlı startTime
ve endTime
parametrelerini kabul eder. Bir zaman aralığındaki değişiklikler, var olan offset
ve limit
parametreleri kullanılarak sayfalandırmaya devam edebilir. Uzaklık, ve endTime
tarafından tanımlanan zaman penceresine startTime
göredir. Örneğin, 24/7/2023 saat 09:00 UTC'den itibaren beşinci değişiklik akışı girişi sorgu dizesini ?startTime=2023-07-24T09:00:00Z&offset=5
kullanır.
v2 için, performansı geliştirmek için her zaman bir zaman aralığı eklemeniz önerilir.
Dekont
DICOM® , Tıbbi bilgilerin dijital iletişimleri ile ilgili Standartları yayınları için Ulusal Elektrik Üreticileri Birliği'nin tescilli ticari markasıdır.