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

HealthLake の FHIR R4 $davinci-data-exportオペレーション

$davinci-data-export オペレーションは、医療データのエクスポートに使用できる非同期 FHIR オペレーションです AWS HealthLake。このオペレーションは、メンバー属性 (ATR)、PDex プロバイダーアクセス、Payer-to-Payer、メンバーアクセス APIs など、複数のエクスポートタイプをサポートしています。これは、DaVinci 実装ガイドの要件を満たすように設計された、標準の FHIR $exportオペレーションの特殊なバージョンです。

主な機能

オペレーションエンドポイント

GET [base]/Group/[id]/$davinci-data-export
POST [base]/Group/[id]/$davinci-data-export

リクエストパラメーター

サポートされているリソースタイプ

サポートされているリソースタイプは、指定したエクスポートタイプによって異なります。ATR エクスポートでは、次のリソースタイプがサポートされています。

PDex エクスポート (プロバイダーアクセス、Payer-to-Payer、メンバーアクセス) では、前述のタイプに加えて、すべての臨床リソースタイプとクレームリソースタイプがサポートされています。サポートされているリソースタイプの詳細なリストについては、US Core Implementation Guide (STU 6.1)、CARIN Blue Button Implementation Guide、Da Vinci Prior Authorization Support Implementation Guide を参照してください。

エクスポートタイプ

$davinci-data-export オペレーションでは、次のエクスポートタイプがサポートされています。エクスポートタイプは、 exportTypeパラメータを使用して指定します。

ATR (hl7.fhir.us.davinci-atr)

ATR エクスポートタイプを使用すると、メンバー属性リストデータをエクスポートできます。このエクスポートタイプを使用して、グループ内のメンバーの属性関連のリソースを取得します。詳細については、「Da Vinci ATR Export Operation」を参照してください。

PDex エクスポートタイプ

すべての PDex エクスポートタイプは、サポートされている同じプロファイルとフィルタリングロジックを共有します。詳細については、「Da Vinci PDex Provider Access API」を参照してください。次のプロファイルがサポートされています。

プロファイルのサポートと包含ロジック

PDex エクスポートの場合、 $davinci-data-exportオペレーションは meta.profile要素のプロファイル宣言を使用して、エクスポートに含めるリソースを決定します。

ExplanationOfBenefit リソース処理

ExplanationOfBenefit (EOB) リソースは、meta.profile宣言に基づいて PDex エクスポートに含まれるか除外されます。

財務データ変換

を設定すると_includeEOB2xWoFinancial=true、オペレーションは財務データを削除して CARIN BB 2.x ExplanationOfBenefit リソースを対応する Basis プロファイルに変換します。たとえば、C4BB ExplanationOfBenefit Oralリソースは に変換されC4BB ExplanationOfBenefit Oral Basis、FHIR 仕様に従ってレコードから財務データが削除されます。

変換中は、次の財務データ要素が削除されます。

このオペレーションは、変換中にプロファイルメタデータも更新します。

プロファイル検出ルール

オペレーションでは、次のルールを使用してプロファイルを検出および検証します。

PDex エクスポートの 5 年間の一時フィルタリング

すべての PDex エクスポートタイプについて、HealthLake はリソースが最後に更新された日時に基づいて 5 年間の時間フィルターを適用します。時間フィルターは、経過時間に関係なく常にエクスポートされる次のコア属性リソースタイプを除くすべてのリソースに適用されます。

これらの管理リソースと属性リソースは、エクスポートされたデータに不可欠なコンテキストを提供するため、除外されます。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)

リソースソース

ジョブ管理

ジョブのライフサイクル

[Output Format] (出力形式)

エラー処理

オペレーションは、以下の条件で HTTP 400 Bad Request with an OperationOutcome を返します。

セキュリティと認可

ベストプラクティス

制限事項

その他のリソース