Perubahan DICOM Service API v2
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 sini.
- 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=*
Cari
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 |
|---|---|---|
| Belajar | (0008, 1030) | StudyDescription |
| Seri | (0008, 1090) | ManufacturerModelName |
Atribut dihapus dari tag default.
| Tingkat tag | Tag | Nama Atribut |
|---|---|---|
| Belajar | (0008, 0005) | SpecificCharacterSet |
| Belajar | (0008, 0030) | StudyTime |
| Belajar | (0008, 0056) | InstanceAvailability |
| Belajar | (0008, 0201) | TimezoneOffsetFromUTC |
| Belajar | (0010, 0040) | PatientSex |
| Belajar | (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.