次の方法で共有

URL 操作とは

URL 操作を使用すると、応答オブジェクト内の画像の場所の URL をカスタマイズできます。

以下の API 操作では、DICOM サービスは、応答オブジェクト内の DICOM タグ (UR) の下で、応答オブジェクト内の画像の場所を示す完全修飾 URL を返します。

  • インスタンスの取得
  • WorkItems の取得
  • OperationStatus の取得
  • QueryTag の解決
  • QueryTagError の解決

以下は、画像の場所を示す完全修飾 URL の例です。 この URL は、パーティション名 "foo" で、データ パーティションが有効になっている DICOM サービスに対する、STOW 操作の標準応答で確認できます。

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 は、次の 3 つの部分で構成されています。

  • ホスト名 - >https://localhost:63838 (DICOM サービスのホスト名)
  • パス ->v2/partitions/foo (使用されている DICOM サービスのバージョンとデータパーティション名を表すパス (有効な場合))
  • DICOM Web の標準パス ->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 のパスをカスタマイズできます。

しくみ

変更された URL は、次の 2 つのヘッダーに基づいています。

  • X-Forwarded-Host: 元のホストのドメイン名 (プロキシやロード バランサーで要求が処理される前にクライアントから要求された名前)。 例: X-Forwarded-Host: www.example.com

  • X-Forwarded-Prefix: プロキシが要求を転送または変更する前にクライアントの要求の一部であった元の URL パスまたはプレフィックス。 例: X-Forwarded-Prefix: /prefix

これらのヘッダーは、.NET Core の標準転送ヘッダーの一部です。

要求オブジェクトに x-forwarded-host ヘッダーが存在する場合は、ホスト名を指定された値に置き換えます。

要求オブジェクトに x-forwarded-prefix ヘッダーが存在する場合は、パスを指定された値に置き換えます。

URL 操作に転送されたヘッダーを使用できるサービスの一覧

  • 格納 (STOW-RS): DICOM オブジェクトをサーバーにアップロードします。
  • 取得 (WADO-RS): サーバーから DICOM オブジェクトをダウンロードします。
  • ワークリスト サービス (UPS プッシュおよびプル SOP):医療画像ワークフローを管理および追跡します。
  • 拡張クエリ タグ: DICOM データに対してクエリを実行するためのカスタム タグを定義します。
  • 操作の状態

以下は、STOW 操作の要求ヘッダーと転送ヘッダーの詳細です。

  • パス: ../studies/{study}
  • メソッド: POST
  • Headers:
    • Accept: application/DICOM+json
    • Content-Type: multipart/related; type="application/DICOM"
    • Authorization: Bearer {トークンの値}
    • X-Forwarded-Host: {元のホストのドメイン名}
    • X-Forwarded-Prefix: {元の URL パス}
  • 本文:
    • Content-Type: アップロードする各ファイルごとの application/DICOM (境界値で区切る)

例:

転送ヘッダーが指定されていない場合の STOW 操作における VR = UR の DICOM タグの例を以下に示します。

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

転送ヘッダーが指定されている場合の STOW 操作における VR = UR の DICOM タグの例を以下に示します。

要求オブジェクトの例:

  • パス: https://localhost:63838/v2/partitions/foo/studies/studies/{study}
  • メソッド: POST
  • Headers:
    • Accept: application/DICOM+json
    • Content-Type: multipart/related; type="application/DICOM"
    • Authorization: Bearer {トークンの値}
    • X-Forwarded-Host: API.powershare.com
    • X-Forwarded-Prefix: /newbasePath
  • 本文:
    • Content-Type: アップロードする各ファイルごとの application/DICOM (境界値で区切る)

画像の 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

注意点

  • 転送ヘッダーを一緒に使用する必要はありません。 必要がある場合は、パスではなくホスト名を置き換えます。 転送ホスト ヘッダーのみを使用できます。 同様に、パスを置き換える必要がある場合は、転送プレフィックス ヘッダーのみを使用できます。
  • 転送ヘッダーで指定されたホスト名とパスを、正しい DICOM サービス ホスト名とパスベースにマッピングするのは、クライアント側で行います。

Note

DICOM® は、医療情報のデジタル通信に関する標準出版物に関する米国電機工業会 (National Electrical Manufacturers Association) の登録商標です。