한국어 번역 완료

환자 등록 구성

목적과 이점

등록 모듈에서는 환자 정보를 입력하고 유지할 수 있습니다. 또한 의료기관 업무 흐름에서 환자의 출발점 역할을 합니다. 다양한 구현 유형에 맞게 환자 속성을 유연하게 구성할 수 있으며, 환자 주소 계층, 환자 관계, 방문 상세 정보 및 사망 원인도 구성할 수 있습니다.

단계

1. 핵심 필드 구성

이름, 성별, 나이 같은 일부 핵심 필드는 Bahmni에 기본 제공되므로 별도로 설정할 필요가 없습니다. 단, 환자 식별자는 설정해야 합니다.

환자 식별자 설정

Bahmni에는 OpenMRS idgen 모듈과 "Bahmni Id"라는 환자 식별자 유형이 사전 설치되어 있습니다. ID 드롭다운을 변경하려면 Bahmni Id의 식별자 소스를 편집해야 합니다. 다음은 Bahmni 식별자 소스를 편집하는 절차입니다.관련 문서: OpenMRS idgen module

환자 식별자 구성:

Bahmni에서는 환자 식별자를 구성할 수 있습니다. 기본 환자 식별자 접두사는 등록 페이지에서 구성할 수 있습니다.

환자 식별자 추가 또는 편집

새 환자 식별자를 추가하거나 기존 식별자를 편집하려면 Patient Identifier 문서를 참고하십시오.

기본 식별자 유형의 기본 접두사 표시

환자 등록 페이지에서 기본 식별자 유형의 기본 접두사를 표시하려면 registration/app.json 파일의 config 절 아래에 다음 구성을 추가하십시오.

Config

"defaultIdentifierPrefix”:source name of identifier/prefix

Sample Config

“config”:{
  "defaultIdentifierPrefix”:”GAN”
}

기본 식별자 접두사를 제공하지 않았거나 값이 비어 있거나 유효하지 않으면, Bahmni는 사용 가능한 식별자 접두사를 알파벳순으로 정렬한 뒤 첫 번째 값을 기본 접두사로 사용합니다.

참고: 이 구성은 기본 식별자 유형에만 적용되며 추가 식별자 유형에는 적용되지 않습니다.

등록 페이지에서 추가 식별자를 읽기 전용으로 설정:

환자 등록 페이지에서 추가 식별자 필드를 편집할 수 없게 하려면 registration/app.json 파일의 config 절 아래에 다음 구성을 추가하십시오. 아래 예시의 "National Id"처럼 편집 불가로 만들 추가 식별자를 지정합니다. 기본적으로 추가 식별자 필드는 편집할 수 있습니다.

Sample Config

“config”:{
  "readOnlyExtraIdentifiers": ["National ID"]
}

참고: 이 구성은 추가 식별자 유형에만 적용되며 기본 식별자 유형에는 적용되지 않습니다.

성별 구성

성별 드롭다운에 사용자 지정 값을 표시하려면 "mrs.genders"를 추가하거나 편집하여 JSON 구조로 사용자 지정 값을 지정합니다. 예:관련 문서: 고급 설정 구성

{"M": "Male", 
"F": "Female", 
"O": Other}

로그인 위치를 기준으로 주소 상세 정보 미리 입력

이 기능을 사용하려면 OpenMRS에서 해당 위치를 로그인 위치로 구성해야 합니다. registration/app.json에 아래 구성을 추가합니다.

Sample Config

{ 
    "config": {
             "prepopulateFields" : ["Division", "Zilla", "Upazilla"]
        }
}

구성에 지정하는 필드는 등록 페이지에 표시되는 주소 필드 레이블이어야 합니다. 이 데이터는 새 환자를 생성할 때만 미리 입력됩니다.

2. 여러 언어로 환자 이름 필드 입력 구성

등록 페이지의 이름, 중간 이름, 성 필드에 여러 언어를 입력할 수 있습니다. 이를 위해 영문 영숫자를 검증하는 정규식을 삭제해야 합니다.

OpenMRS → Admin → Advance Settings로 이동해 patient.nameValidationRegex 전역 속성 값을 삭제합니다. /var/www/bahmni_config/openmrs/registration/app.json 파일의 fieldValidation 절에서 familyName, givenName, middleName 행을 삭제합니다.

"familyName" : {"pattern" : "[a-zA-Z]{0,}", "errorMessage" : "Should contain characters"},
"givenName" : {"pattern" : "[a-zA-Z]{0,}", "errorMessage" : "Should contain characters"},
"middleName" : {"pattern" : "[a-zA-Z]{0,}", "errorMessage" : "Should contain characters"},

이렇게 하면 환자 이름을 둘 이상의 언어로 입력할 수 있습니다.

3. 사진 촬영 구성

Configuration to Disable Photo Capture

"disablePhotoCapture": true

구현 요구 사항에 따라 Bahmni 등록에서 사진 촬영을 비활성화할 수 있습니다. 기본 동작은 등록 페이지에 사진 촬영 기능을 표시하는 것입니다. 비활성화하려면 registration의 app.json에 구성을 적용해야 합니다. Bahmni 0.90부터는 등록 페이지에서 환자 프로필 사진 업로드도 지원합니다. 촬영한 사진을 저장하려면 emr.personImagesDirectory 전역 속성을 구성해야 합니다. 예: emr.personImagesDirectory = /home/bahmni/patient_images

4. 주소 정보 구성

주소는 사전을 사용해 값이 채워지도록 구성할 수 있습니다. 애플리케이션은 주소를 코드화하고 환자 주소 입력 시 발생할 수 있는 인적 오류를 방지하도록 주소 계층을 유지합니다.관련 문서: 주소 계층 설정

이 주소 필드가 OpenELIS의 올바른 레이블과 동기화되도록 하려면 Address Mapping between OpenELIS and Bahmni / OpenMRS 절차를 참고하십시오.관련 문서: OpenELIS와 Bahmni/OpenMRS 간 주소 매핑

5. 추가 환자 정보 구성

수집해야 할 추가 환자 속성은 관련 설정을 추가하거나 변경해 구성할 수 있습니다. 사용자 지정 설정을 통해 등록 페이지를 더 세밀하게 조정할 수도 있습니다. 사용자 지정 필드 유효성 검사(필수 필드, 필드 값 제한 등), 필드 표시/숨김, 자동 완성 등의 기능을 지원합니다. 자세한 내용은 관련 문서를 참고하십시오.관련 문서: 개인 속성 구성 등록 앱

추가 환자 정보 절의 필드는 추가 설정과 함께 OpenMRS person attributes를 사용해 구성할 수도 있습니다.관련 문서: 등록 앱

6. 환자 관계 구성

환자 관계 기능은 애플리케이션 내 여러 참여자(의사, 간호사, 환자 및 환자의 친척) 사이의 관계 정보를 유지하는 데 사용합니다. 애플리케이션에서는 세 가지 관계 유형을 정의할 수 있습니다.

자기 관계: 한 프로그램에 등록된 환자가 이후 다른 프로그램에도 등록되는 경우에 적용됩니다. 예를 들어 ID GAN200013으로 프로그램에 등록된 환자가 다른 프로그램에 등록되면, 후속 등록 과정에서 최초 ID GAN200013과 연결할 수 있습니다. 제공자 관계: 환자를 진료하는 의사나 간호사를 환자의 제공자로 관계 필드에 추가할 수 있습니다. 환자 관계: 환자는 다른 환자와 아버지, 어머니, 형제, 자매 등의 관계를 가질 수 있습니다. 이를 통해 결핵, HIV 같은 감염병의 잠재 환자를 추적하고 선별할 수 있습니다.

등록 모듈에서 환자 관계를 수집하려면 다음 작업이 필요합니다.

OpenMRS Admin UI를 사용합니다. OpenMRS에 'bahmni.relationshipTypeMap' 속성을 구성하여 관계를 관계 유형에 매핑하는 JSON 파일을 지정합니다. 일반적인 값은 {"provider":["Doctor"],"patient":["Parent","Sibling"]}과 같습니다. 이 목록을 통해 Bahmni가 화면 필드의 값을 어떤 방식으로 자동 완성할지 식별합니다.관련 문서: 환자 관계 구성

7. 방문 구성

Bahmni는 방문(Visit)을 사용해 환자의 병원 내원·입원을 기록하고 한 번의 입원 기간 중 환자가 받은 여러 진료를 추적합니다.

Bahmni에서는 방문을 여러 유형으로 분류할 수 있습니다. 여러 방문 유형은 다음 경우에 유용합니다.

유형별 방문 수를 기준으로 보고서를 생성합니다. Clinical 또는 Radiology 같은 다른 앱에서 대기열을 구성합니다.

방문 설정

구현 시 방문 유형을 하나 이상 반드시 설정해야 합니다. 등록에서 환자를 생성하거나 편집할 때 방문 유형이 드롭다운 옵션으로 표시됩니다. 관련 관리 화면에서 방문 유형을 추가할 수 있으며, 추가한 모든 방문 유형은 환자 등록 화면에 표시됩니다(아래 스크린샷 참고).관련 문서: 방문 유형 구성

로그인 위치 기반 "기본 방문 유형" 설정

Bahmni는 로그인 위치를 기준으로 기본 방문 유형을 설정할 수 있습니다. 구현 담당자는 entity_mapping 테이블에 항목을 추가해 위치별 defaultVisitType을 설정할 수 있습니다.

예를 들어 Registration Desk 위치의 기본 방문 유형을 OPD로 지정하려면 다음과 같이 구성합니다.

기본 방문 유형을 설정하려면 아래 쿼리를 실행합니다.

entity1_uuid - "SELECT uuid FROM location where name = 'Registration Desk';" .
entity2_uuid -"SELECT uuid FROM visit_type where name = 'OPD;"  
entity_mapping_type_id -"SELECT id FROM entity_mapping_type  where name = 'loginlocation_visittype';"

UUID와 id를 entity_mapping 테이블에 삽입합니다.

"INSERT INTO entity_mapping ( uuid, entity_mapping_type_id , entity1_uuid , entity2_uuid , date_created) VALUES (uuid(),9,'c5854fd7-3f12-11e4-adec-0800271c1b75','c2402997-3f10-11e4-adec-0800271c1b75','2015-11-25 14:43:56.0');"

이렇게 설정하면 사용자가 등록 페이지에서 새 환자를 생성할 때 'start OPD visit'이 기본 방문 유형으로 표시됩니다.

8. 방문 상세 정보 양식 구성:

사용자가 방문을 시작하면 방문 상세 정보 양식으로 리디렉션됩니다(아래 스크린샷 참고).

Screen Shot 2016-05-03 at 4.28.15 PM.png

방문 상세 정보 양식에서 등록 과정의 일부로 수집할 데이터를 구성할 수 있습니다. 해당 구성은 extension.json 파일에 추가합니다. 참고용으로 Default Config 링크를 확인하십시오.

Fee Information과 유사한 새 절을 추가하려면 새 concept set을 생성해야 합니다. 자세한 내용은 아래 링크를 참고하십시오.

https://wiki.openmrs.org/display/docs/Create+and+Edit+Concepts

https://wiki.openmrs.org/display/docs/Managing+Concept+Sets

그런 다음 extension.json 파일에 다음 구성을 추가합니다.

Bahmni 0.90 릴리스부터는 Form Builder 앱으로 만든 새 양식을 방문 상세 정보 페이지에 구성할 수 있습니다. extension.json 파일에 다음 구성을 추가합니다.

등록 두 번째 페이지에 최신 기록을 1개보다 많이 표시:

등록 두 번째 페이지에 구성한 양식의 concept에 대해 최근 수집한 observation이 아래와 같이 "latest" 절에 표시됩니다. 현재는 최신 기록 1개로 하드코딩되어 있으며 이를 바꾸는 별도 구성 속성은 없습니다. visit.html 파일의 config 절에 numberOfVisits:5를 추가해야 합니다.

변경 전:

변경 후:

"방문 종료" 버튼 구성

방문이 실수로 시작되었거나 절차상 누락으로 종료되지 않은 경우 병원에는 "방문 종료" 기능이 필요합니다. 등록 모듈의 "방문 상세 정보" 페이지에 Bahmni 사용자가 방문을 종료할 수 있는 버튼을 추가할 수 있습니다. 이 버튼은 "app:common:closeVisit" 권한을 받은 사용자에게만 표시됩니다. 권한을 할당하려면 다음 절차를 따릅니다.

OpenMRS Admin 페이지로 이동합니다. "Manage Roles"로 이동합니다. 권한을 추가할 역할(예: "RegistrationClerk-Advanced")을 선택합니다. "app:common:closeVisit" 권한을 할당하고 Save를 클릭합니다. 이 작업을 수행할 사용자에게 해당 역할이 할당되어 있는지 확인합니다.

9. 방문 유형에 따른 두 번째 페이지 사용 여부 구성

이전에는 방문 유형이 하나일 때 등록 두 번째 페이지를 표시할지 구성할 수 있었습니다. 그러나 방문 유형을 여러 개 구성하면 두 번째 페이지가 항상 표시되어 건너뛸 수 없었습니다.

registration/app.json의 "config" 절 아래에 이 구성을 추가합니다.

"forwardUrlsForVisitTypes": [
               {
                   "visitType": "First Stage Validation",
                   "forwardUrl": "../clinical/#/programs/patient/{{patientUuid}}/consultationContext",
                   "translationKey": "Enter Visit page details",
                   "shortcutKey": "c"
               },
               {
                   "visitType": "Follow-Up Validation",
                   "forwardUrl": "../document-upload/?encounterType=RADIOLOGY&topLevelConcept=Radiology#/patient/{{patientUuid}}/document",
                   "translationKey": "Enter <u>D</u>ocuments upload",
                   "shortcutKey": "d"
               }
           ]

10. 사망 정보

사망 정보에는 구성 가능한 필드가 하나뿐입니다. 설정 방법은 다음과 같습니다.

OpenMRS에 로그인합니다. Concept Dictionary로 이동해 가능한 모든 사망 원인을 포함하는 새 Concept Set을 추가합니다. 각 사망 원인도 개별 concept이어야 합니다. concept.reasonForDeath 속성을 추가하거나 편집하고 방금 만든 concept set의 정규화된 전체 이름을 값으로 지정합니다.

11. 생년월일 구성

구현별 구성 폴더인 bahmni-config로 이동합니다. 설정 파일은 bahmni-config/openmrs/apps/registration/app.json입니다. 파일의 'config' 절에 다음 구성을 추가합니다.

Configuration for data of birth

"dobMandatory": true

12. 출생 시간 숨기기 구성

구현별 구성 폴더인 bahmni-config로 이동합니다. 설정 파일은 bahmni-config/openmrs/apps/registration/app.json입니다. 파일의 'config' 절에 다음 구성을 추가합니다.

Configuration to hide birth time

"showBirthTime": false

13. ID 입력 필드 구성

사용자가 환자의 patientId를 직접 입력하려는 경우 Enter Id 옵션을 사용할 수 있습니다. 이 옵션은 기본적으로 활성화되어 있습니다.

Screen Shot 2016-08-18 at 10.53.45 AM.png

사용자가 ID를 직접 입력하지 못하게 하려면 registration 폴더의 app.json 파일에서 config 절 아래에 다음 구성을 추가합니다.

Hiding Enter Id option

"showEnterID":false

14. 등록 화면의 절 표시 순서 구성

환자 정보 아래의 여러 절은 구성에 있는 "order" 값의 순서대로 표시됩니다. 일부 절에만 order 값이 있으면 order 값이 있는 절을 먼저 표시하고 나머지는 기존 기본 동작을 따릅니다. 어느 절에도 order 값이 없으면 기본 동작, 즉 절이 입력된 순서대로 표시됩니다.

구현별 구성 폴더인 bahmni-config로 이동합니다. 설정 파일은 bahmni-config/openmrs/apps/registration/app.json입니다. 파일의 'patientInformation' 아래 각 절에 다음 구성을 추가합니다.

Configuration for display order of sections in registration

"order" : 1 // order number specifies the sequence in which the section should be displayed

15. 등록 방문 페이지에서 저장 후 이동할 URL 구성

등록 방문 페이지의 저장 버튼 동작은 구성으로 제어할 수 있습니다. 저장 버튼을 클릭하면 구성된 URL로 이동합니다. 구성이 없을 때의 기본 동작은 현재 페이지, 즉 등록 방문 페이지에 머무르는 것입니다.

구현별 구성 폴더인 bahmni-config로 이동합니다. 설정 파일은 bahmni-config/openmrs/apps/registration/app.json입니다. 파일의 'config' 절 아래에 다음 구성을 추가합니다. 등록 방문 페이지의 저장 후 URL 구성

Configuration for after save url in Registration Visit Page

"afterVisitSaveForwardUrl" : "../clinical/#/default/patient/{{patientUuid}}/dashboard" // forward url to navigate after save (In this example after save one will be navigated to patient dashboard

Registration Second page (save highlighted)

16. 등록의 환자 생성 페이지에서 절 표시/숨기기

등록 페이지에는 여러 환자 속성 절이 있을 수 있습니다. 조건에 따라 각 절을 표시하거나 숨길 수 있으며, 이 조건은 나이, 성별 또는 환자 속성을 기준으로 지정할 수 있습니다.

예:

나이가 18세 미만인 경우에만 "Guardian Details" 절을 표시합니다.

관련 문서에 제시된 절차를 따르십시오.관련 문서: 조건부 속성

17. 방문 시작 버튼 숨기기

등록 페이지에서 'start visit' 버튼을 숨기려면 "config" 절에서 다음과 같이 비활성화할 수 있습니다.

방문이 열려 있지 않으면 환자 정보를 기록할 수 없으므로 방문 시작 버튼을 끄는 것은 일반적으로 유용하지 않습니다. 다만 다음과 같은 사용 사례가 있습니다.

Bahmni를 등록 용도로만 사용합니다. 단계별 도입을 진행 중이며 이후 단계에서 방문을 시작할 계획입니다. 환자 데이터를 다른 방식으로 수집합니다.

18. 환자 이름 필드 표시 순서 구성

"patientNameDisplayOrder": ["firstName", "middleName", "lastName"]

환자 이름 필드는 등록 페이지에서만 구성할 수 있으며 app.json의 "patientNameDisplayOrder" 설정에 순서를 지정합니다.

이 구성에는 세 필드를 모두 원하는 순서로 포함해야 합니다. 잘못된 구성이 제공되면 기본적으로 FirstName, MiddleName, LastName 순서로 표시됩니다. middleName과 lastName에는 기존 표시/숨김 구성 옵션을 사용합니다. registration의 app.json에 별도 구성이 없을 때도 기본적으로 FirstName, MiddleName, LastName을 표시합니다.

19. 현지 언어 이름 자리표시자 현지화

"Name in local language" 필드의 자리표시자는 현지화할 수 있습니다. bahmni-config/openmrs/i18n/registration/locale_en.json 구성 폴더에서 아래 키-값 쌍을 업데이트해야 합니다.

Sample Config

{
  "PATIENT_ATTRIBUTE_GIVEN_NAME_LOCAL": "First Name in Arabic",
  "PATIENT_ATTRIBUTE_FAMILY_NAME_LOCAL": "Last Name in Arabic",
  "PATIENT_ATTRIBUTE_MIDDLE_NAME_LOCAL": "Middle Name in Arabic"
}

20. 등록 페이지의 예비 환자 속성 구성

이 속성을 사용하면 등록 사용자가 환자를 예비 환자 또는 확정 환자로 표시할 수 있습니다. 의료기관에서는 잠재 환자가 분류 과정을 거친 뒤 의사가 해당 기관에서 치료할 수 있는지 결정합니다. 수용되지 않은 예비 환자는 다른 모듈에 표시되면 안 되므로 필터링이 필요합니다. 예비 환자 속성은 Clinical, OT, Patient Documents, Lab Entry, Reporting 등의 다른 모듈에 어떤 환자가 표시될지 결정합니다. 분류 프로그램 대기열도 이 속성을 기준으로 채워집니다.

일반적인 사용 사례의 예: 현장 보건 인력은 외딴 지역을 방문해 환자 정보를 수집하거나 지역 보건 클리닉을 운영합니다. 이때 확인란을 선택하지 않은 채 환자를 등록합니다. 이들 중 일부는 병원 진료가 필요합니다. 환자가 실제로 병원에 오면 확인란을 선택하여 의사가 진료를 시작할 수 있게 합니다. 내원 전에도 "outreach program"에 등록할 수 있습니다. 환자는 예약 검색에 계속 표시되므로 병원에서 외딴 지역 환자의 예약을 만들고 예약일에 내원하도록 안내할 수 있습니다.

환자가 "Confirmed Patient"로 표시되면 작업을 되돌릴 수 없도록 해당 속성을 숨깁니다. 확정 환자를 다시 예비 환자로 변경할 수 없습니다.

아래 구성은 openmrs/apps/adt/app.json, openmrs/apps/clinical/app.json, openmrs/apps/documentUpload/app.json, openmrs/apps/ipd/app.json, openmrs/apps/ot/app.json, openmrs/apps/registration/app.json에 추가해야 합니다.

Config for pre-patient attribute on registration page

"relatedIdentifierAttribute": {
"name": "confirmedPatient",
"hideOrDisable": "hide", // can be 'hide' or 'disable'
"hideOnValue": "true"
}

'confirmedPatient'는 등록된 환자가 실제 환자인지 잠재 환자인지를 결정하는 boolean 유형의 person_attribute_type 이름입니다. 아래 번역 키를 사용해 등록 페이지의 사전 등록 속성 레이블을 재정의할 수 있습니다.

'hideOrDisable'은 조건이 충족된 뒤 등록 페이지에서 확인란을 숨길지 비활성화할지 결정합니다.

'hideOnValue'는 확인란을 숨길 시점을 결정합니다. 예를 들어 속성 유형 값이 true이면 확인란을 선택한 뒤 등록 페이지에서 숨깁니다.

원문 정보

Bahmni Wiki · CC BY-SA 4.0

원문 보기 ↗