本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

FHIR R4 $ davinci-data-export 操作用于 HealthLake

该$davinci-data-export操作是一种异步 FHIR 操作，可用于从中 AWS HealthLake导出医疗保健数据。此操作支持多种导出类型，包括成员归因 (ATR)、PDEx 提供商访问和成员访问 API。 Payer-to-Payer它是标准 FHIR $export 操作的专用版本，旨在满足 DaVinci 实施指南的要求。

主要功能

操作终端节点

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

请求参数

支持的资源类型

支持的资源类型取决于您指定的导出类型。对于 ATR 导出，支持以下资源类型：

对于 PDeX 导出（提供者访问权限和成员访问权限），除了上述类型外，还支持所有临床和索赔资源类型。 Payer-to-Payer有关支持的资源类型的完整列表，请参阅《美国核心实施指南》(STU 6.1)、《C ARIN Blue Button 实施指南》和《达芬奇事先授权支持实施指南》。

导出类型

该$davinci-data-export操作支持以下导出类型。您可以使用exportType参数指定导出类型。

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

使用 ATR 导出类型，您可以导出成员归因列表数据。使用此导出类型为群组中的成员检索与归因相关的资源。欲了解更多信息，请参阅达芬奇 ATR 出口业务。

PDex 导出类型

所有 PDex 导出类型都使用相同的支持的配置文件和筛选逻辑。欲了解更多信息，请参阅 Da Vinci PDeX 提供商访问 API。支持以下配置文件：

对于PDeX的出口，系统会自动发现集团中每位患者的临床和理赔资源。您无需在组资源中明确引用这些资源。该手术会搜索属于归因患者的所有患者隔间资源（例如ObservationConditionCoverageRelatedPersonMedicationRequest、、、、和ExplanationOfBenefit）。只有Patient、Group、和非患者隔间 ATR 类型（Practitioner、、PractitionerRoleOrganization、Location）需要在组中明确引用。

个人资料 Support 和包含逻辑

对于 PDex 导出，该$davinci-data-export操作使用meta.profile元素中的配置文件声明来确定要在导出中包含哪些资源。

ExplanationOfBenefit 资源处理

ExplanationOfBenefit(EOB) 资源根据申报被纳入或排除在PDeX出口之外：meta.profile

财务数据转换

设置后_includeEOB2xWoFinancial=true，该操作会通过删除财务数据将 CARIN BB 2.x ExplanationOfBenefit 资源转换为相应的 Basis 配置文件。例如，将C4BB ExplanationOfBenefit Oral资源转换为C4BB ExplanationOfBenefit Oral Basis，这会根据 FHIR 规范从记录中删除财务数据。

该操作在两种情况下会删除以下财务数据元素：当它将CARIN BB 2.x财务资源转换为其基本配置文件时（使用_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)

资源来源

Job 管理

作业生命周期

输出格式

错误处理

如果出现以下情况，该操作会返回 HTTP 400 错误请求： OperationOutcome

安全和授权

$davinci-data-export是通过 IAM 权限或系统级 SMART 在 FHIR (OAuth 2.0) 范围内授权的后端批量操作；呈现患者级或用户级范围的请求将被拒绝。该操作不会评估 FHIR 同意资源来筛选或限制导出的数据。

最佳实践

限制

其他资源