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

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 匯出，會自動為群組中的每個病患探索臨床和宣告資源。您不需要在群組資源中明確參考這些資源。操作會搜尋屬於歸屬病患的所有病患室資源 Condition Coverage（例如 Observation、MedicationRequest、、RelatedPerson、 和 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 規格從記錄分割財務資料。

在兩種情況下，此操作會移除下列財務資料元素：當它將 CARIN BB 2.x 財務資源轉換為其 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 年的時間篩選條件。篩選條件是根據資源上次更新的時間。Provider Access 匯出類型 (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)

資源來源

任務管理

任務生命週期

輸出格式

錯誤處理

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

安全性和授權

$davinci-data-export 是一種後端大量操作，透過 IAM 許可或 FHIR (OAuth 2.0) 範圍上的系統層級 SMART 授權；表示患者層級或使用者層級範圍的請求會遭到拒絕。此操作不會評估 FHIR 同意資源來篩選或限制匯出的資料。

最佳實務

限制

其他資源