주소 계층 설정
목적
Bahmni는 OpenMRS의 Address Hierarchy 모듈을 사용해 주소 항목 목록을 관리합니다. 아래 단계에 따라 구현 환경에 새 주소 계층을 설정하세요.
설정
주소 절에서는 두 가지를 설정할 수 있습니다.
- 주소 입력 방향(상위에서 하위/하위에서 상위). 엄격한 자동 완성을 적용할 단계(값을 자동 완성 검색 목록에서만 선택해야 함).
Bahmni에서는 주소 계층 Form을 두 가지 방식으로 설정할 수 있습니다.
- 하위에서 상위(예: Village – Tehsil – District - State)
‘Village’ 드롭다운에서 항목을 선택하면 위의 모든 단계가 자동으로 채워집니다.
- 상위에서 하위(예: State – District - Tehsil – Village)
상위 단계를 채우면 입력한 상위 필드 값에 따라 하위 단계가 필터링됩니다. 예를 들어 State에 ‘Chattisgarh’를 입력하면 ‘District’ 필드의 자동 완성 목록에는 ‘Chattisgarh’에 속하는 District만 표시됩니다.
설정하려면 app.json의 config 절에 다음 내용을 추가할 수 있습니다.
"addressHierarchy": {
"showAddressFieldsTopDown": true,
"strictAutocompleteFromLevel": "address3" //address3 is the addressfield name of Tehsil
}- ‘하위에서 상위’ 방식이 기본 주소 계층 설정입니다. 상위에서 하위 방식을 지원하려면 ‘showAddressFieldsTopDown’을 true로 설정합니다. 두 방식 모두 주소 필드는 기본적으로 자유 텍스트를 지원합니다. 자동 완성만 허용하려면 엄격한 자동 완성을 시작할 주소 단계를 다음 설정으로 지정할 수 있습니다. 예: "strictAutocompleteFromLevel": "address3". 이 예에서는 Tehsil부터 그 위의 모든 단계(예: District와 State)에 엄격한 자동 완성이 적용됩니다.
단계
1) 주소 매핑 CSV 업로드
Bahmni UI에 주소 계층을 표시하려면 OpenMRS에 설정해야 합니다. 원하는 주소 계층이 담긴 CSV(쉼표로 구분된 값) 파일을 업로드하는 방식이 가장 좋습니다. 예를 들어 State -> District -> Taluka / Block -> Village / City 계층이라면 CSV 형식은 State, District, Taluka, Village여야 합니다.
계층 | State | District | Taluka | Village
| 잘못됨 | Maharashtra | Ghot | Chamorshi | Gadchiroli |
|---|---|---|---|---|
| 올바름 | Maharashtra | Gadchiroli | Chamorshi | Chamorshi |
CSV를 만든 뒤 OpenMRS > Administration > Manage Address Hierarchy 페이지에서 업로드합니다.
‘Upload Address Hierarchy’ 절에서 다음과 같이 설정합니다.
위 화면의 설정
- 업로드할 CSV 파일을 선택합니다. Delimiter(정규식 형식): 따옴표 없이 ‘,’. User-Generated Id Delimiter(정규식 형식): 비워 둡니다. Overwrite Existing Hierarchy: 기존 주소 계층을 교체해야 한다면 선택합니다. 선택하지 않으면 새 주소가 기존 계층에 추가됩니다. Upload를 클릭합니다.
2) 주소 필드 매핑
주소 CSV를 성공적으로 업로드하면 아래와 같이 Address Hierarchy Levels에 필드 목록이 표시됩니다.
위 화면의 설정
- 필드 옆 Edit 링크를 클릭하여 Name, Address Field, Required Flag를 지정합니다. Name은 Registration 페이지에서 사용자에게 표시할 Label입니다. Address Field는 ‘person_address’ 테이블에 저장됩니다. DB 관점에서는 큰 차이가 없지만 관련성이 높은 필드와 최대한 가깝게 유지하는 것이 좋습니다.
모든 필드에 이 작업을 완료하면 주소 계층 설정이 끝납니다.
하위 문서
Bahmni Wiki · CC BY-SA 4.0