を使用した概念の詳細の取得 $lookup - AWS HealthLake
使用状況サポートされているパラメータ例レスポンスパラメータ行動エラー処理注意

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

を使用した概念の詳細の取得 $lookup

AWS HealthLake は CodeSystem リソースの $lookupオペレーションをサポートするようになりました。これにより、コードなどの識別情報を提供することで、コードシステム内の特定の概念に関する詳細を取得できます。このオペレーションは、以下が必要な場合に特に役立ちます。

  • 特定の医療コードに関する詳細情報を取得する

  • コードの意味とプロパティを検証する

  • アクセス概念の定義と関係

  • 正確な用語データで臨床上の意思決定をサポートする

使用状況

$lookup オペレーションは、GET メソッドと POST メソッドの両方を使用して CodeSystem リソースで呼び出すことができます。

サポートされているオペレーション

GET [base]/CodeSystem/$lookup?system=http://snomed.info/sct&code=73211009&version=20230901
POST [base]/CodeSystem/$lookup

サポートされているパラメータ

HealthLake は、FHIR R4 $lookupパラメータのサブセットをサポートしています。

パラメータ タイプ 必須 説明
code コード あり 検索する概念コード (SNOMED CT の「71620000」など）
system uri あり コードシステムの正規 URL (「http://snomed.info/sct」など）
version 文字列 なし コードシステムの特定のバージョン

例

GET リクエスト

GET [base]/CodeSystem/$lookup?system=http://snomed.info/sct&code=71620000&version=2023-09
POST リクエスト

POST [base]/CodeSystem/$lookup
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "system",
      "valueUri": "http://snomed.info/sct"
    },
    {
      "name": "code",
      "valueCode": "71620000"
    },
    {
      "name": "version",
      "valueString": "2023-09"
    }
  ]
}
レスポンス例

オペレーションは、概念の詳細を含む Parameters リソースを返します。

{
    "resourceType": "Parameters",
    "parameter": [{
            "name": "name",
            "valueString": "SNOMED CT Fractures"
        },
        {
            "name": "version",
            "valueString": "2023-09"
        },
        {
            "name": "display",
            "valueString": "Fracture of femur"
        },
        {
            "name": "property",
            "part": [{
                    "name": "code",
                    "valueCode": "child"
                },
                {
                    "name": "value",
                    "valueCode": "263225007"
                },
                {
                    "name": "description",
                    "valueString": "Fracture of neck of femur"
                }
            ]
        },
        {
            "name": "property",
            "part": [{
                    "name": "code",
                    "valueCode": "child"
                },
                {
                    "name": "value",
                    "valueCode": "263227004"
                },
                {
                    "name": "description",
                    "valueString": "Fracture of shaft of femur"
                }
            ]
        }
    ]
}

レスポンスパラメータ

レスポンスには、使用可能な場合、次のパラメータが含まれます。

パラメータ Type 説明
name string コードシステムの名前
version 文字列 コードシステムのバージョン
display 文字列 概念の表示名
designation BackboneElement この概念の追加表現。
property BackboneElement 概念の追加プロパティ (定義、関係など）

行動

$lookup オペレーション：

  1. 必要なパラメータを検証します (code および system）

  2. データストアに保存されている指定されたコードシステム内の概念を検索します。

  3. 表示名、指定、プロパティなど、詳細な概念情報を返します。

  4. version パラメータが指定されている場合のバージョン固有のルックアップをサポート

  5. HealthLake データストアに明示的に保存されているコードシステムでのみ動作します

エラー処理

オペレーションは、次のエラー条件を処理します。

  • 400 不正なリクエスト: 無効な$lookupオペレーション (非準拠のリクエストまたは必須パラメータの欠落）

  • 404 Not Found: コードシステムが見つからないか、指定されたコードシステムでコードが見つかりません

注意

このリリースでは、以下はサポートされていません。

  • $lookup 外部用語サーバーを呼び出して オペレーションを実行する

  • $lookup HealthLake によって管理されているが、データストアに明示的に保存されていない CodeSystems での オペレーション

$lookup オペレーション仕様の詳細については、FHIR R4 CodeSystem $lookup ドキュメントを参照してください。