기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # HealthLake에 대한 FHIR R4 `$davinci-data-export` 작업 `$davinci-data-export` 작업은 의료 데이터를 내보내는 데 사용할 수 있는 비동기식 FHIR 작업입니다 AWS HealthLake. 이 작업은 멤버 속성(ATR), PDex 공급자 액세스, Payer-to-Payer 및 멤버 액세스 APIs 비롯한 여러 내보내기 유형을 지원합니다. DaVinci 구현 가이드의 요구 사항을 충족하도록 설계된 표준 FHIR `$export` 작업의 특수 버전입니다. ## 주요 기능 + *비동기 처리*: 표준 FHIR 비동기 요청 패턴을 따릅니다. + *그룹 수준 내보내기*: 특정 그룹 리소스 내의 멤버에 대한 데이터를 내보냅니다. + *여러 내보내기 유형*: ATR(멤버 속성), PDex 공급자 액세스, Payer-to-Payer 및 멤버 액세스 APIs 지원 + *포괄적인 프로필 지원*: 미국 코어, CARIN 블루 버튼 및 PDex 프로필 포함 + *유연한 필터링*: 환자, 리소스 유형 및 시간 범위별 필터링 지원 + *NDJSON 출력*: 줄 바꿈으로 구분된 JSON 형식으로 데이터를 제공합니다. ## 작업 엔드포인트 ``` GET [base]/Group/[id]/$davinci-data-export POST [base]/Group/[id]/$davinci-data-export ``` ## 요청 파라미터 | 파라미터 | 카디널리티 | 설명 | | --- | --- | --- | | patient | 0..\* | 내보낼 데이터가 있는 특정 멤버입니다. 생략하면 그룹의 모든 멤버가 내보내집니다. | | \_type | 0..1 | 내보낼 FHIR 리소스 유형의 쉼표로 구분된 목록입니다. 생략하면 지정된 내보내기 유형에 대해 지원되는 모든 리소스 유형이 포함됩니다. ATR 내보내기의 경우 기본값은 8개의 어트리뷰션 리소스 유형입니다. PDex 내보내기의 경우 여기에는 모든 어트리뷰션 리소스 유형과 US Core, CARIN 블루 버튼 및 PDex 프로파일의 임상 및 클레임 리소스 유형이 포함됩니다. | | \_since | 0..1 | 이 날짜 및 시간 이후에 업데이트된 리소스만 포함합니다. | | \_until | 0..1 | 이 날짜 및 시간 이전에 업데이트된 리소스만 포함합니다. | | exportType | 0..1 | 수행할 내보내기 유형입니다. 유효한 값: hl7.fhir.us.davinci-atr, hl7.fhir.us.davinci-pdex, hl7.fhir.us.davinci-pdex.p2p, hl7.fhir.us.davinci-pdex.member. 기본값: hl7.fhir.us.davinci-atr. | | \_includeEOB2xWoFinancial | 0..1 | 금융 데이터가 제거된 상태에서 CARIN BB 2.x ExplanationOfBenefit 리소스를 포함할지 여부를 지정합니다. 기본값: false. | | \_security | 0..\* | 내보낸 리소스를 meta.security 코딩 값으로 필터링합니다. system\|code 형식을 사용합니다(파이프 문자는 URL로 인코딩되어야 함%7C). 여러 값이 제공되면 리소스는 모든 값과 일치해야 합니다(AND 의미 체계). system\| (후행 파이프, 코드 없음)를 사용하여 지정된 시스템의 모든 코드를 일치시킵니다. | | \_tag | 0..\* | 내보낸 리소스를 meta.tag 코딩 값으로 필터링합니다. 와 동일한 system\|code 형식 및 AND 시맨틱을 사용합니다\_security. \_security 및를 모두 지정하면 리소스\_tag가 두 필터와 일치해야 합니다. | ### 지원되는 리소스 유형 지원되는 리소스 유형은 지정한 내보내기 유형에 따라 다릅니다. ATR 내보내기의 경우 다음 리소스 유형이 지원됩니다. + `Group` + `Patient` + `Coverage` + `RelatedPerson` + `Practitioner` + `PractitionerRole` + `Organization` + `Location` PDex 내보내기(공급자 액세스, Payer-to-Payer 및 멤버 액세스)의 경우 이전 유형 외에도 모든 임상 및 클레임 리소스 유형이 지원됩니다. 지원되는 리소스 유형의 전체 목록은 [US Core 구현 가이드(STU 6.1),](https://hl7.org/fhir/us/core/STU6.1/) [CARIN 블루 버튼 구현 가이드](https://hl7.org/fhir/us/carin-bb/) 및 [Da Vinci 사전 승인 지원 구현 가이드를](https://hl7.org/fhir/us/davinci-pas/) 참조하세요. ## 내보내기 유형 `$davinci-data-export` 작업은 다음 내보내기 유형을 지원합니다. `exportType` 파라미터를 사용하여 내보내기 유형을 지정합니다. | 내보내기 유형 | 용도 | 데이터 범위 | 시간 제한 | | --- | --- | --- | --- | | hl7.fhir.us.davinci-atr | 멤버 속성 목록 | 속성 관련 리소스 | 없음 | | hl7.fhir.us.davinci-pdex | 공급자 액세스 API | 귀속된 환자의 임상 및 클레임 데이터 | 5년 | | hl7.fhir.us.davinci-pdex.p2p | Payer-to-Payer 교환 | 보험 전환을 위한 과거 멤버 데이터 | 5년 | | hl7.fhir.us.davinci-pdex.member | 멤버 액세스 API | 멤버의 자체 상태 데이터 | 5년 | **참고** PDex 내보내기의 경우 ATR 리소스 유형(, , `Group`, `Patient`, `Coverage`, `Practitioner`, `RelatedPerson``PractitionerRole`, `Organization`)에는 5년 시간 제한이 적용되지 않습니다`Location`. 이러한 리소스는 연령에 관계없이 항상 포함됩니다. ### ATR(hl7.fhir.us.davinci-atr) ATR 내보내기 유형을 사용하면 멤버 속성 목록 데이터를 내보낼 수 있습니다. 이 내보내기 유형을 사용하여 그룹 내 멤버의 어트리뷰션 관련 리소스를 검색합니다. 자세한 내용은 [Da Vinci ATR 내보내기 작업을](https://build.fhir.org/ig/HL7/davinci-atr/OperationDefinition-davinci-data-export.html) 참조하세요. 지원되는 리소스 유형 `Group`, `Patient`, `Coverage`, `RelatedPerson`, `Practitioner`, `PractitionerRole`, `Organization`, `Location` 임시 필터링 시간 필터링은 적용되지 않습니다. 일치하는 모든 리소스는 날짜와 관계없이 내보내집니다. ### PDex 내보내기 유형 모든 PDex 내보내기 유형은 지원되는 동일한 프로필과 필터링 로직을 공유합니다. 자세한 내용은 [Da Vinci PDex Provider Access API](https://build.fhir.org/ig/HL7/davinci-epdx/provider-access-api.html)를 참조하세요. 지원되는 프로필은 다음과 같습니다. + US Core 3.1.1, 6.1.0 및 7.0.0 + PDex 사전 승인(멤버 액세스에는 지원되지 않음) + CARIN BB 2.x 기본 프로필: 입원 환자 기관, 외래 환자 기관, 전문 NonClinician, 구두, 기관 PDex 내보내기의 경우 그룹의 각 환자마다 임상 및 클레임 리소스가 자동으로 검색됩니다. 그룹 리소스에서 이러한 리소스를 명시적으로 참조할 필요는 없습니다. 작업은 귀속된 환자의 모든 환자 구획 리소스(예: `Observation`, `Condition`, `Coverage`, `MedicationRequest`, `RelatedPerson`, `ExplanationOfBenefit`)를 검색합니다. `Patient`, `Group`및 non-patient-compartment ATR 유형(`Practitioner`, `PractitionerRole`, `Organization`, `Location`)만 그룹에서 명시적 참조가 필요합니다. 공급자 액세스(`hl7.fhir.us.davinci-pdex`) 네트워크 내 공급자가 귀속된 환자의 환자 데이터를 검색할 수 있습니다. Payer-to-Payer(`hl7.fhir.us.davinci-pdex.p2p`) 환자가 보험을 변경할 때 지급인 간의 데이터 교환을 활성화합니다. 멤버 액세스(`hl7.fhir.us.davinci-pdex.member`) 멤버가 자신의 상태 데이터에 액세스할 수 있습니다. 이 내보내기 유형에는 클레임 리소스의 금융 데이터가 포함될 수 있습니다. ## 프로필 지원 및 포함 로직 PDex 내보내기의 경우 `$davinci-data-export` 작업은 `meta.profile` 요소의 프로파일 선언을 사용하여 내보내기에 포함할 리소스를 결정합니다. ### ExplanationOfBenefit 리소스 처리 `ExplanationOfBenefit` (EOB) 리소스는 `meta.profile` 선언에 따라 PDex 내보내기에 포함되거나 제외됩니다. + CARIN BB 1.x 프로파일이 있는 ExplanationOfBenefit 리소스는 내보내기에서 제외됩니다. + `meta.profile` 집합이 없는 ExplanationOfBenefit 리소스는 내보내기에서 제외됩니다. + CARIN BB 2.x 기본 프로필이 있는 ExplanationOfBenefit 리소스는 항상 포함됩니다. + 금융 데이터가 포함된 CARIN BB 2.x 프로필이 있는 ExplanationOfBenefit 리소스는 기본적으로 제외됩니다. `_includeEOB2xWoFinancial=true`이 설정되면 재무 데이터가 제거된 상태로 포함되고 리소스가 해당 기본 프로필로 변환됩니다. + PDex 사전 승인 프로필이 있는 ExplanationOfBenefit 리소스는 항상 포함됩니다. ### 재무 데이터 변환 `_includeEOB2xWoFinancial=true`를 설정하면 작업은 금융 데이터를 제거하여 [CARIN BB 2.x](https://hl7.org/fhir/us/carin-bb/) ExplanationOfBenefit 리소스를 해당 기본 프로필로 변환합니다. 예를 들어 `C4BB ExplanationOfBenefit Oral` 리소스는 FHIR 사양에 따라 레코드에서 금융 데이터를 `C4BB ExplanationOfBenefit Oral Basis`제거하는 로 변환됩니다. 변환 중에 다음 금융 데이터 요소가 제거됩니다. + `total` 요소의 모든 조각화 + `amounttype` 조각이 있는 모든 `adjudication` 요소 + 금액 정보가 있는 모든 `item.adjudication` 요소 작업은 변환 중에 프로필 메타데이터도 업데이트합니다. + `meta.profile`가 기본 프로필 정식 URL로 업데이트됨 + 버전이 CARIN BB 2.x 기본 버전으로 업데이트됨 + 데이터 스토어의 기존 리소스는 수정되지 않습니다. + 내보낸 리소스는 데이터 스토어로 다시 유지되지 않습니다. ### 프로필 감지 규칙 작업은 다음 규칙을 사용하여 프로파일을 감지하고 검증합니다. + 버전 감지는 `meta.profile` 표준 URLs. + 선언된 프로파일 중 하나라도 내보내기 기준과 일치하는 경우 리소스가 포함됩니다. + 프로필 검증은 내보내기 처리 중에 발생합니다. ## PDex 내보내기에 대한 5년 임시 필터링 모든 PDex 내보내기 유형에 대해 HealthLake는 리소스가 마지막으로 업데이트된 시간을 기반으로 5년 시간 필터를 적용합니다. 시간 필터는 연령에 관계없이 항상 내보내지는 다음 코어 속성 리소스 유형을 제외한 모든 리소스에 적용됩니다. + `Patient` + `Coverage` + `Organization` + `Practitioner` + `PractitionerRole` + `RelatedPerson` + `Location` + `Group` 이러한 관리 및 인구 통계 리소스는 내보낸 데이터에 대한 필수 컨텍스트를 제공하므로 제외됩니다. 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) ``` **참고** 위의 리소스 관계 다이어그램은 ATR 내보내기에 적용됩니다. PDex 내보내기의 경우 임상 및 클레임 리소스는 환자 검색을 통해 자동으로 검색되며 그룹 리소스에서 명시적 참조가 필요하지 않습니다. ### 리소스 소스 | Resource | 소스 위치 | 설명 | | --- | --- | --- | | Patient | Group.member.entity | 어트리뷰션 목록의 멤버인 환자 | | Coverage | Group.member.extension:coverageReference | 환자 멤버십을 초래한 보장 범위 | | Organization | Group.member.extension:attributedProvider | 환자가 속한 조직 | | Practitioner | Group.member.extension:attributedProvider | 환자가 속한 개별 실무자 | | PractitionerRole | Group.member.extension:attributedProvider | 환자가 속한 프랙티셔너 역할 | | RelatedPerson | Coverage.subscriber | 적용 범위 구독자 | | Location | PractitionerRole.location | 실무자 역할과 연결된 위치 | | Group | 입력 엔드포인트 | 어트리뷰션 목록 자체 | ## 작업 관리 작업 상태 확인 `GET [base]/export/[job-id]` 작업 취소 `DELETE [base]/export/[job-id]` ### 작업 수명 주기 + `SUBMITTED` - 작업이 수신되고 대기열에 있음 + `IN_PROGRESS` - 작업이 적극적으로 처리 중입니다. + `COMPLETED` - 작업이 성공적으로 완료되었으며 파일을 다운로드할 수 있음 + `FAILED` - 작업에 오류가 발생했습니다. ## 출력 형식 + *파일 형식*: NDJSON(줄 바꿈으로 구분된 JSON) + *파일 구성*: 각 리소스 유형에 대해 파일 분리 + *파일 확장*명: .ndjson + *위치*: 지정된 S3 버킷 및 경로 ## 오류 처리 작업은 다음 조건에 대해 OperationOutcome과 함께 HTTP 400 잘못된 요청을 반환합니다. 권한 부여 오류 에 지정된 IAM 역할에 내보내기 작업을 수행할 수 있는 충분한 권한이 `DataAccessRoleArn` 없습니다. 필요한 S3 및 KMS 권한의 전체 목록은 [내보내기 작업에 대한 권한 설정을](getting-started-setting-up.md#setting-up-export-permissions) 참조하세요. 파라미터 검증 오류 + `patient` 파라미터의 형식은가 아닙니다. `Patient/id,Patient/id,...` + 하나 이상의 환자 참조가 유효하지 않거나 지정된 그룹에 속하지 않습니다. + `exportType` 파라미터 값이 지원되는 내보내기 유형이 아닙니다. + `_type` 파라미터에는 지정된 내보내기 유형에 대해 지원되지 않는 리소스 유형이 포함되어 있습니다. + `_type` 파라미터에 `hl7.fhir.us.davinci-atr` 내보내기 유형에 필요한 리소스 유형(`Group`, `Patient`, `Coverage`)이 없습니다. + `_includeEOB2xWoFinancial` 파라미터 값이 유효한 부울이 아닙니다. 리소스 검증 오류 + 지정된 그룹 리소스가 데이터 스토어에 존재하지 않습니다. + 지정된 그룹 리소스에 멤버가 없습니다. + 하나 이상의 그룹 멤버가 데이터 스토어에 없는 환자 리소스를 참조합니다. ## 보안 및 권한 부여 + 표준 FHIR 권한 부여 메커니즘 적용 + 데이터 액세스 역할에는 S3 및 KMS 작업에 필요한 IAM 권한이 있어야 합니다. 필요한 권한의 전체 목록은 [내보내기 작업에 대한 권한 설정을](getting-started-setting-up.md#setting-up-export-permissions) 참조하세요. ## 모범 사례 + *리소스 유형 선택*: 내보내기 크기 및 처리 시간을 최소화하는 데 필요한 리소스 유형만 요청합니다. + *시간 기반 필터링*: 증분 내보내기에 `_since` 파라미터 사용 + *환자 필터링*: 특정 멤버에 대한 데이터만 필요한 경우 `patient` 파라미터를 사용합니다. + *작업 모니터링*: 대규모 내보내기에 대한 작업 상태를 정기적으로 확인 + *오류 처리*: 실패한 작업에 대한 적절한 재시도 로직 구현 + *임시 필터 인식*: PDex 내보내기의 경우 리소스 유형을 선택할 때 5년 임시 필터를 고려하세요. + *재무 데이터 제거*: 재무 정보 없이 클레임 데이터가 필요한 `_includeEOB2xWoFinancial=true` 경우 사용 + *프로파일 관리*: 리소스에 적절한 프로파일 선언이 있는지 확인하고, 수집 전에 대상 프로파일에 대해 검증하고, 프로파일 버전 관리를 사용하여 내보내기 동작을 제어합니다. ## 제한 사항 + `patient` 파라미터에 최대 500명의 환자를 지정할 수 있습니다. + 내보내기는 그룹 수준 작업으로만 제한됩니다. + 는 각 내보내기 유형에 대해 미리 정의된 리소스 유형 집합만 지원합니다. + 출력은 항상 NDJSON 형식입니다. + PDex 내보내기는 5년의 임상 및 클레임 데이터로 제한됩니다. + 금융 데이터 변환은 CARIN BB 2.x ExplanationOfBenefit 프로필에만 적용됩니다. ## 추가 리소스 + [Da Vinci 멤버 속성 목록 IG](https://build.fhir.org/ig/HL7/davinci-atr/) + [Da Vinci 지급인 데이터 교환 IG](https://hl7.org/fhir/us/davinci-pdex/) + [CARIN 소비자 주도 지급인 데이터 교환 IG](https://build.fhir.org/ig/HL7/carin-bb/) + [미국 코어 구현 가이드](https://www.hl7.org/fhir/us/core/) + [FHIR 대량 데이터 액세스 사양](https://hl7.org/fhir/uv/bulkdata/)