本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

HealthLake 的 FHIR R4 $davinci-data-export操作

$davinci-data-export 操作是一種非同步 FHIR 操作，可用來從中匯出醫療保健資料 AWS HealthLake。此操作支援多種匯出類型，包括成員屬性 (ATR)、PDex 提供者存取、Payer-to-Payer和成員存取 APIs。它是標準 FHIR $export操作的特殊版本，旨在符合 DaVinci 實作指南的要求。

主要功能

操作端點

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

請求參數

支援的資源類型

支援的資源類型取決於您指定的匯出類型。對於 ATR 匯出，支援下列資源類型：

對於 PDex 匯出 (Provider Access、Payer-to-Payer 和 Member Access)，除了上述類型之外，還支援所有臨床和宣告資源類型。如需支援資源類型的完整清單，請參閱美國核心實作指南 (STU 6.1)、CARIN 藍色按鈕實作指南，以及 Da Vinci 預先授權支援實作指南。

匯出類型

$davinci-data-export 操作支援下列匯出類型。您可以使用 exportType 參數指定匯出類型。

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

使用 ATR 匯出類型，您可以匯出成員屬性清單資料。使用此匯出類型來擷取群組內成員的屬性相關資源。如需詳細資訊，請參閱 Da Vinci ATR 匯出操作。

PDex 匯出類型

所有 PDex 匯出類型共用相同的支援設定檔和篩選邏輯。如需詳細資訊，請參閱 Da Vinci PDex 提供者存取 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 匯出的五年時間篩選

對於所有 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)

資源來源

任務管理

任務生命週期

輸出格式

錯誤處理

針對下列情況， 操作會傳回 HTTP 400 錯誤請求與 OperationOutcome：

安全性和授權

最佳實務

限制

其他資源