を使用した臨床ドキュメントの生成 $document - AWS HealthLake

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

を使用した臨床ドキュメントの生成 $document

AWS HealthLake は Composition リソースの $documentオペレーションをサポートするようになりました。これにより、Composition と参照されるすべてのリソースを 1 つのまとまりのあるパッケージにバンドルすることで、完全な臨床ドキュメントを生成できます。このオペレーションは、以下を必要とするヘルスケアアプリケーションに不可欠です。

  • 標準化された臨床文書を作成する

  • 完全な患者レコードを交換する

  • 包括的な臨床ドキュメントを保存する

  • 関連するすべてのコンテキストを含むレポートを生成する

使用状況

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

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

GET/POST [base]/Composition/[id]/$document

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

HealthLake は、次の FHIR $documentパラメータをサポートしています。

パラメータ タイプ [Required] (必須) デフォルト 説明
persist boolean なし false サーバーが生成されたドキュメントバンドルを保存するかどうかを示すブール値

GET リクエスト

GET [base]/Composition/180f219f-97a8-486d-99d9-ed631fe4fc57/$document?persist=true
パラメータを含む POST リクエスト

POST [base]/Composition/180f219f-97a8-486d-99d9-ed631fe4fc57/$document Content-Type: application/fhir+json { "resourceType": "Parameters", "parameter": [ { "name": "persist", "valueBoolean": true } ] }
レスポンス例

オペレーションは、コンポジションと参照されるすべてのリソースを含む「ドキュメント」タイプの Bundle リソースを返します。

{ "resourceType": "Bundle", "id": "180f219f-97a8-486d-99d9-ed631fe4fc57", "type": "document", "identifier": { "system": "urn:ietf:rfc:3986", "value": "urn:uuid:0c3151bd-1cbf-4d64-b04d-cd9187a4c6e0" }, "timestamp": "2024-06-21T15:30:00Z", "entry": [ { "fullUrl": "http://example.org/fhir/Composition/180f219f-97a8-486d-99d9-ed631fe4fc57", "resource": { "resourceType": "Composition", "id": "180f219f-97a8-486d-99d9-ed631fe4fc57", "status": "final", "type": { "coding": [ { "system": "http://loinc.org", "code": "34133-9", "display": "Summary of Episode Note" } ] }, "subject": { "reference": "Patient/example" }, "section": [ { "title": "Allergies", "entry": [ { "reference": "AllergyIntolerance/123" } ] } ] } }, { "fullUrl": "http://example.org/fhir/Patient/example", "resource": { "resourceType": "Patient", "id": "example", "name": [ { "family": "Smith", "given": ["John"] } ] } }, { "fullUrl": "http://example.org/fhir/AllergyIntolerance/123", "resource": { "resourceType": "AllergyIntolerance", "id": "123", "patient": { "reference": "Patient/example" }, "code": { "coding": [ { "system": "http://snomed.info/sct", "code": "418689008", "display": "Allergy to penicillin" } ] } } } ] }

行動

$document オペレーション:

  1. 指定されたコンポジションリソースをドキュメントの基盤として使用します。

  2. コンポジションによって直接参照されるすべてのリソースを識別して取得します

  3. コンポジションと参照されるすべてのリソースを「ドキュメント」タイプのバンドルにパッケージ化します

  4. 永続パラメータが true に設定されている場合、生成されたドキュメントバンドルをデータストアに保存します。

  5. 包括的なドキュメント生成のために コンポジションによって間接的に参照されるリソースを識別して取得します

$document オペレーションは現在、次の形式のリソースリファレンスの取得をサポートしています。

  1. GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource/id
  2. リソース/ID

Composition リソース内のサポートされていないリソース参照は、生成されたドキュメントから除外されます。

エラー処理

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

  • 400 不正なリクエスト: 無効な$documentオペレーション (非準拠リクエスト)、または永続が true に設定されている場合に参照が除外されたために結果のドキュメントが FHIR 検証に失敗した場合

  • 404 Not Found: コンポジションリソースが見つかりません

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