Auf Englisch lesen

Teilen über

Was ist URL-Manipulation?

  • Artikel

Durch URL-Manipulation können Sie die URL des Bildspeicherorts anpassen, der sich im Antwortobjekt befindet.

Für die folgenden API-Vorgänge gibt der DICOM-Dienst die vollständig qualifizierte URL des Bildspeicherorts im Antwortobjekt unter einem DICOM-Tag (UR) im Antwortobjekt zurück.

  • Instanz abrufen
  • WorkItems abrufen
  • OperationStatus abrufen
  • QueryTag auflösen
  • QueryTagError auflösen

Hier ist ein Beispiel für eine vollqualifizierte Bildspeicherort-URL. Die URL finden Sie in der Standardantwort für einen STOW-Vorgang für einen DICOM-Dienst, bei dem die Datenpartitionierung aktiviert ist und der Partitionsname „foo“ lautet.

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

Die oben genannte URL besteht aus drei Teilen:

  • hostname ->https://localhost:63838 (der Hostname des DICOM-Diensts)
  • path ->v2/partitions/foo (der Pfad, der die verwendete Version des DICOM-Dienstes darstellt, und der Name der Datenpartition, falls aktiviert)
  • Der DICOM-Webstandardpfad ->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

Mit dieser Funktion können Sie den Pfad der Bild-URL anpassen, wenn dies vom Client angewiesen wird, basierend auf den bereitgestellten Anforderungsheadern.

Funktionsweise

Die geänderte URL basiert auf den folgenden zwei Headern.

  • X-Forwarded-Host: Der Domänenname des ursprünglichen Hosts (derjenige, den der Client angefordert hat, bevor der Proxy oder Lastenausgleich die Anfrage bearbeitet hat). Beispiel: X-Forwarded-Host: www.example.com

  • X-Forwarded-Prefix: der ursprüngliche URL-Pfad oder das Präfix, das Teil der Anfrage des Clients war, bevor der Proxy die Anfrage weitergeleitet oder geändert hat. Beispiel: X-Forwarded-Prefix: /prefix

Diese Header sind Teil der weitergeleiteten Header des .NET-Kernstandards.

Wenn der x-forwarded-host-Header im Anforderungsobjekt vorhanden ist, ersetzt er den Hostnamen durch den angegebenen Wert.

Wenn der x-forwarded-prefix-Header im Anforderungsobjekt vorhanden ist, ersetzt er den Pfad durch den angegebenen Wert.

Liste der Dienste, die weitergeleitete Header für die URL-Manipulation verwenden können

  • Store(STOW-RS): Laden Sie DICOM-Objekte auf den Server hoch.
  • Retrieve(WADO-RS): Laden Sie DICOM-Objekte vom Server herunter.
  • Worklist Service (UPS Push and Pull SOPs): Verwalten und verfolgen Sie Arbeitsabläufe bei der medizinischen Bildgebung.
  • Erweiterte Abfragetags: Definieren benutzerdefinierter Tags zum Abfragen von DICOM-Daten.
  • Vorgangsstatus

Hier sind die Details eines Anforderungsheaders für einen STOW-Vorgang mit den weitergeleiteten Headern:

  • Path: ../studies/{study}
  • Methode: POST
  • Headers:
    • Accept: application/DICOM+json
    • Content-Type: multipart/related; type="application/DICOM"
    • Authorization: Bearer {token value}
    • X-Forwarded-Host: {Domänenname des ursprünglichen Hosts}
    • X-Forwarded-Prefix: {der ursprüngliche URL-Pfad}
  • Hauptteil:
    • Content-Type: application/DICOM für jede hochgeladene Datei, getrennt durch einen Trennwert

Beispiel:

Ein Beispiel für einen DICOM-Tag mit VR = UR für einen STOW-Vorgang, wenn die weitergeleiteten Header nicht bereitgestellt werden, ist unten dargestellt.

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

Ein Beispiel für einen DICOM-Tag mit VR = UR für einen STOW-Vorgang, wenn die weitergeleiteten Header bereitgestellt werden, ist unten dargestellt.

Beispielanforderungsobjekt:

  • Pfad: https://localhost:63838/v2/partitions/foo/studies/studies/{study}
  • Methode: POST
  • Headers:
    • Accept: application/DICOM+json
    • Content-Type: multipart/related; type="application/DICOM"
    • Authorization: Bearer {token value}
    • X-Forwarded-Host: API.powershare.com
    • X-Forwarded-Prefix: /newbasePath
  • Hauptteil:
    • Content-Type: application/DICOM für jede hochgeladene Datei, getrennt durch einen Trennwert

Bild-URL: 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

Was Sie beachten sollten

  • Weitergeleitete Header müssen nicht zusammen verwendet werden. Wenn dies erforderlich ist, ersetzen Sie den Hostnamen und nicht den Pfad. Nur der weitergeleitete Hostheader kann verwendet werden. Ebenso kann nur der weitergeleitete Präfixheader verwendet werden, wenn der Pfad ersetzt werden muss.
  • Der Client ist für die Zuordnung des Hostnamens und des Pfads verantwortlich, der in weitergeleiteten Headern zum richtigen DICOM-Diensthost und zur Pfadbasis bereitgestellt wird.

Hinweis

DICOM® ist die eingetragene Marke des National Electrical Manufacturers Association für seine Standards-Publikationen über die digitale Kommunikation medizinischer Informationen.