Bagikan melalui

Perubahan DICOM Service API v2

  • Artikel

Panduan referensi ini memberi Anda ringkasan perubahan dalam API V2 dari layanan DICOM®. Untuk melihat serangkaian kemampuan lengkap di v2, lihat Pernyataan Kesuaian DICOM v2.

Ringkasan perubahan di v2

Bursa

Validasi lenient atribut opsional

Di versi sebelumnya, permintaan Store gagal jika salah satu atribut yang diperlukan atau dapat dicari gagal validasi. Dimulai dengan v2, permintaan gagal hanya jika atribut yang diperlukan gagal validasi.

Validasi atribut yang gagal tidak diperlukan oleh API menghasilkan file yang disimpan dengan peringatan dalam respons. Peringatan menghasilkan kode 202 Accepted pengembalian HTTP dan payload respons berisi WarningReason tag (0008, 1196).

Peringatan diberikan tentang setiap atribut yang gagal per instans. Saat urutan berisi atribut yang gagal validasi, atau ketika ada beberapa masalah dengan satu atribut, hanya alasan atribut pertama yang gagal yang dicatat.

Ada beberapa perilaku penting untuk atribut opsional yang gagal validasi:

  • Mencari atribut yang gagal validasi mengembalikan studi/seri/instans jika nilai diperbaiki dengan salah satu dari beberapa cara yang disebutkan di bawah ini.
  • Atribut tidak dikembalikan saat mengambil metadata melalui titik akhir WADO /metadata .

Mengambil studi/seri/instans selalu mengembalikan file biner asli dengan atribut asli, bahkan jika atribut tersebut gagal divalidasi.

Jika atribut diisi dengan null, atribut diindeks saat dapat dicari dan disimpan apa adanya dalam metadata dicom+json. Tidak ada peringatan validasi yang disediakan.

Mengambil

Dukungan pengambilan bingkai tunggal

Pengambilan bingkai tunggal didukung dengan menambahkan header berikut Accept :

  • application/octet-stream; transfer-syntax=*

Hasil pencarian mungkin tidak lengkap untuk tag kueri yang diperluas dengan peringatan validasi

Di API v1 dan dilanjutkan untuk v2, jika tag kueri yang diperluas memiliki kesalahan, karena satu atau beberapa instans yang ada memiliki nilai tag yang tidak dapat diindeks, maka kueri pencarian berikutnya yang berisi pengembalian erroneous-dicom-attributes tag kueri yang diperluas sebagaimana dirinci dalam dokumentasi. Namun, tag (juga dikenal sebagai atribut) dengan peringatan validasi dari STOW-RS tidak disertakan dalam header ini. Jika permintaan penyimpanan menghasilkan peringatan validasi untuk atribut yang dapat dicari pada saat instans disimpan, atribut tersebut mungkin tidak digunakan untuk mencari instans yang disimpan. Namun, setiap atribut yang dapat dicari yang gagal validasi akan dapat mengembalikan hasil jika nilai ditimpa oleh instans dalam studi/seri yang sama yang disimpan setelah yang gagal, atau jika nilai sudah disimpan dengan benar oleh instans sebelumnya. Jika nilai atribut tidak ditimpa, maka nilai tersebut tidak akan menghasilkan hasil pencarian apa pun.

Atribut dapat dikoreksi dengan cara berikut:

  • Menghapus instans tersimpan dan mengunggah instans baru dengan data yang dikoreksi
  • Mengunggah instans baru dalam studi/seri yang sama dengan data yang dikoreksi

Lebih sedikit atribut Studi, Seri, dan Instans dikembalikan secara default

Kumpulan atribut yang dikembalikan secara default telah dikurangi untuk meningkatkan performa. Lihat daftar terperinci dalam dokumentasi respons pencarian.

Atribut ditambahkan baru ke tag default.

Tingkat tag Tag Nama Atribut
Studi (0008, 1030) StudyDescription
Seri (0008, 1090) ManufacturerModelName

Atribut dihapus dari tag default.

Tingkat tag Tag Nama Atribut
Studi (0008, 0005) SpecificCharacterSet
Studi (0008, 0030) StudyTime
Studi (0008, 0056) InstanceAvailability
Studi (0008, 0201) TimezoneOffsetFromUTC
Studi (0010, 0040) PatientSex
Studi (0020, 0010) StudyID
Seri (0008, 0005) SpecificCharacterSet
Seri (0008, 0201) TimezoneOffsetFromUTC
Seri (0008, 103E) SeriesDescription
Seri (0040, 0245) PerformedProcedureStepStartTime
Seri (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) Baris
Instans (0028, 0011) Kolom
Instans (0028, 0100) BitsAllocated
Instans (0028, 0008) NumberOfFrames

Semua tag yang dihapus adalah bagian dari tag tambahan yang akan dikembalikan ketika dikueri dengan includefield = all.

Atribut null padded dapat dicari dengan atau tanpa padding

Ketika atribut disimpan menggunakan padding null, atribut dapat dicari dengan atau tanpa padding null dalam pengodean uri. Hasil yang diambil adalah untuk atribut yang disimpan dengan dan tanpa padding null.

Operasional

Status completed telah diganti namanya menjadi succeeded

Untuk menyelaraskan dengan panduan REST API Microsoft, completed statusnya telah diganti namanya menjadi succeeded.

Pengubahan Umpan

Ubah umpan sekarang menerima rentang waktu

API Umpan Perubahan sekarang menerima parameter dan endTime opsional startTime untuk membantu mencakup hasilnya. Perubahan dalam rentang waktu masih dapat dipaginasi menggunakan parameter dan limit yang adaoffset. Offset relatif terhadap jendela waktu yang ditentukan oleh startTime dan endTime. Misalnya, entri umpan perubahan kelima mulai 24/7/2023 pukul 09.00 UTC akan menggunakan string ?startTime=2023-07-24T09:00:00Z&offset=5kueri .

Untuk v2, disarankan untuk selalu menyertakan rentang waktu untuk meningkatkan performa.

Catatan

DICOM® adalah merek dagang terdaftar dari Asosiasi Produsen Listrik Nasional untuk publikasi Standar yang berkaitan dengan komunikasi digital informasi medis.