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

# を使用した臨床ドキュメントの生成 `$document`
<a name="reference-fhir-operations-document"></a>

AWS HealthLake は Composition リソースの `$document`オペレーションをサポートするようになりました。これにより、Composition と参照されるすべてのリソースを 1 つのまとまりのあるパッケージにバンドルすることで、完全な臨床ドキュメントを生成できます。このオペレーションは、以下を必要とするヘルスケアアプリケーションにとって不可欠です。
+ 標準化された臨床文書を作成する
+ 完全な患者レコードを交換する
+ 包括的な臨床ドキュメントを保存する
+ 関連するすべてのコンテキストを含むレポートを生成する

## 使用方法
<a name="document-usage"></a>

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

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


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

## サポートされているパラメータ
<a name="document-parameters"></a>

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


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

## 例
<a name="document-examples"></a>

**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"
            }
          ]
        }
      }
    }
  ]
}
```

## 行動
<a name="document-behavior"></a>

`$document` オペレーション:

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

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

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

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

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

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

1. 

   ```
   GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource/id
   ```

1. リソース/ID

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

## エラー処理
<a name="document-error-handling"></a>

オペレーションは、次のエラー条件を処理します。
+ 400 不正なリクエスト: 無効な`$document`オペレーション (非準拠リクエスト）、または永続化が true に設定されている場合に参照が除外されたために結果のドキュメントが FHIR 検証に失敗した場合
+ 404 Not Found: コンポジションリソースが見つかりません

`$document` オペレーション仕様の詳細については、[FHIR R4 コンポジション`$document`](https://www.hl7.org/fhir/R4/composition-operation-document.html)ドキュメントを参照してください。