翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # HealthLake の FHIR R4 `$davinci-data-export`オペレーション `$davinci-data-export` オペレーションは、医療データのエクスポートに使用できる非同期 FHIR オペレーションです AWS HealthLake。このオペレーションは、メンバー属性 (ATR)、PDex プロバイダーアクセス、Payer-to-Payer、メンバーアクセス APIs など、複数のエクスポートタイプをサポートしています。これは、DaVinci 実装ガイドの要件を満たすように設計された、標準の FHIR `$export`オペレーションの特殊なバージョンです。 ## 主な機能 + *非同期処理*: 標準の FHIR 非同期リクエストパターンに従います + *グループレベルのエクスポート*: 特定のグループリソース内のメンバーのデータをエクスポートします。 + *複数のエクスポートタイプ*: ATR (メンバー属性）、PDex プロバイダーアクセス、Payer-to-Payer、メンバーアクセス APIsをサポート + *包括的なプロファイルのサポート*: US Core、CARIN Blue ボタン、PDex プロファイルが含まれます + *柔軟なフィルタリング*: 患者、リソースタイプ、時間範囲によるフィルタリングをサポート + *NDJSON 出力*: データを改行区切りの JSON 形式で提供します ## オペレーションエンドポイント ``` GET [base]/Group/[id]/$davinci-data-export POST [base]/Group/[id]/$davinci-data-export ``` ## リクエストパラメーター | パラメータ | カーディナリティ | 説明 | | --- | --- | --- | | patient | 0..\$1 | エクスポートするデータを持つ特定のメンバー。省略すると、グループ内のすべてのメンバーがエクスポートされます。 | | \$1type | 0..1 | エクスポートする FHIR リソースタイプのカンマ区切りリスト。 | | \$1since | 0..1 | この日時以降に更新されたリソースのみを含めます。 | | \$1until | 0..1 | この日時より前に更新されたリソースのみを含めます。 | | exportType | 0..1 | 実行するエクスポートのタイプ。有効な値は、hl7.fhir.us.davinci-atr、hl7.fhir.us.davinci-pdex、hl7.fhir.us.davinci-pdex.p2p、hl7.fhir.us.davinci-pdex.member です。デフォルト: hl7.fhir.us.davinci-atr。 | | \$1includeEOB2xWoFinancial | 0..1 | 財務データが削除された CARIN BB 2.x ExplanationOfBenefit リソースを含めるかどうかを指定します。デフォルト: false。 | ### サポートされているリソースタイプ サポートされているリソースタイプは、指定したエクスポートタイプによって異なります。ATR エクスポートでは、次のリソースタイプがサポートされています。 + `Group` + `Patient` + `Coverage` + `RelatedPerson` + `Practitioner` + `PractitionerRole` + `Organization` + `Location` PDex エクスポート (プロバイダーアクセス、Payer-to-Payer、メンバーアクセス) では、前述のタイプに加えて、すべての臨床リソースタイプとクレームリソースタイプがサポートされています。サポートされているリソースタイプの詳細なリストについては、[US Core Implementation Guide (STU 6.1)](https://hl7.org/fhir/us/core/STU6.1/)、[CARIN Blue Button Implementation Guide](https://hl7.org/fhir/us/carin-bb/)、[Da Vinci Prior Authorization Support Implementation Guide](https://hl7.org/fhir/us/davinci-pas/) を参照してください。 ## エクスポートタイプ `$davinci-data-export` オペレーションでは、次のエクスポートタイプがサポートされています。エクスポートタイプは、 `exportType`パラメータを使用して指定します。 | エクスポートタイプ | 目的 | データスコープ | 一時的な制限 | | --- | --- | --- | --- | | hl7.fhir.us.davinci-atr | メンバー属性リスト | 属性関連のリソース | なし | | hl7.fhir.us.davinci-pdex | プロバイダーアクセス API | 属性患者の臨床データとクレームデータ | 5 年 | | hl7.fhir.us.davinci-pdex.p2p | Payer-to-Payer Exchange | 保険移行の履歴メンバーデータ | 5 年 | | hl7.fhir.us.davinci-pdex.member | メンバーアクセス API | メンバー自身のヘルスデータ | 5 年 | **注記** PDex エクスポートの場合、5 年間の時間制限は ATR リソースタイプ (`Group`、`Patient`、、`Coverage`、、、`RelatedPerson``Practitioner``PractitionerRole`、`Organization`) には適用されません`Location`。これらのリソースは、年齢に関係なく常に含まれます。 ### ATR (hl7.fhir.us.davinci-atr) ATR エクスポートタイプを使用すると、メンバー属性リストデータをエクスポートできます。このエクスポートタイプを使用して、グループ内のメンバーの属性関連のリソースを取得します。詳細については、[「Da Vinci ATR Export Operation](https://build.fhir.org/ig/HL7/davinci-atr/OperationDefinition-davinci-data-export.html)」を参照してください。 サポートされているリソースタイプ `Group`, `Patient`, `Coverage`, `RelatedPerson`, `Practitioner`, `PractitionerRole`, `Organization`, `Location` 一時フィルタリング 一時的なフィルタリングは適用されません。一致するすべてのリソースは、日付に関係なくエクスポートされます。 ### PDex エクスポートタイプ すべての PDex エクスポートタイプは、サポートされている同じプロファイルとフィルタリングロジックを共有します。詳細については、[「Da Vinci PDex Provider Access API](https://build.fhir.org/ig/HL7/davinci-epdx/provider-access-api.html)」を参照してください。次のプロファイルがサポートされています。 + US Core 3.1.1、6.1.0、および 7.0.0 + PDex 事前認可 (メンバーアクセスではサポートされていません) + CARIN BB 2.x ベースプロファイル: 入院患者用、入院患者用、専門のNonClinician、口腔用、治療用 プロバイダーアクセス (`hl7.fhir.us.davinci-pdex`) ネットワーク内プロバイダーが属性患者の患者データを取得できるようにします。 Payer-to-Payer (`hl7.fhir.us.davinci-pdex.p2p`) 患者が保険を変更するときに、支払者間のデータ交換を有効にします。 メンバーアクセス (`hl7.fhir.us.davinci-pdex.member`) メンバーが自分のヘルスデータにアクセスできるようにします。このエクスポートタイプには、クレームリソースに財務データが含まれる場合があります。 ## プロファイルのサポートと包含ロジック PDex エクスポートの場合、 `$davinci-data-export`オペレーションは `meta.profile`要素のプロファイル宣言を使用して、エクスポートに含めるリソースを決定します。 ### ExplanationOfBenefit リソース処理 `ExplanationOfBenefit` (EOB) リソースは、`meta.profile`宣言に基づいて PDex エクスポートに含まれるか除外されます。 + CARIN BB 1.x プロファイルを持つ ExplanationOfBenefit リソースはエクスポートから除外されます。 + `meta.profile` 設定されていない ExplanationOfBenefit リソースはエクスポートから除外されます。 + CARIN BB 2.x Basis プロファイルを持つ ExplanationOfBenefit リソースは常に含まれます。 + 財務データを含む CARIN BB 2.x プロファイルを持つ ExplanationOfBenefit リソースは、デフォルトで除外されます。`_includeEOB2xWoFinancial=true` を設定すると、それらは削除された財務データに含まれ、リソースは対応する Basis プロファイルに変換されます。 + PDex 事前認可プロファイルを持つ ExplanationOfBenefit リソースは常に含まれます。 ### 財務データ変換 を設定すると`_includeEOB2xWoFinancial=true`、オペレーションは財務データを削除して [CARIN BB 2.x](https://hl7.org/fhir/us/carin-bb/) ExplanationOfBenefit リソースを対応する Basis プロファイルに変換します。たとえば、`C4BB ExplanationOfBenefit Oral`リソースは に変換され`C4BB ExplanationOfBenefit Oral Basis`、FHIR 仕様に従ってレコードから財務データが削除されます。 変換中は、次の財務データ要素が削除されます。 + `total` 要素のすべてのスライス + `amounttype` スライスを含むすべての`adjudication`要素 + 金額情報を含むすべての`item.adjudication`要素 このオペレーションは、変換中にプロファイルメタデータも更新します。 + `meta.profile` が Basis プロファイルの正規 URL に更新されました + バージョンが CARIN BB 2.x Basis バージョンに更新されました + データストア内の既存のリソースは変更されません + エクスポートされたリソースはデータストアに保持されません ### プロファイル検出ルール オペレーションでは、次のルールを使用してプロファイルを検出および検証します。 + バージョン検出は`meta.profile`正規 URLsに基づいています + 宣言されたプロファイルのいずれかがエクスポート基準に一致する場合、リソースが含まれます。 + プロファイルの検証はエクスポート処理中に行われます ## PDex エクスポートの 5 年間の一時フィルタリング すべての PDex エクスポートタイプについて、HealthLake はリソースが最後に更新された日時に基づいて 5 年間の時間フィルターを適用します。時間フィルターは、経過時間に関係なく常にエクスポートされる次のコア属性リソースタイプを除くすべてのリソースに適用されます。 + `Patient` + `Coverage` + `Organization` + `Practitioner` + `PractitionerRole` + `RelatedPerson` + `Location` + `Group` これらの管理リソースと属性リソースは、エクスポートされたデータに不可欠なコンテキストを提供するため、除外されます。ATR エクスポートは一時的なフィルタリングの対象ではありません。 ## リクエスト例 次の例は、さまざまなエクスポートタイプのエクスポートジョブを開始する方法を示しています。 *ATR エクスポート* ``` GET https://healthlake.{region}.amazonaws.com/datastore/{datastoreId}/r4/Group/example-group/$davinci-data-export?_type=Group,Patient,Coverage,Practitioner,Organization&exportType=hl7.fhir.us.davinci-atr POST https://healthlake.{region}.amazonaws.com/datastore/{datastoreId}/r4/Group/example-group/$davinci-data-export?_type=Group,Patient,Coverage,Practitioner,Organization&exportType=hl7.fhir.us.davinci-atr Content-Type: application/json { "DataAccessRoleArn": "arn:aws:iam::444455556666:role/your-healthlake-service-role", "JobName": "attribution-export-job", "OutputDataConfig": { "S3Configuration": { "S3Uri": "s3://your-export-bucket/EXPORT-JOB", "KmsKeyId": "arn:aws:kms:region:444455556666:key/1234abcd-12ab-34cd-56ef-1234567890ab" } } } ``` *ExplanationOfBenefit 財務データの削除によるプロバイダーアクセスのエクスポート* ``` GET https://healthlake.{region}.amazonaws.com/datastore/{datastoreId}/r4/Group/example-group/$davinci-data-export?_type=Patient,Observation,Condition,MedicationRequest,ExplanationOfBenefit&exportType=hl7.fhir.us.davinci-pdex&_includeEOB2xWoFinancial=true ``` *Payer-to-Payer エクスポート* ``` GET https://healthlake.{region}.amazonaws.com/datastore/{datastoreId}/r4/Group/example-group/$davinci-data-export?_type=Patient,Coverage,ExplanationOfBenefit,Condition,Procedure&exportType=hl7.fhir.us.davinci-pdex.p2p&_includeEOB2xWoFinancial=true ``` *特定の患者のメンバーアクセスエクスポート* ``` GET https://healthlake.{region}.amazonaws.com/datastore/{datastoreId}/r4/Group/example-group/$davinci-data-export?_type=Patient,Observation,Condition,ExplanationOfBenefit,MedicationRequest&exportType=hl7.fhir.us.davinci-pdex.member&patient=Patient/example-patient-id ``` ## レスポンス例 ``` { "datastoreId": "eaee622d8406b41eb86c0f4741201ff9", "jobStatus": "SUBMITTED", "jobId": "48d7b91dae4a64d00d54b70862f33f61" } ``` ## リソース関係 オペレーションは、メンバー属性リスト内の関係に基づいてリソースをエクスポートします。 ``` Group (Attribution List) ├── Patient (Members) ├── Coverage → RelatedPerson (Subscribers) ├── Practitioner (Attributed Providers) ├── PractitionerRole → Location └── Organization (Attributed Providers) ``` ### リソースソース | [リソース] | ソースの場所 | 説明 | | --- | --- | --- | | Patient | Group.member.entity | 属性リストのメンバーである患者 | | Coverage | Group.member.extension:coverageReference | 患者メンバーシップにつながるカバレッジ | | Organization | Group.member.extension:attributedProvider | 患者が属する組織 | | Practitioner | Group.member.extension:attributedProvider | 患者が属する個々の実務者 | | PractitionerRole | Group.member.extension:attributedProvider | 患者が属するプラクティショナーロール | | RelatedPerson | Coverage.subscriber | カバレッジのサブスクライバー | | Location | PractitionerRole.location | プラクティショナーロールに関連付けられた場所 | | Group | 入力エンドポイント | 属性リスト自体 | ## ジョブ管理 ジョブのステータスを確認する `GET [base]/export/[job-id]` ジョブをキャンセルする `DELETE [base]/export/[job-id]` ### ジョブのライフサイクル + `SUBMITTED` - ジョブが受信およびキューに入れられました + `IN_PROGRESS` - ジョブはアクティブに処理中です + `COMPLETED` - ジョブが正常に終了し、ダウンロード可能なファイル + `FAILED` - ジョブでエラーが発生しました ## [Output Format] (出力形式) + *ファイル形式*: NDJSON (Newline Delimited JSON) + *File Organization*: リソースタイプごとにファイルを区切ります。 + *ファイル拡張*子: .ndjson + *場所*: 指定された S3 バケットとパス ## エラー処理 オペレーションは、以下の条件で HTTP 400 Bad Request with an OperationOutcome を返します。 認可エラー で指定された IAM ロールには、エクスポートオペレーションを実行するための十分なアクセス許可`DataAccessRoleArn`がありません。必要な S3 および KMS アクセス許可の完全なリストについては、[「エクスポートジョブのアクセス許可の設定](getting-started-setting-up.md#setting-up-export-permissions)」を参照してください。 パラメータ検証エラー + `patient` パラメータは としてフォーマットされていません `Patient/id,Patient/id,...` + 1 つ以上の患者参照が無効であるか、指定されたグループに属していません + `exportType` パラメータ値はサポートされているエクスポートタイプではありません + `_type` パラメータには、指定されたエクスポートタイプでサポートされていないリソースタイプが含まれています + `_type` パラメータに`hl7.fhir.us.davinci-atr`エクスポートタイプに必要なリソースタイプ (`Group`、`Patient`、`Coverage`) がありません + `_includeEOB2xWoFinancial` パラメータ値が有効なブール値ではありません リソース検証エラー + 指定されたグループリソースがデータストアに存在しません + 指定されたグループリソースにはメンバーがありません + 1 人以上のグループメンバーが、データストアに存在しない患者リソースを参照する ## セキュリティと認可 + 標準の FHIR 認可メカニズムが適用されます + データアクセスロールには、S3 および KMS オペレーションに必要な IAM アクセス許可が必要です。必要なアクセス許可の完全なリストについては、[「エクスポートジョブのアクセス許可の設定](getting-started-setting-up.md#setting-up-export-permissions)」を参照してください。 ## ベストプラクティス + *リソースタイプの選択*: エクスポートサイズと処理時間を最小限に抑えるために必要なリソースタイプのみをリクエストする + *時間ベースのフィルタリング*: 増分エクスポートに `_since`パラメータを使用する + *患者のフィルタリング*: 特定のメンバーのデータのみが必要な場合は、 `patient`パラメータを使用します。 + *ジョブのモニタリング*: 大規模なエクスポートのジョブステータスを定期的にチェックする + *エラー処理*: 失敗したジョブに適切な再試行ロジックを実装する + *テンポラルフィルターの認識*: PDex エクスポートの場合は、リソースタイプを選択するときに 5 年間のテンポラルフィルターを検討してください。 + *財務データの削除*: 財務情報のないクレームデータ`_includeEOB2xWoFinancial=true`が必要な場合に使用します。 + *プロファイル管理*: リソースに適切なプロファイル宣言があることを確認し、取り込み前にターゲットプロファイルと照合して検証し、プロファイルのバージョニングを使用してエクスポート動作を制御します。 ## 制限事項 + `patient` パラメータでは最大 500 人の患者を指定できます + エクスポートはグループレベルのオペレーションのみに制限されます + は、エクスポートタイプごとに事前定義されたリソースタイプのセットのみをサポートします。 + 出力は常に NDJSON 形式です + PDex のエクスポートは、5 年間の臨床データとクレームデータに制限されます。 + 財務データ変換は、CARIN BB 2.x ExplanationOfBenefit プロファイルにのみ適用されます。 ## その他のリソース + [Da Vinci メンバー属性リスト IG](https://build.fhir.org/ig/HL7/davinci-atr/) + [Da Vinci Payer Data Exchange IG](https://hl7.org/fhir/us/davinci-pdex/) + [CARIN コンシューマー向け支払者データ交換 IG](https://build.fhir.org/ig/HL7/carin-bb/) + [US Core 実装ガイド](https://www.hl7.org/fhir/us/core/) + [FHIR バルクデータアクセス仕様](https://hl7.org/fhir/uv/bulkdata/)