본문 바로가기
FHIR

HL7 FHIR - Resource(1) - Patient

by Aslan0 2022. 12. 5.

FHIR 

HL7이라는 구제 표준기구가 만든 의료 데이터의 형식을 지정하여 의료 데이터 교환을 위한 API의 표준 이다.

API 기술을 사용하기 때문에 더 편리하게 자료를 교환하고 공유가 가능하여졌다.

 

FHIR Resource

FHIR는  리소스 라는 단위로 데이터를 정형화하여 관리한다.

이렇게 데이터를 정형화를 진행하여 많은 사람이 각각의 데이터를 넣는다고 하더라도 틀에 맞도록 정형화 되어있기 때문에 

이전에 그냥 주먹구구 식으로 자료를 공유하던 방식에 비해 훨씬 데이터에 대한 신뢰성을 높일 수  있었다고 생각한다.

몇가지 리소스를 알아보는 글을 작성하려고 한다.

HL7 FHIR Resource

 

1. Patient Resource ( 환자 리소스)

첫번째로 알아볼 리소스는 기본이 되는 환자 리소스 이다.

환자 리소스의 기본적인 정보를 간단하게 JSON으로 나타내면 다음과 같다.

{doco
  "resourceType" : "Patient",
  		// 리소스: id, meta, inmitiveRules 및 language
  		// From DomainResource: 텍스트, 포함됨, 확장자 및 수정자연장
  "identifier" : [{ Identifier }], 	// 이 환자의 식별자
  "active" : <boolean>, 	// 이 환자의 기록이 현재 사용 중인지 여부
  "name" : [{ HumanName }], 	// 환자와 연관된 이름
  "telecom" : [{ ContactPoint }], 	// 개인에 대한 연락처 세부 정보
  "gender" : "<code>", // male | female | other | unknown
  "birthDate" : "<date>", // 개인의 생년월일
  		// deceased[x]: 개인의 사망 여부를 나타냅니다. 다음 중 하나:
  "deceasedBoolean" : <boolean>,		//사망여부
  "deceasedDateTime" : "<dateTime>",	//사망한 날짜
  "address" : [{ Address }], 	// 개인 주소
  "maritalStatus" : { CodeableConcept }, 	// 환자의 혼인(민간) 상태
  		// multipleBirth[x]: 환자가 다중 출생의 일부인지 여부. 다음 중 하나:
  "multipleBirthBoolean" : <boolean>,		//다중 출생 부울
  "multipleBirthInteger" : <integer>,		//다중 출생 인티저?
  "photo" : [{ Attachment }], 	// 환자 사진
  "contact" : [{ 				// 환자의 연락처(예: 보호자, 파트너, 친구)
    "relationship" : [{ CodeableConcept }], 	// 관계의 종류
    "name" : { HumanName }, 	// 연락처 사용자와 연관된 이름
    "telecom" : [{ ContactPoint }], 			// 사용자에 대한 연락처 세부 정보
    "address" : { Address }, 	// 연락처 주소
    "gender" : "<code>", 		// male | female | other | unknown
    "organization" : { Reference(Organization) }, // C? 연락처와 연결된 조직
    "period" : { Period } 		// 이 환자와 관련하여 이 연락 담당자 또는 조직이 연락할 수 있는 유효 기간
  }],
  "communication" : [{ 			// 환자의 건강에 대해 환자와 의사소통할 때 사용할 수 있는 언어
    "language" : { CodeableConcept }, 		// R! 환자의 건강에 대해 의사소통하기 위해 사용할 수 있는 언어
    "preferred" : <boolean> 	// 언어 선호도 표시기
  }],
  "generalPractitioner" : [{ Reference(Organization| Practitioner | PractitionerRole) }], 		// 환자가 지명한 1차 진료 제공자
  "managingOrganization" : { Reference(Organization) }, 		// 환자 기록의 관리자인 조직
  "link" : [{ 		// 동일한 실제 사용자와 관련된 다른 환자 리소스에 대한 링크
    "other" : { Reference(Patient|RelatedPerson) }, 		// R! 링크가 참조하는 다른 환자 또는 관련 사용자 리소스
    "type" : "<code>" 		// R! 대체 | 대체 | 참조 | 참고 항목
  }]
}

기본적으로 HL7 FHIR 공식 홈페이지에 공지되어 있는 부분들에 대해서 나열한 부분이다.

HL7이 어려운 이유는 모든 기본적으로 국내의 자료가 없다고 생각하면 될정도로 적은 부분이 많고 

진행하다보면 의학용어들이 마구잡이로 쏟아져 내리면서 개발자로써 많은 부담을 느끼게되는 부분이 많다.

그래서 아래에 Patient Resource의 더 자세한 사항을 적어 도움을 줄 수 있도록 작성하려한다.

 

1.1 Patient Resource 용어 정의

Path Def Type Reference
Patient.gender 성별 필수 AdministrativeGender
Patient.maritalStatus 결혼 여부 확장가능 Marital Status Codes
Patient.contact.relationship 환자와의 관계 확장가능 PatientContactRelationship
Patient.contact.gender 성별 필수 AdministrativeGender
Patient.communication.language 환자 선호 언어 넣는걸 추천함 CommonLanguages
Patient.link.type 이환자 리소스와 다른환자 리소스 간의 연결 유형 필수 LinkType

1.2 Patient Resource 강제점

id Level Location Description Expression
pat-1 Rule patient.contact 최소한 연락처의 세부사항이나 조직에 대한 언급을 포함해야 한다. name.exists() or telecom.exists() or address.exists() or organization.exists()

note:

  • multipleBirth(다중 출생)는 부울(Boolean)(환자가 다중 출생인지 여부를 나타내는 것) 또는 실제 출생 순서를 나타내는 정수로 표현할 수 있습니다.
  • 환자 기록은 사용 중(활성=사실)과 사용 중(활성=거짓)의 두 상태 중 하나에만 있을 수 있다. 정상적인 레코드는 활성 상태, 즉 사용 중이다. 활성은 레코드가 중복되거나 오류로 생성될 때 '거짓'으로 설정된다. 레코드를 비활성화하기 위해 연결할 필요는 없습니다.
  • 링크 요소는 둘 이상의 환자 리소스가 모두 동일한 실제 환자에 대해 있다고 주장하는 데 사용됩니다. 자세한 내용은 아래를 참조하십시오.
  • 선호하는 언어(언어)는 하나만 있어야 합니다.기본 설정 = true) 식 모드별.
  • 환자 연락처에는 요소 조직이 있으며, 이는 조직과 관련이 있는 보호자 또는 비즈니스 관련 연락처와 함께 사용하기 위한 것입니다.

 

대략적인 Patient Resource에 대한 설명이며 해당 리소스 들에 대해서 실제로 사용하고 싶다면

1. 내가 개발하는 프로젝트에서 산출되는 데이터는 어떠한것들이 있는지

2. 산출 데이터를 바탕으로 어떤한데이터를 입력할 것인지

이 2가지를 바탕으로 설계를 진행하여 개발을 수행하면 좋을것 같습니다.

'FHIR' 카테고리의 다른 글

FHIR - Resource란?  (0) 2022.12.09
HL7 FHIR Resource(4) - RelatedPerson  (0) 2022.12.08
HL7 FHIR Resource(3) - Device  (0) 2022.12.06
HL7 FHIR Resource(2) - Observation  (0) 2022.12.05

댓글