DICOM Uyumluluk Bildirimi v1

DICOM® için Medical Imaging Server, DICOMweb Standard'ın bir alt kümesini destekler. Destek şunları içerir:

• Çalışmalar Hizmeti
  • Mağaza (STOW-RS)
  • Alma (WADO-RS)
  • Arama (QIDO-RS)
  • Delete
• İş Listesi Hizmeti (UPS Anında İletme ve Çekme SOP'leri)
  • Workitem Oluşturma
  • Workitem'i alma
  • Workitem'i güncelleştirme
  • Workitem Durumunu Değiştir
  • İptal İsteği
  • Workitems Arama

Ayrıca, aşağıdaki standart dışı API'ler desteklenir:

• Değişiklik Akışı
• Genişletilmiş Sorgu Etiketleri
• Toplu güncelleştirme
• Toplu içeri aktarma
• Dışarı aktarma

Hizmet REST API sürümü oluşturma kullanır. REST API'nin sürümü, aşağıdaki örnekte olduğu gibi temel URL'nin bir parçası olarak açıkça belirtilmelidir:

https://<service_url>/v<version>/studies

Uyumluluk bildiriminin bu sürümü REST API'lerinin sürümüne karşılık gelir v1 .

İstekte bulunurken sürümü belirtme hakkında bilgi için API Sürüm Oluşturma Belgeleri'ne bakın.

Desteklenen işlemler için örnek istekleri Postman koleksiyonunda bulabilirsiniz.

Önceden Temizlenmiş Temizleme

Hizmet, 128 baytlık Dosya ÖnAmble'ını yoksayar ve içeriğini null karakterlerle değiştirir. Bu davranış, hizmet aracılığıyla geçirilen hiçbir dosya kötü amaçlı önceden oluşturulmuş güvenlik açığına karşı savunmasız olmasını sağlar. Bununla birlikte, bu temizleme işlemi, TIFF gibi ikili biçimli içeriği kodlamak için kullanılan önamble'lerin hizmetle kullanılamayacağı anlamına da gelir.

Çalışmalar Hizmeti

Çalışmalar Hizmeti, kullanıcıların DICOM Çalışmaları, Serileri ve Örnekleri depolamasına, almasına ve aramasına olanak tanır. Tam kaynak yaşam döngüsünü etkinleştirmek için standart olmayan Delete işlemini ekledik.

Mağaza (STOW-RS)

Bu işlem, istek yükünde yer alan çalışmaların, serilerin ve örneklerin gösterimlerini depolamak için POST veya PUT yöntemini kullanır.

Metot	Yol	Açıklama
POST	.. /Çalışmaları	Örnekleri depolayın.
POST	.. /studies/{study}	Belirli bir çalışma için örnekleri depolayın.
PUT	.. /Çalışmaları	Upsert örnekleri.
PUT	.. /studies/{study}	Belirli bir çalışma için upsert örnekleri.

parametresi study DICOM özniteliğine StudyInstanceUIDkarşılık gelir. Belirtilirse, sağlanan çalışmaya ait olmayan tüm örnekler bir 43265 uyarı koduyla reddedilir.

Yanıt için aşağıdaki Accept üst bilgi desteklenir:

• application/dicom+json

Aşağıdaki Content-Type üst bilgiler desteklenir:

• multipart/related; type="application/dicom"
• application/dicom

Gerekli öznitelikleri depolama

Aşağıdaki DICOM öğelerinin depolanmaya çalışan her DICOM dosyasında mevcut olması gerekir:

• StudyInstanceUID
• SeriesInstanceUID
• SOPInstanceUID
• SOPClassUID
• PatientID

Depolanan her dosya, , SeriesInstanceUIDve SopInstanceUIDdosyalarının StudyInstanceUIDbenzersiz bir bileşimine sahip olmalıdır. Aynı tanımlayıcılara sahip bir dosya zaten varsa uyarı kodu 45070 döndürülür.

Yalnızca açık Değer Gösterimlerine sahip aktarım söz dizimleri kabul edilir.

Yanıt durum kodlarını depolama

Kod	Description
200 (OK)	İstekteki tüm SOP örnekleri depolanır.
202 (Accepted)	İstekteki bazı örnekler depolanır, ancak bazıları başarısız olur.
204 (No Content)	Depolama işlemi isteğinde içerik sağlanmadı.
400 (Bad Request)	İstek hatalı biçimlendirildi. Örneğin, sağlanan çalışma örneği tanımlayıcısı beklenen UID biçimine uygun değildi.
401 (Unauthorized)	İstemcinin kimliği doğrulanmamış.
403 (Forbidden)	Kullanıcı yetkilendirilmiyor.
406 (Not Acceptable)	Belirtilen Accept üst bilgi desteklenmiyor.
409 (Conflict)	Depolama işlemi isteğindeki örneklerin hiçbiri depolanmadı.
415 (Unsupported Media Type)	Sağlanan Content-Type desteklenmez.
503 (Service Unavailable)	Hizmet kullanılamıyor veya meşgul. Daha sonra tekrar deneyin.

Yanıt yükünü depolama

Yanıt yükü, dicom veri kümesini aşağıdaki öğelerle doldurur.

Etiket	Veri Akışı Adı	Açıklama
(0008, 1190)	RetrieveURL	Mağaza isteğinde sağlandıysa ve en az bir örnek başarıyla depolandıysa StudyInstanceUID , çalışmanın Alma URL'si
(0008, 1198)	FailedSOPSequence	Depolanamadı örneklerin dizisi
(0008, 1199)	ReferencedSOPSequence	Depolanan örneklerin sırası

içindeki FailedSOPSequence her veri kümesi aşağıdaki öğelere sahiptir (depolanmaya çalışan DICOM dosyası okunabiliyorsa).

Etiket	Veri Akışı Adı	Açıklama
(0008, 1150)	ReferencedSOPClassUID	Depolanamadı örneğin SOP sınıfı benzersiz tanımlayıcısı
(0008, 1155)	ReferencedSOPInstanceUID	Depolanamadı örneğin SOP örneği benzersiz tanımlayıcısı
(0008, 1197)	FailureReason	Bu örneğin depolanamadığına ilişkin neden kodu
(0074, 1048)	FailedAttributesSequence	Başarısız olan her özniteliğin nedenini içeren dizisi ErrorComment

içindeki ReferencedSOPSequence her veri kümesi aşağıdaki öğelere sahiptir.

Etiket	Veri Akışı Adı	Açıklama
(0008, 1150)	ReferencedSOPClassUID	Depolanamadı örneğin SOP sınıfı benzersiz tanımlayıcısı
(0008, 1155)	ReferencedSOPInstanceUID	Depolanamadı örneğin SOP örneği benzersiz tanımlayıcısı
(0008, 1190)	RetrieveURL	DICOM sunucusunda bu örneğin alma URL'si

Üst bilgi application/dicom+jsonile Accept örnek bir yanıt:

{
  "00081190":
  {
    "vr":"UR",
    "Value":["http://localhost/studies/d09e8215-e1e1-4c7a-8496-b4f6641ed232"]
  },
  "00081198":
  {
    "vr":"SQ",
    "Value":
    [{
      "00081150":
      {
        "vr":"UI","Value":["cd70f89a-05bc-4dab-b6b8-1f3d2fcafeec"]
      },
      "00081155":
      {
        "vr":"UI",
        "Value":["22c35d16-11ce-43fa-8f86-90ceed6cf4e7"]
      },
      "00081197":
      {
        "vr":"US",
        "Value":[43265]
      }
    }]
  },
  "00081199":
  {
    "vr":"SQ",
    "Value":
    [{
      "00081150":
      {
        "vr":"UI",
        "Value":["d246deb5-18c8-4336-a591-aeb6f8596664"]
      },
      "00081155":
      {
        "vr":"UI",
        "Value":["4a858cbb-a71f-4c01-b9b5-85f88b031365"]
      },
      "00081190":
      {
        "vr":"UR",
        "Value":["http://localhost/studies/d09e8215-e1e1-4c7a-8496-b4f6641ed232/series/8c4915f5-cc54-4e50-aa1f-9b06f6e58485/instances/4a858cbb-a71f-4c01-b9b5-85f88b031365"]
      }
    }]
  }
}

Depolama hatası neden kodları

Kod	Description
272	Depolama işlemi, işlemi işlerken oluşan genel bir hata nedeniyle örneği depolamadı.
43264	DICOM örneği doğrulamada başarısız oldu.
43265	Sağlanan örnek StudyInstanceUID , mağaza isteğinde belirtilen StudyInstanceUID örnekle eşleşmedi.
45070	Aynı StudyInstanceUID, SeriesInstanceUIDve içeren bir SopInstanceUID DICOM örneği zaten depolanmış. İçeriği güncelleştirmek istiyorsanız, önce bu örneği silin.
45071	DiCOM örneği başka bir işlem tarafından oluşturuluyor veya önceki oluşturma girişimi başarısız oldu ve temizleme işlemi tamamlanmadı. Yeniden oluşturmayı denemeden önce örneği silin.

Mağaza uyarı neden kodları

Kod	Description
45063	DICOM örneği Veri Kümesi SOP Sınıfıyla eşleşmiyor. Etüt Deposu İşlemi (Bölüm 10.5), Veri Kümesinin örneğin depolanması sırasında SOP Sınıfının kısıtlamalarıyla eşleşmediğini gözlemlemektedir.

Depolama Hata Kodları

Kod	Description
100	Sağlanan örnek öznitelikleri doğrulama ölçütlerini karşılamadı.

Alma (WADO-RS)

Bu Alma İşlemi, başvuruya göre depolanan çalışmaları, serileri, örnekleri ve çerçeveleri almak için destek sunar.

Metot	Yol	Açıklama
GET	.. /studies/{study}	Bir çalışmadaki tüm örnekleri alır
GET	.. /studies/{study}/metadata	Bir çalışmadaki tüm örneklerin meta verilerini alır
GET	.. /studies/{study}/series/{series}	Seri içindeki tüm örnekleri alır
GET	.. /studies/{study}/series/{series}/metadata	Bir serideki tüm örnekler için meta verileri alır
GET	.. /studies/{study}/series/{series}/instances/{instance}	Tek bir örneği alır
GET	.. /studies/{study}/series/{series}/instances/{instance}/metadata	Tek bir örneğin meta verilerini alır
GET	.. /studies/{study}/series/{series}/instances/{instance}/rendered	Görüntü biçiminde işlenen bir örneği alır
GET	.. /studies/{study}/series/{series}/instances/{instance}/frames/{frames}	Tek bir örnekten bir veya birden çok kare alır; Birden fazla çerçeve belirtmek için, döndürülecek her kareyi ayırmak için virgül kullanın. Örneğin, /studies/1/series/2/instance/3/frames/4,5,6.
GET	.. /studies/{study}/series/{series}/instances/{instance}/frames/{frame}/rendered	Görüntü biçiminde işlenen tek bir çerçeveyi alır

Çalışma veya seri içindeki örnekleri alma

Aşağıdaki Accept üst bilgiler, bir çalışma veya seri içindeki örnekleri almak için desteklenir.

• multipart/related; type="application/dicom"; transfer-syntax=*
• multipart/related; type="application/dicom"; (aktarım söz dizimi belirtilmediğinde, varsayılan olarak 1.2.840.10008.1.2.1 kullanılır)
• multipart/related; type="application/dicom"; transfer-syntax=1.2.840.10008.1.2.1
• multipart/related; type="application/dicom"; transfer-syntax=1.2.840.10008.1.2.4.90

• */* (transfer-syntax belirtilmediğinde, * varsayılan olarak kullanılır ve mediaType varsayılan application/dicomolarak kullanılır)

Örnek Alma

Belirli bir örneği almak için aşağıdaki Accept üst bilgiler desteklenir:

• application/dicom; transfer-syntax=*
• multipart/related; type="application/dicom"; transfer-syntax=*
• application/dicom; (aktarım söz dizimi belirtilmediğinde varsayılan 1.2.840.10008.1.2.1 olarak kullanılır)
• multipart/related; type="application/dicom" (aktarım söz dizimi belirtilmediğinde varsayılan 1.2.840.10008.1.2.1 olarak kullanılır)
• application/dicom; transfer-syntax=1.2.840.10008.1.2.1
• multipart/related; type="application/dicom"; transfer-syntax=1.2.840.10008.1.2.1
• application/dicom; transfer-syntax=1.2.840.10008.1.2.4.90
• multipart/related; type="application/dicom"; transfer-syntax=1.2.840.10008.1.2.4.90

• */* (transfer-syntax belirtilmediğinde, * varsayılan olarak kullanılır ve mediaType varsayılan application/dicomolarak kullanılır)

ÇerçeveLeri Alma

Çerçeveleri almak için aşağıdaki Accept üst bilgiler desteklenir.

• multipart/related; type="application/octet-stream"; transfer-syntax=*
• multipart/related; type="application/octet-stream"; (aktarım söz dizimi belirtilmediğinde varsayılan 1.2.840.10008.1.2.1 olarak kullanılır)
• multipart/related; type="application/octet-stream"; transfer-syntax=1.2.840.10008.1.2.1
• multipart/related; type="image/jp2"; (aktarım söz dizimi belirtilmediğinde varsayılan 1.2.840.10008.1.2.4.90 olarak kullanılır)
• multipart/related; type="image/jp2";transfer-syntax=1.2.840.10008.1.2.4.90

• */* (transfer-syntax belirtilmediğinde, * varsayılan olarak kullanılır ve mediaType varsayılan application/octet-streamolarak kullanılır)

Aktarım söz dizimlerini alma

İstenen aktarım söz dizimi özgün dosyadan farklı olduğunda, özgün dosya istenen aktarım söz dizimine dönüştürülür. Dönüştürmenin başarılı olması için özgün dosyanın aşağıdaki biçimlerden biri olması gerekir, aksi takdirde kod dönüştürme başarısız olabilir.

• 1.2.840.10008.1.2 (Küçük Endian Örtük)
• 1.2.840.10008.1.2.1 (Küçük Endian Açık)
• 1.2.840.10008.1.2.2 (Açık VR Big Endian)
• 1.2.840.10008.1.2.4.50 (JPEG Temel İşlem 1)
• 1.2.840.10008.1.2.4.57 (JPEG Kayıpsız)
• 1.2.840.10008.1.2.4.70 (JPEG Kayıpsız Seçim Değeri 1)
• 1.2.840.10008.1.2.4.90 (Yalnızca JPEG 2000 Kayıpsız)
• 1.2.840.10008.1.2.4.91 (JPEG 2000)
• 1.2.840.10008.1.2.5 (RLE Kayıpsız)

Desteklenmeyen bir sonuç ile sonuçlanır transfer-syntax 406 Not Acceptable.

Meta verileri alma (çalışma, seri veya örnek için)

Bir çalışma, seri veya örnek için meta verileri almak için aşağıdaki Accept üst bilgi desteklenir.

• application/dicom+json

Meta veriler alınırken aşağıdaki değer gösterimlerine sahip öznitelikler döndürülmüyor.

VR Adı	Açıklama
OB	Diğer Bayt
OD	Diğer Çift
OF	Diğer Kayan
OL	Diğer Uzun
OV	Diğer 64 bit Çok Uzun
OW	Diğer Sözcük
BM	Bilinmiyor

Meta veri önbelleği doğrulamasını alma (çalışma, seri veya örnek için)

Önbellek doğrulaması, mekanizma kullanılarak ETag desteklenir. Meta veri isteğine yanıt olarak, ETag üst bilgilerden biri olarak döndürülür. Bu ETag önbelleğe alınıp aynı meta veriler için sonraki isteklerde üst bilgi olarak If-None-Match eklenebilir. Veriler varsa iki tür yanıt mümkündür:

• Son istek sonrasında veriler değişmez: HTTP 304 (Not Modified) yanıt, yanıt gövdesi olmadan gönderilir.
• Son istek sonrasında veriler değişti: HTTP 200 (OK) yanıt güncelleştirilmiş ETag ile gönderilir. Gerekli veriler de gövdenin bir parçası olarak döndürülür.

İşlenen görüntüyü alma (örneğin veya çerçeve)

Aşağıdaki Accept üst bilgiler, işlenen bir görüntüyü bir örneği veya çerçeveyi almak için desteklenir.

• image/jpeg
• image/png

Üst bilgi belirtilmezse Accept , hizmet varsayılan olarak bir image/jpeg işler.

Hizmet yalnızca tek bir çerçevenin işlenmesini destekler. Birden çok çerçeveye sahip bir örnek için işleme istenirse, varsayılan olarak yalnızca ilk çerçeve görüntü olarak işlenir.

Döndürülecek belirli bir çerçeveyi belirtirken, çerçeve dizinleme 1'de başlar.

Sorgu quality parametresi de desteklenir. Sorgu parametresi için bir tamsayı değeri ( 1 100 en kötü kalite olan 1 ve en iyi kalite olan 100) geçirilebilir. Bu parametre olarak jpegişlenen görüntüler için kullanılır ve işleme istekleri için png yoksayılır. Belirtilmezse parametresi varsayılan olarak olur 100.

Yanıt durum kodlarını alma

Kod	Description
200 (OK)	İstenen tüm veriler alındı.
304 (Not Modified)	İstenen veriler son istek sonrasında değiştirilmedi. Bu durumda içerik yanıt gövdesine eklenmez. Daha fazla bilgi için önceki Meta Veri Önbelleği Doğrulamasını Alma (Çalışma, Seri veya Örnek için) bölümüne bakın.
400 (Bad Request)	İstek hatalı biçimlendirildi. Örneğin, sağlanan çalışma örneği tanımlayıcısı beklenen UID biçimine uymadı veya istenen aktarım söz dizimi kodlaması desteklenmiyor.
401 (Unauthorized)	İstemcinin kimliği doğrulanmamış.
403 (Forbidden)	Kullanıcı yetkilendirilmiyor.
404 (Not Found)	Belirtilen DICOM kaynağı bulunamadı veya işlenmiş bir istek için örnek piksel verileri içermiyordu.
406 (Not Acceptable)	Belirtilen Accept üst bilgi desteklenmiyor veya işlenen ve dönüştürülen istekler için istenen dosya çok büyük.
503 (Service Unavailable)	Hizmet kullanılamıyor veya meşgul. Daha sonra tekrar deneyin.

Arama (QIDO-RS)

DICOM Nesnelerinin (QIDO) kimliğine dayalı sorgu, özniteliklere göre çalışmaları, serileri ve örnekleri aramanızı sağlar.

Metot	Yol	Açıklama
Çalışmaları Ara
GET	.. /Çalışmaları?...	Çalışmalar için arama
Seri ara
GET	.. /silsile?...	Seri arama
GET	.. /studies/{study}/series?...	Bir çalışmada seri arama
Örnek Ara
GET	.. /Örnek?...	Örnekleri arama
GET	.. /studies/{study}/instances?...	Çalışmadaki örnekleri arama
GET	.. /studies/{study}/series/{series}/instances?...	Serideki örnekleri arama

Arama için aşağıdaki Accept üst bilgi desteklenir:

• application/dicom+json

Desteklenen arama parametreleri

Her sorgu için aşağıdaki parametreler desteklenir.

Anahtar	Destek Değerleri	İzin Verilen Sayı	Açıklama
{attributeID}=	{value}	0...N	Sorguda öznitelik/değer eşleştirme araması
includefield=	{attributeID} all	0...N	Yanıtta döndürülecek diğer öznitelikler; Hem genel hem de özel etiketler desteklenir. Sağlandığında all . Her sorgu türü için hangi özniteliklerin döndürüldiği hakkında daha fazla bilgi için Arama Yanıtı'na bakın. ve'nin {attributeID} all bir karışımı sağlanırsa, sunucu varsayılan olarak öğesini kullanır all.
limit=	{value}	0..1	Yanıtta döndürülen değerlerin sayısını sınırlamak için tamsayı değeri; Değer, varsayılan olarak 100 olan 1 >= x <= 200 aralığı arasında olabilir.
offset=	{value}	0..1	Sonuçları atla {value} ; Arama sorgusu sonuçlarının sayısından daha büyük bir uzaklık sağlanırsa, bir 204 (no content) yanıt döndürülür.
fuzzymatching=	true / false	0..1	PatientName özniteliğine doğru benzer eşleşme uygulanıyorsa; PatientName değerinin içindeki herhangi bir ad bölümünün ön ek sözcük eşleşmesini yapar. Örneğin, PatientName "John^Doe" ise, "joh", "do", "jo do", "Doe" ve "John Doe" eşleşir. Ama "ohn" eşleşmiyor.

Aranabilir öznitelikler

Aşağıdaki öznitelikleri ve arama türlerini aramayı destekliyoruz.

Öznitelik Anahtar Sözcüğü	Tüm Çalışmalar	Tüm Seriler	Tüm Örnekler	Çalışma Serisi	Çalışma Örnekleri	Study Series'in Örnekleri
StudyInstanceUID	X	X	X
PatientName	X	X	X
PatientID	X	X	X
PatientBirthDate	X	X	X
AccessionNumber	X	X	X
ReferringPhysicianName	X	X	X
StudyDate	X	X	X
StudyDescription	X	X	X
ModalitiesInStudy	X	X	X
SeriesInstanceUID		X	X	X	X
Modality		X	X	X	X
PerformedProcedureStepStartDate		X	X	X	X
ManufacturerModelName		X	X	X	X
SOPInstanceUID			X		X	X

Arama eşleştirme

Aşağıdaki eşleşen türleri destekliyoruz.

Arama Türü	Desteklenen Öznitelik	Örnek
Aralık Sorgusu	StudyDate/PatientBirthDate	{attributeID}={value1}-{value2}. Tarih/saat değerleri için etiketinde ile eşlenen attributeID >= {value1} AND attributeID <= {value2}kapsayıcı bir aralığı destekleriz. Belirtilmezse {value1} , önceki ve dahil {value2} edilen tarih/saatlerin tüm oluşumları eşleştirilir. Benzer şekilde, belirtilmezse {value2} , tüm oluşumları {value1} ve sonraki tarihler/saatler eşleştirilir. Ancak, bu değerlerden birinin mevcut olması gerekir. {attributeID}={value1}- ve {attributeID}=-{value2} geçerlidir ancak {attributeID}=- geçersizdir.
Tam Eşleşme	Desteklenen tüm öznitelikler	{attributeID}={value1}
Benzer Eşleşme	PatientName, ReferringPhysicianName	Adın değerle başlayan herhangi bir bileşeniyle eşleşir.

Öznitelik Kimliği

Etiketler, sorgu parametresi için çeşitli yollarla kodlanabilir. PS3.18 6.7.1.1.1'de tanımlandığı şekilde standardı kısmen uyguladık. Bir etiket için aşağıdaki kodlamalar desteklenir.

Değer	Örnek
{group}{element}	0020000D
{dicomKeyword}	StudyInstanceUID

Örnekleri arayan örnek bir sorgu aşağıda verilmiştir:

../instances?Modality=CT&00280011=512&includefield=00280010&limit=5&offset=0

Arama yanıtı

Yanıt, DICOM veri kümelerinden oluşan bir dizidir. Kaynağa bağlı olarak, varsayılan olarak aşağıdaki öznitelikler döndürülür.

Varsayılan Çalışma etiketleri

Etiket	Öznitelik Adı
(0008, 0005)	SpecificCharacterSet
(0008, 0020)	StudyDate
(0008, 0030)	StudyTime
(0008, 0050)	AccessionNumber
(0008, 0056)	InstanceAvailability
(0008, 0090)	ReferringPhysicianName
(0008, 0201)	TimezoneOffsetFromUTC
(0010, 0010)	PatientName
(0010, 0020)	PatientID
(0010, 0030)	PatientBirthDate
(0010, 0040)	PatientSex
(0020, 0010)	StudyID
(0020, 000D)	StudyInstanceUID

Varsayılan Seri etiketleri

Etiket	Öznitelik Adı
(0008, 0005)	SpecificCharacterSet
(0008, 0060)	Modality
(0008, 0201)	TimezoneOffsetFromUTC
(0008, 103E)	SeriesDescription
(0020, 000E)	SeriesInstanceUID
(0040, 0244)	PerformedProcedureStepStartDate
(0040, 0245)	PerformedProcedureStepStartTime
(0040, 0275)	RequestAttributesSequence

Varsayılan Örnek etiketleri

Etiket	Öznitelik Adı
(0008, 0005)	SpecificCharacterSet
(0008, 0016)	SOPClassUID
(0008, 0018)	SOPInstanceUID
(0008, 0056)	InstanceAvailability
(0008, 0201)	TimezoneOffsetFromUTC
(0020, 0013)	InstanceNumber
(0028, 0010)	Rows
(0028, 0011)	Columns
(0028, 0100)	BitsAllocated
(0028, 0008)	NumberOfFrames

ise includefield=all, aşağıdaki öznitelikler varsayılan özniteliklerle birlikte eklenir. Bu, varsayılan özniteliklerle birlikte her kaynak düzeyinde desteklenen özniteliklerin tam listesidir.

Ek Çalışma etiketleri

Etiket	Öznitelik Adı
(0008, 1030)	Study Description
(0008, 0063)	AnatomicRegionsInStudyCodeSequence
(0008, 1032)	ProcedureCodeSequence
(0008, 1060)	NameOfPhysiciansReadingStudy
(0008, 1080)	AdmittingDiagnosesDescription
(0008, 1110)	ReferencedStudySequence
(0010, 1010)	PatientAge
(0010, 1020)	PatientSize
(0010, 1030)	PatientWeight
(0010, 2180)	Occupation
(0010, 21B0)	AdditionalPatientHistory

Diğer Seri etiketleri

Etiket	Öznitelik Adı
(0020, 0011)	SeriesNumber
(0020, 0060)	Laterality
(0008, 0021)	SeriesDate
(0008, 0031)	SeriesTime

Aşağıdaki öznitelikler döndürülür:

• Kaynak URL'sindeki tüm eşleşen sorgu parametreleri ve UID'ler.
• IncludeField bu kaynak düzeyinde desteklenen öznitelikler.
• Hedef kaynak iseAll SeriesStudy, düzey öznitelikleri de döndürülür.
• Hedef kaynak ise All InstancesStudy ve Series düzey öznitelikleri de döndürülür.
• Hedef kaynak iseStudy's InstancesSeries, düzey öznitelikleri de döndürülür.
• NumberOfStudyRelatedInstancestoplama özniteliği düzeyinde includeFielddesteklenirStudy.
• NumberOfSeriesRelatedInstancestoplama özniteliği düzeyinde includeFielddesteklenirSeries.

Arama yanıtı kodları

Sorgu API'si yanıtta aşağıdaki durum kodlarından birini döndürür.

Kod	Description
200 (OK)	Yanıt yükü eşleşen tüm kaynakları içerir.
204 (No Content)	Arama başarıyla tamamlandı ancak sonuç döndürmedi.
400 (Bad Request)	Sorgu bileşeni geçersiz olduğundan sunucu sorguyu gerçekleştiremedi. Yanıt gövdesi hatanın ayrıntılarını içerir.
401 (Unauthorized)	İstemcinin kimliği doğrulanmamış.
403 (Forbidden)	Kullanıcı yetkilendirilmiyor.
503 (Service Unavailable)	Hizmet kullanılamıyor veya meşgul. Daha sonra tekrar deneyin.

Diğer notlar

• kullanarak TimezoneOffsetFromUTC (00080201) sorgulama desteklenmez.
• Sorgu API'si döndürmüyor 413 (request entity too large). İstenen sorgu yanıt sınırı kabul edilebilir aralığın dışındaysa, hatalı bir istek döndürülür. Kabul edilebilir aralık içinde istenen her şey çözümlenir.
• Hedef kaynak Study/Series olduğunda, birden çok örnekte tutarsız çalışma/seri düzeyi meta verileri olasılığı vardır. Örneğin, iki örneğin farklı patientName'i olabilir. Bu durumda en son kazançlar elde edilir ve yalnızca en son verilerde arama yapabilirsiniz.
• Sayfalandırılmış sonuçlar ilk olarak eşleşen en yeni örneği döndürecek şekilde iyileştirilmiştir; sorguyla eşleşen daha yeni veriler eklendiğinde bu durum sonraki sayfalarda yinelenen kayıtlara neden olabilir.
• Eşleştirme büyük /küçük harfe duyarlı değildir ve PN VR türleri için aksan duyarlı değildir .
• Eşleştirme büyük /küçük harfe duyarlı değildir ve diğer dize VR türleri için aksan duyarlıdır .
• Tek bir değerli veri öğesi yanlış birden çok değere sahipse yalnızca ilk değer dizine alınır.

Sil

Bu işlem resmi DICOMwe Standard kapsamında değildir. Store'dan Çalışmalar, Seriler ve Örnekler'in gösterimlerini kaldırmak için DELETE yöntemini kullanır.

Metot	Yol	Açıklama
SİL	.. /studies/{study}	Belirli bir çalışma için tüm örnekleri silme
SİL	.. /studies/{study}/series/{series}	Bir çalışmadaki belirli bir serinin tüm örneklerini silme
SİL	.. /studies/{study}/series/{series}/instances/{instance}	Seri içindeki belirli bir örneği silme

, ve parametreleri studysırasıyla , SeriesInstanceUIDve SopInstanceUID DICOM özniteliklerine StudyInstanceUIDkarşılık instance gelir. series

İsteğin üst bilgisi, Content-Type üst bilgisi veya gövde içeriğinde herhangi bir Accept kısıtlama yoktur.

Yanıt durum kodları

Kod	Description
204 (No Content)	Tüm SOP örnekleri silindiğinde
400 (Bad Request)	İstek hatalı biçimlendirildi
401 (Unauthorized)	İstemcinin kimliği doğrulanmamış
403 (Forbidden)	Kullanıcı yetkili değil
404 (Not Found)	Belirtilen seri bir çalışma içinde bulunamadığında veya belirtilen örnek seri içinde bulunamadığında
503 (Service Unavailable)	Hizmet kullanılamıyor veya meşgul. Daha sonra tekrar deneyin.

Yanıt yükünü silme

Yanıt gövdesi boş. Döndürülen tek yararlı bilgi durum kodudur.

İş Listesi Hizmeti (UPS-RS)

DICOM hizmeti, Worklist Hizmeti'nin (UPS-RS) Gönderme ve Çekme SOP'lerini destekler. İş Listesi hizmeti, Her biri Birleştirilmiş Yordam Adımını (UPS) temsil eden Workitems içeren tek bir İş Listesine erişim sağlar.

URI şablonundaki değişken {workitem} , workitem UID anlamına gelir.

Kullanılabilir UPS-RS uç noktaları şunlardır:

Fiil	Yol	Açıklama
POST	{s}/workitems{? AffectedSOPInstanceUID}	İş öğesi oluştur
POST	{s}/workitems/{instance}{?transaction}	Bir iş öğesini güncelleştir
GET	{s}/workitems{?query*}	İş öğelerini arama
GET	{s}/workitems/{instance}	İş öğesi alma
PUT	{s}/workitems/{instance}/state	İş öğesi durumunu değiştirme
POST	{s}/workitems/{instance}/cancelrequest	İş öğesini iptal et
POST	{s}/workitems/{instance}/subscribers/{AETitle}{?deletionlock}	Abonelik oluşturma
POST	{s}/workitems/1.2.840.10008.5.1.4.34.5/	Aboneliği askıya alma
SİL	{s}/workitems/{instance}/subscribers/{AETitle}	Aboneliği silme
GET	{s}/aboneler/{AETitle}	Abonelik kanalını açma

Workitem Oluşturma

Bu işlem, yeni bir Workitem oluşturmak için POST yöntemini kullanır.

Metot	Yol	Açıklama
POST	.. /workitems	Workitem oluşturma
POST	.. /workitems? {workitem}	Belirtilen UID ile bir Workitem oluşturur.

URI'de belirtilmezse yük veri kümesi özniteliğinde Workitem içermelidir SOPInstanceUID .

Accept ve Content-Type üst bilgileri istekte gereklidir ve her ikisinin de değerine application/dicom+jsonsahip olması gerekir.

Belirli bir işlem bağlamında DICOM veri öznitelikleriyle ilgili çeşitli gereksinimler vardır. Özniteliklerin mevcut olması, mevcut olmaması, boş olması veya boş olmaması gerekebilir. Bu gereksinimler bu tabloda bulunabilir.

Yanıt durum kodları oluşturma

Kod	Description
201 (Created)	Hedef Workitem başarıyla oluşturuldu.
400 (Bad Request)	İstekle ilgili bir sorun oluştu. Örneğin istek yükü gereksinimleri karşılamadı.
401 (Unauthorized)	İstemcinin kimliği doğrulanmamış.
403 (Forbidden)	Kullanıcı yetkilendirilmiyor.
409 (Conflict)	Workitem zaten var.
415 (Unsupported Media Type)	Sağlanan Content-Type desteklenmez.
503 (Service Unavailable)	Hizmet kullanılamıyor veya meşgul. Daha sonra tekrar deneyin.

Yanıt yükü oluşturma

Başarı yanıtının yükü yoktur. Location ve Content-Location yanıt üst bilgileri, oluşturulan Workitem için bir URI başvurusu içerir.

Hata yanıtı yükü, hatayı açıklayan bir ileti içerir.

İptal isteğinde bulunma

Bu işlem, kullanıcının desteklenmeyen bir Workitem'in iptalini istemesine olanak tanır.

Dört geçerli Workitem durumu vardır.

• SCHEDULED
• IN PROGRESS
• CANCELED
• COMPLETED

Bu işlem yalnızca durumundaki SCHEDULED Workitem'lere karşı başarılı olur. Herhangi bir kullanıcı, İşlem UID'sini ayarlayarak ve durumunu IN PROGRESSolarak değiştirerek bir Workitem'in sahipliğini talep edebilir. Bundan sonra, kullanıcı yalnızca doğru Transaction UID'yi sağlayarak Workitem'i değiştirebilir. UPS, iptal isteklerinin ve diğer olayların iletilmesine izin veren İzleme ve Olay SOP sınıflarını tanımlasa da, bu DICOM hizmeti bu sınıfları uygulamaz ve bu nedenle hata döndüren iş öğelerindeki iptal istekleri.IN PROGRESS Sahip olunan bir Workitem, Change Workitem State işlemi aracılığıyla iptal edilebilir.

Metot	Yol	Açıklama
POST	.. /workitems/{workitem}/cancelrequest	Zamanlanmış bir Workitem'in iptalini isteme

Content-Type Üst bilgi gereklidir ve değerine application/dicom+jsonsahip olmalıdır.

İstek yükü, DICOM Standard'da tanımlanan Eylem Bilgilerini içerebilir.

İstek iptali yanıt durumu kodları

Kod	Description
202 (Accepted)	İstek sunucu tarafından kabul edildi, ancak Target Workitem durumu değişmedi.
400 (Bad Request)	İsteğin söz diziminde bir sorun oluştu.
401 (Unauthorized)	İstemcinin kimliği doğrulanmamış.
403 (Forbidden)	Kullanıcı yetkilendirilmiyor.
404 (Not Found)	Target Workitem bulunamadı.
409 (Conflict)	İstek, Hedef Çalışma Öğesinin geçerli durumuyla tutarsız. Örneğin, Target Workitem veya COMPLETED durumundadırSCHEDULED.
415 (Unsupported Media Type)	Sağlanan Content-Type desteklenmez.

İptal yanıtı yükü isteme

Başarılı yanıtın yükü yoktur ve hata yanıtı yükü, hatayı açıklayan bir ileti içerir. Workitem Örneği zaten iptal edilmiş durumdaysa yanıt aşağıdaki HTTP Uyarısı üst bilgisini içerir: 299: The UPS is already in the requested state of CANCELED.

Workitem'i alma

Bu işlem bir Workitem alır. UPS DIMSE N-GET işlemine karşılık gelir.

Şu ifadeye bakın: https://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_11.5

Kaynak sunucuda Workitem varsa, Workitem Kabul Edilebilir Medya Türünde döndürülür. Döndürülen Workitem, Transaction UID (0008.1195) Özniteliğini içermez. Bu, özniteliğin erişim kilidi rolünü korumak için gereklidir.

Metot	Yol	Açıklama
GET	.. /workitems/{workitem}	Workitem alma isteği

Accept Üst bilgi gereklidir ve değerine application/dicom+jsonsahip olmalıdır.

Workitem yanıt durum kodlarını alma

Kod	Description
200 (Tamam)	Workitem Örneği başarıyla alındı.
400 (Hatalı İstek)	İstekle ilgili bir sorun oluştu.
401 (Yetkisiz)	İstemcinin kimliği doğrulanmamış.
403 (Yasak)	Kullanıcı yetkilendirilmiyor.
404 (Bulunamadı)	Target Workitem bulunamadı.

Workitem yanıt yükünü alma

• Başarılı yanıtın, Seçili Medya Türü'nde istenen Workitem'i içeren tek bir parça yükü vardır.
• Döndürülen Workitem, Workitem'in Transaction UID (0008, 1195) özniteliğini içermez çünkü bunun yalnızca Sahip tarafından bilinmesi gerekir.

Workitem'i güncelleştirme

Bu işlem, mevcut bir Workitem'in özniteliklerini değiştirir. UPS DIMSE N-SET işlemine karşılık gelir.

Şu ifadeye bakın: https://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_11.6

Şu anda durumunda olan bir Workitem'i SCHEDULED güncelleştirmek için özniteliğinin Transaction UID mevcut olmaması gerekir. Durumundaki IN PROGRESS bir Workitem için isteğin sorgu parametresi olarak geçerli Transaction UID'yi içermesi gerekir. Workitem zaten veya durumlarındaysaCOMPLETED, yanıt olur400 (Bad Request).CANCELED

Metot	Yol	Açıklama
POST	.. /workitems/{workitem}? {transaction-uid}	Workitem İşlemlerini Güncelleştirme

Content-Type Üst bilgi gereklidir ve değerine application/dicom+jsonsahip olmalıdır.

İstek yükü, hedef Workitem'e uygulanacak değişiklikleri içeren bir veri kümesi içerir. Bir dizi değiştirildiğinde, istek yalnızca değiştirilecek Öğeler'i değil, dizideki tüm Öğeleri içermelidir. Grup olarak birden çok Özniteliğin güncelleştirilmesi gerektiğinde, güncelleştirmeyi birden çok istek olarak değil, tek bir istekte birden çok Öznitelik olarak yapın.

Belirli bir işlem bağlamında DICOM veri öznitelikleriyle ilgili birçok gereksinim vardır. Özniteliklerin mevcut olması, mevcut olmaması, boş olması veya boş olmaması gerekebilir. Bu gereksinimler bu tabloda bulunabilir.

Workitem işlem yanıt durum kodlarını güncelleştirme

Kod	Description
200 (OK)	Target Workitem güncelleştirildi.
400 (Bad Request)	İstekle ilgili bir sorun oluştu. Örneğin: (1) Hedef Çalışma Öğesi veya CANCELED durumundaydıCOMPLETED. (2) İşlem UID'i eksik. (3) İşlem UID'i yanlış. (4) Veri kümesi gereksinimlere uygun değildi.
401 (Unauthorized)	İstemcinin kimliği doğrulanmamış.
403 (Forbidden)	Kullanıcı yetkilendirilmiyor.
404 (Not Found)	Target Workitem bulunamadı.
409 (Conflict)	İstek, Hedef Çalışma Öğesinin geçerli durumuyla tutarsız.
415 (Unsupported Media Type)	Sağlanan Content-Type desteklenmez.

Workitem işlem yanıt yükünü güncelleştirme

Kaynak sunucu, Tablo 11.6.3-2'de gerektiği gibi üst bilgi alanlarını destekler.

Başarılı yanıtın yükü yoktur veya Durum Raporu belgesi içeren bir yük vardır.

Hata yanıtı yükü, hataları, uyarıları veya diğer yararlı bilgileri açıklayan bir Durum Raporu içerebilir.

Workitem durumunu değiştirme

Bu işlem bir Workitem'in durumunu değiştirmek için kullanılır. "UPS Durumunu Değiştir" UPS DIMSE N-ACTION işlemine karşılık gelir. Durum değişiklikleri, bir Workitem'in sahipliğini talep etmek, tamamlamak veya iptal etmek için kullanılır.

Şu ifadeye bakın: https://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_11.7

Kaynak sunucuda Workitem varsa, Workitem Kabul Edilebilir Medya Türünde döndürülür. Döndürülen Workitem, Transaction UID (0008.1195) özniteliğini içermez. Bu, bu Özniteliğin rolünü burada açıklandığı gibi bir erişim kilidi olarak korumak için gereklidir.

Metot	Yol	Açıklama
PUT	.. /workitems/{workitem}/state	Workitem Durumunu Değiştir

Accept Üst bilgi gereklidir ve değerine application/dicom+jsonsahip olmalıdır.

İstek yükü, UPS Durum Veri Öğelerini Değiştir'i içerir. Bu veri öğeleri şunlardır:

• İşlem UID(0008, 1195). İstek yükü bir İşlem UID'sini içerir. Kullanıcı aracısı, belirli bir Workitem için duruma geçiş isteğinde bulunurken İşlem UID'sini IN PROGRESS oluşturur. Kullanıcı aracısı, bu Workitem ile sonraki işlemlerde İşlem UID'sini sağlar.
• Yordam Adım Durumu (0074, 1000). Yasal değerler istenen durum geçişine karşılık gelir. Bunlar: IN PROGRESS, COMPLETEDveya CANCELED.

Workitem durumu yanıt durum kodlarını değiştirme

Kod	Description
200 (OK)	Workitem Örneği başarıyla alındı.
400 (Bad Request)	İstek aşağıdaki nedenlerden biri nedeniyle gerçekleştirilemiyor. (1) Hedef Çalışma Öğesinin geçerli durumu göz önünde bulundurulduğunda istek geçerli değildir. (2) İşlem UID'i eksik. (3) İşlem UID'i yanlış
401 (Unauthorized)	İstemcinin kimliği doğrulanmamış.
403 (Forbidden)	Kullanıcı yetkilendirilmiyor.
404 (Not Found)	Target Workitem bulunamadı.
409 (Conflict)	İstek, Hedef Çalışma Öğesinin geçerli durumuyla tutarsız.

Workitem durumu yanıt yükünü değiştirme

• Yanıtlar, bölüm 11.7.3.2'de belirtilen üst bilgi alanlarını içerir.
• Başarı yanıtının yükü yoktur.
• Hata yanıtı yükü, hataları, uyarıları veya diğer yararlı bilgileri açıklayan bir Durum Raporu içerebilir.

Workitems Arama

Bu işlem özniteliklere göre Workitems aramanızı sağlar.

Metot	Yol	Açıklama
GET	.. /workitems?	Workitems araması

Arama için aşağıdaki Accept üst bilgi desteklenir.

• application/dicom+json

Desteklenen Arama Parametreleri

Her sorgu için aşağıdaki parametreler desteklenir.

Anahtar	Destek Değerleri	İzin Verilen Sayı	Açıklama
{attributeID}=	{value}	0...N	Sorguda öznitelik/değer eşleştirme araması
includefield=	{attributeID} all	0...N	Yanıtta döndürülecek diğer öznitelikler; Dizilerin parçası olan öznitelikler değil, yalnızca en üst düzey öznitelikler eklenebilir. Hem genel hem de özel etiketler desteklenir. Sağlandığında all , her sorgu türü için hangi özniteliklerin döndürüldiği hakkında daha fazla bilgi için bkz . Arama Yanıtı . ve'nin {attributeID} all bir karışımı sağlanırsa, sunucu varsayılan olarak 'all' kullanır.
limit=	{value}	0...1	Yanıtta döndürülen değerlerin sayısını sınırlamak için tamsayı değeri; Değer, varsayılan olarak olarak belirtilen 100aralığı 1 >= x <= 200arasında olabilir.
offset=	{value}	0...1	{value} sonuçlarını atla; Arama sorgusu sonuçlarının sayısından daha büyük bir uzaklık sağlanırsa, bir 204 (no content) yanıt döndürülür.
fuzzymatching=	true | false	0...1	Kişi Adı (PN) Değer Gösterimi (VR) ile tüm özniteliklere gerçek benzer eşleşme uygulanıyorsa; Bu özniteliklerin içindeki herhangi bir ad bölümünün ön ek sözcüğü eşleşmesi gerçekleştirilir. Örneğin, ise PatientName John^Doe, joh, do, jo doDoe ve John Doe tüm eşleşmeleri. Ancak ohn eşleşmiyor.

Aranabilir Öznitelikler

Bu özniteliklerde aramayı destekliyoruz.

Öznitelik Anahtar Sözcüğü
PatientName
PatientID
ReferencedRequestSequence.AccessionNumber
ReferencedRequestSequence.RequestedProcedureID
ScheduledProcedureStepStartDateTime
ScheduledStationNameCodeSequence.CodeValue
ScheduledStationClassCodeSequence.CodeValue
ScheduledStationGeographicLocationCodeSequence.CodeValue
ProcedureStepState
StudyInstanceUID

Arama Eşleştirme

Bu eşleşen türleri destekliyoruz.

Arama Türü	Desteklenen Öznitelik	Örnek
Aralık Sorgusu	Scheduled​Procedure​Step​Start​Date​Time	{attributeID}={value1}-{value2}. Tarih/saat değerleri için etikette kapsayıcı bir aralığı destekliyoruz. Bu, ile attributeID >= {value1} AND attributeID <= {value2}eşlenir. Belirtilmezse {value1} , önceki ve dahil {value2} edilen tarih/saatlerin tüm oluşumları eşleştirilir. Benzer şekilde, belirtilmezse {value2} , tüm oluşumları {value1} ve sonraki tarihler/saatler eşleştirilir. Ancak, bu değerlerden birinin mevcut olması gerekir. {attributeID}={value1}- ve {attributeID}=-{value2} geçerlidir ancak {attributeID}=- geçersizdir.
Tam Eşleşme	Desteklenen tüm öznitelikler	{attributeID}={value1}
Benzer Eşleşme	PatientName	Adın değerle başlayan herhangi bir bileşeniyle eşleşir

Öznitelik Kimliği

Etiketler, sorgu parametresi için birçok yolla kodlanabilir. PS3.18 6.7.1.1.1'de tanımlandığı şekilde standardı kısmen uyguladık. Bir etiket için aşağıdaki kodlamalar desteklenir.

Değer	Örnek
{group}{element}	00100010
{dicomKeyword}	PatientName

Örnek sorgu:

../workitems?PatientID=K123&0040A370.00080050=1423JS&includefield=00404005&limit=5&offset=0

Arama Yanıtı

Yanıt, aşağıdaki özniteliklerin döndürülür olduğu bir DICOM veri kümeleri dizisidir 0...N :

• 1 veya 2 Dönüş Anahtarı Türüne sahip DICOM PowerShell 3.4 Tablo CC.2.5-3'teki tüm öznitelikler.
• KOŞULLU gereksinimlerin karşılandığı 1C Dönüş Anahtar Türüne sahip DICOM PowerShell 3.4 Tablo CC.2.5-3'teki tüm öznitelikler.
• Diğer tüm Workitem öznitelikleri eşleştirme parametreleri olarak geçirilir.
• Parametre değerleri olarak includefield geçirilen diğer tüm Workitem öznitelikleri.

Arama Yanıt Kodları

Sorgu API'si yanıtta aşağıdaki durum kodlarından birini döndürür.

Kod	Description
200 (OK)	Yanıt yükü eşleşen tüm kaynakları içerir.
206 (Partial Content)	Yanıt yükü yalnızca arama sonuçlarından bazılarını içerir ve gerisi uygun istek aracılığıyla istenebilir.
204 (No Content)	Arama başarıyla tamamlandı ancak sonuç döndürmedi.
400 (Bad Request)	İstekle ilgili bir sorun oluştu. Örneğin, geçersiz Sorgu Parametresi söz dizimi. Yanıt gövdesi hatanın ayrıntılarını içerir.
401 (Unauthorized)	İstemcinin kimliği doğrulanmamış.
403 (Forbidden)	Kullanıcı yetkilendirilmiyor.
503 (Service Unavailable)	Hizmet kullanılamıyor veya meşgul. Daha sonra tekrar deneyin.

Diğer Notlar

Sorgu API'si döndürmüyor 413 (request entity too large). İstenen sorgu yanıt sınırı kabul edilebilir aralığın dışındaysa, hatalı bir istek döndürülür. Kabul edilebilir aralık içinde istenen her şey çözümlenir.

• Sayfalandırılmış sonuçlar, ilk olarak eşleşen en yeni örneği döndürecek şekilde iyileştirilmiştir ve bu da sorguyla eşleşen daha yeni veriler eklendiğinde sonraki sayfalarda yinelenen kayıtlara neden olabilir.
• Eşleştirme büyük /küçük harfe duyarlı değildir ve PN VR türleri için aksan duyarlı değildir .
• Eşleştirme büyük /küçük harfe duyarlı değildir ve diğer dize VR türleri için aksan duyarlıdır .
• Bir Workitem'i iptal etme ve aynı Workitem'i sorgulamanın aynı anda gerçekleştiği bir senaryo varsa, sorgu büyük olasılıkla güncelleştirilen Workitem'i dışlar ve yanıt kodu olur 206 (Partial Content).