기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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 내보내기(Provider Access, Payer-to-Payer, Member Access)의 경우 이전 유형 외에도 모든 임상 및 클레임 리소스 유형이 지원됩니다. 지원되는 리소스 유형의 전체 목록은 US Core 구현 가이드(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 Provider Access API를 참조하세요. 지원되는 프로필은 다음과 같습니다.

프로필 지원 및 포함 로직

PDex 내보내기의 경우 $davinci-data-export 작업은 meta.profile 요소의 프로파일 선언을 사용하여 내보내기에 포함할 리소스를 결정합니다.

ExplanationOfBenefit 리소스 처리

ExplanationOfBenefit (EOB) 리소스는 meta.profile 선언에 따라 PDex 내보내기에 포함되거나 제외됩니다.

재무 데이터 변환

_includeEOB2xWoFinancial=true를 설정하면 작업은 금융 데이터를 제거하여 CARIN BB 2.x ExplanationOfBenefit 리소스를 해당 기본 프로필로 변환합니다. 예를 들어 C4BB ExplanationOfBenefit Oral 리소스는 FHIR 사양에 따라 레코드에서 금융 데이터를 C4BB ExplanationOfBenefit Oral Basis제거하는 로 변환됩니다.

변환 중에 다음 금융 데이터 요소가 제거됩니다.

작업은 변환 중에 프로필 메타데이터도 업데이트합니다.

프로필 감지 규칙

작업은 다음 규칙을 사용하여 프로파일을 감지하고 검증합니다.

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)

리소스 소스

작업 관리

작업 수명 주기

출력 형식

오류 처리

작업은 다음 조건에 대해 OperationOutcome과 함께 HTTP 400 잘못된 요청을 반환합니다.

보안 및 권한 부여

모범 사례

제한 사항

추가 리소스