Baca dalam bahasa Inggris

Bagikan melalui

Apa itu manipulasi URL

  • Artikel

Menggunakan manipulasi URL memungkinkan Anda menyesuaikan URL lokasi gambar yang ada di objek respons.

Untuk operasi API berikut, layanan DICOM mengembalikan URL lokasi gambar yang sepenuhnya memenuhi syarat di objek respons di bawah tag DICOM (UR) di objek respons.

  • Ambil Instans
  • Mengambil WorkItems
  • Mengambil OperationStatus
  • Mengatasi QueryTag
  • Mengatasi QueryTagError

Berikut adalah contoh URL lokasi gambar yang sepenuhnya memenuhi syarat. URL dapat ditemukan dalam respons standar untuk operasi STOW untuk layanan DICOM yang mengaktifkan partisi data, dengan nama partisi "foo".

https://localhost:63838/v2/partitions/foo/studies/1.2.826.0.1.3680043.8.498.13230779778012324449356534479549187420/series/1.2.826.0.1.3680043.8.498.77033797676425927098669402985243398207/instances/1.2.826.0.1.3680043.8.498.13273713909719068980354078852867170114

URL sebelumnya terdiri dari tiga bagian:

  • nama host ->https://localhost:63838 (nama host layanan DICOM)
  • path ->v2/partitions/foo (jalur yang mewakili versi layanan DICOM yang digunakan dan nama partisi data, jika diaktifkan)
  • Jalur standar web DICOM ->studies/1.2.826.0.1.3680043.8.498.13230779778012324449356534479549187420/series/1.2.826.0.1.3680043.8.498.77033797676425927098669402985243398207/instances/1.2.826.0.1.3680043.8.498.13273713909719068980354078852867170114

Fitur ini memungkinkan Anda untuk menyesuaikan jalur URL gambar, jika diarahkan oleh klien, berdasarkan header permintaan yang disediakan.

Cara kerjanya

URL yang dimodifikasi didasarkan pada dua header berikut.

  • X-Forwarded-Host: Nama domain host asli (yang diminta klien sebelum proksi atau load balancer menangani permintaan). Misalnya: X-Forwarded-Host: www.example.com

  • X-Forwarded-Prefix: jalur ATAU awalan URL asli yang merupakan bagian dari permintaan klien sebelum proksi diteruskan atau mengubah permintaan. Misalnya: X-Forwarded-Prefix: /prefix

Header ini adalah bagian dari header yang diteruskan standar inti .NET.

Jika x-forwarded-host header ada di objek permintaan, header menggantikan nama host dengan nilai yang disediakan.

Jika x-forwarded-prefix header ada di objek permintaan, header mengganti jalur dengan nilai yang disediakan.

Daftar layanan yang dapat menggunakan header yang diteruskan untuk manipulasi URL

  • Store(STOW-RS): Unggah objek DICOM ke server.
  • Retrieve(WADO-RS): Unduh objek DICOM dari server.
  • Worklist Service (UPS Push and Pull SOP): Mengelola dan melacak alur kerja pencitraan medis.
  • Tag kueri yang diperluas: Tentukan tag kustom untuk mengkueri data DICOM.
  • Status Operasi

Berikut adalah detail header permintaan untuk operasi STOW dengan header yang diteruskan:

  • Jalan:.. /studies/{study}
  • Metode: POST
  • Header:
    • Terima: application/DICOM+json
    • Jenis Konten: multipihak/terkait; type="application/DICOM"
    • Otorisasi: Pembawa {nilai token}
    • X-Forwarded-Host: {Nama domain host asli}
    • X-Forwarded-Prefix: {jalur URL asli}
  • Badan:
    • Jenis Konten: aplikasi/DICOM untuk setiap file yang diunggah, dipisahkan oleh nilai batas

Contoh:

Contoh tag DICOM dengan VR = UR untuk operasi STOW saat header yang diteruskan tidak disediakan ditunjukkan di bawah ini.

https://localhost:63838/v2/partitions/foo/studies/1.2.826.0.1.3680043.8.498.13230779778012324449356534479549187420/series/1.2.826.0.1.3680043.8.498.77033797676425927098669402985243398207/instances/1.2.826.0.1.3680043.8.498.13273713909719068980354078852867170114

Contoh tag DICOM dengan VR = UR untuk operasi STOW saat header yang diteruskan disediakan ditunjukkan di bawah ini.

Objek Permintaan Sampel:

  • Jalur: https://localhost:63838/v2/partitions/foo/studies/studies/{study}
  • Metode: POST
  • Header:
    • Terima: application/DICOM+json
    • Jenis Konten: multipihak/terkait; type="application/DICOM"
    • Otorisasi: Pembawa {nilai token}
    • X-Forwarded-Host: API.powershare.com
    • X-Forwarded-Prefix: /newbasePath
  • Badan:
    • Jenis Konten: aplikasi/DICOM untuk setiap file yang diunggah, dipisahkan oleh nilai batas

URL gambar: https://API.powershare.com/newbasePath/studies/1.2.826.0.1.3680043.8.498.13230779778012324449356534479549187420/series/1.2.826.0.1.3680043.8.498.45787841905473114233124723359129632652/instances/1.2.826.0.1.3680043.8.498.12714725698140337137334606354172323212

Hal-hal yang perlu diingat

  • Header yang diteruskan tidak harus digunakan bersama-sama. Jika perlu, ganti nama host dan bukan jalur. Hanya header host yang diteruskan yang dapat digunakan. Demikian pula, jika ada kebutuhan untuk mengganti jalur, hanya header awalan yang diteruskan yang dapat digunakan.
  • Klien bertanggung jawab untuk memetakan nama host dan jalur yang disediakan di header yang diteruskan ke nama host dan pathbase layanan DICOM yang benar.

Catatan

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