$member-remove HealthLake에 대한 작업 - AWS HealthLake
사전 조건작업 세부 정보Parameters요청 예제응답동작오류 처리모범 사례

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

$member-remove HealthLake에 대한 작업

$member-remove 작업을 통해의 FHIR 멤버 속성 목록(그룹 리소스)에서 멤버를 제거할 수 있습니다 AWS HealthLake. 이 작업은 DaVinci 멤버 속성 구현 가이드의 일부이며 멤버 속성을 관리하기 위한 조정 프로세스를 지원합니다.

사전 조건

  • AWS HealthLake FHIR 데이터 스토어

  • HealthLake 작업에 대한 적절한 IAM 권한

  • 초안 또는 미결 상태의 멤버 속성 목록(그룹 리소스)

작업 세부 정보

엔드포인트

POST /Group/{id}/$member-remove

콘텐츠 유형

application/fhir+json

Parameters

작업은 다음과 같은 선택적 파라미터가 있는 FHIR 파라미터 리소스를 수락합니다.

파라미터 카디널리티 유형 설명
memberId 0..1 식별자 제거할 멤버의 비즈니스 식별자
providerNpi 0..1 식별자 귀속된 공급자의 NPI
patientReference 0..1 레퍼런스 환자 리소스에 대한 직접 참조
providerReference 0..1 레퍼런스 공급자 리소스(Practitioner, PractitionerRole 또는 Organization)에 대한 직접 참조
coverageReference 0..1 레퍼런스 적용 범위 리소스에 대한 참조

지원되는 파라미터 조합

지원되는 파라미터 조합은 다음과 같습니다.

  • memberId 전용 - 지정된 멤버에 대한 모든 어트리뷰션을 제거합니다.

  • memberId + providerNpi - 특정 멤버-공급자 조합에 대한 어트리뷰션을 제거합니다.

  • patientReference 전용 - 지정된 환자의 모든 속성을 제거합니다.

  • patientReference + providerReference - 특정 환자-제공자 조합에 대한 어트리뷰션을 제거합니다.

  • patientReference + providerReference + coverageReference - 환자, 공급자 및 적용 범위에 따라 특정 속성을 제거합니다.

요청 예제

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "patientReference",
      "valueReference": {
        "reference": "Patient/12345"
      }
    },
    {
      "name": "providerReference",
      "valueReference": {
        "reference": "Practitioner/67890"
      }
    }
  ]
}

응답

응답 성공

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "result",
      "valueBoolean": true
    },
    {
      "name": "effectiveDate",
      "valueDate": "2024-06-30"
    },
    {
      "name": "status",
      "valueCode": "inactive"
    },
    {
      "name": "message",
      "valueString": "Member successfully removed from attribution list"
    }
  ]
}

동작

상태 요구 사항

작업은 draft 또는 상태의 어트리뷰션 목록에서만 작동합니다. open

final 상태가 인 목록은 422 오류와 함께 작업을 거부합니다.

멤버 제거 프로세스

초안 상태 목록: 멤버가 비활성(inactive: true)으로 표시되고 changeType 확장이 로 업데이트됩니다. changed

미결 상태 목록: 초안 상태와 유사한 동작

최종 상태 목록: 작업이 거부됨

검증

참조가 HealthLake 데이터 스토어에 존재하는지 검증됩니다.

동일한 리소스 유형에 대해 식별자와 참조가 모두 제공되는 경우 동일한 리소스에 해당해야 합니다.

파라미터 조합은 지원되는 패턴에 따라 검증됩니다.

오류 처리

일반적인 오류 응답

리소스를 찾을 수 없음(404)
{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "not-found",
      "details": {
        "text": "Patient with identifier 'http://example.org/fhir/identifiers|99999' not found in system"
      },
      "diagnostics": "Cannot remove member from attribution list. Verify patient identifier and try again.",
      "expression": ["memberId"]
    }
  ]
}
속성 목록 최종 상태(422)
{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "business-rule",
      "details": {
        "coding": [
          {
            "system": "http://hl7.org/fhir/us/davinci-atr/CodeSystem/atr-error-codes",
            "code": "list-final",
            "display": "Attribution list is final and cannot be modified"
          }
        ]
      },
      "diagnostics": "Cannot modify attribution list with status 'final'. List modifications are not permitted after finalization.",
      "expression": ["Group.status"]
    }
  ]
}
잘못된 작업(400)

파라미터 조합이 유효하지 않거나 잘못된 형식일 때 반환됩니다.

여러 일치 항목 찾음(412)

제공된 파라미터가 어트리뷰션 목록의 여러 멤버와 일치할 때 반환됩니다.

{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "processing",
      "diagnostics": "Multiple members found matching the criteria"
    }
  ]
}

모범 사례

  • 특정 파라미터 사용: 가능하면 가장 구체적인 파라미터 조합을 사용하여 의도하지 않은 제거를 방지합니다.

  • 검사 목록 상태: 제거를 시도하기 전에 어트리뷰션 목록 상태 확인

  • 오류 정상 처리: 가능한 모든 오류 조건에 적절한 오류 처리 구현

  • 참조 검증: 요청하기 전에 참조된 모든 리소스가 존재하는지 확인합니다.