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

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 エクスポートの場合、 グループの患者ごとに臨床リソースとクレームリソースが自動的に検出されます。グループリソースでこれらのリソースを明示的に参照する必要はありません。オペレーションは、属性化された患者に属するすべての患者セグメントリソース (Observation、Condition、CoverageRelatedPerson、MedicationRequest、、 などExplanationOfBenefit) を検索します。Patient、Group、およびnon-patient-compartment ATR タイプ (Practitioner、PractitionerRole、Organization、Location) のみが、 グループで明示的な参照を必要とします。

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

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 仕様に従ってレコードから財務データが削除されます。

オペレーションは、次の 2 つのシナリオで財務データ要素を削除します。CARIN BB 2.x Financial リソースを Basis プロファイルに変換する場合 ( を使用_includeEOB2xWoFinancial=true)、および CARIN BB 2.x Basis リソースから残余財務データを削除する場合。

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

プロファイル検出ルール

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

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

HealthLake は、Payer-to-Payer (hl7.fhir.us.davinci-pdex.p2p) およびメンバーアクセス (hl7.fhir.us.davinci-pdex.member) のエクスポートタイプに 5 年間の一時フィルターを適用します。フィルターは、リソースが最後に更新された日時に基づきます。プロバイダーアクセスのエクスポートタイプ (hl7.fhir.us.davinci-pdex および hl7.fhir.us.davinci-pdex#provider-snapshot) には時間制限はありません。時間的に制限されたエクスポートタイプの場合、フィルターは、経過時間に関係なく常にエクスポートされる次のコア属性リソースタイプを除くすべてのリソースに適用されます。

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

プロバイダーアクセススナップショットのエクスポート

GET https://healthlake.{region}.amazonaws.com/datastore/{datastoreId}/r4/Group/example-group/$davinci-data-export?exportType=hl7.fhir.us.davinci-pdex%23provider-snapshot

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 を返します。

セキュリティと認可

$davinci-data-export は、IAM アクセス許可またはシステムレベルの SMART on FHIR (OAuth 2.0) スコープを通じて承認されたバックエンド一括オペレーションです。患者レベルまたはユーザーレベルのスコープを提示するリクエストは拒否されます。オペレーションでは、エクスポートされたデータをフィルタリングまたは制限するための FHIR 同意リソースは評価されません。

ベストプラクティス

制限事項

その他のリソース