검사 상태 유형

검사실 기술자는 결과 입력 페이지의 드롭다운에서 미리 구성된 활성 검사 상태 중 하나를 선택하여 ‘TEST’의 전체 상태를 설정할 수 있어야 합니다.

요구사항:

이 사용자 스토리를 완성하기 위해 다음 요구사항을 구현했습니다.

1. 사용자가 ELIS에 로그인하여 Administration 탭을 클릭하면 왼쪽 메뉴에 ‘Type Of Test Status’ 항목이 추가로 표시됩니다. 이 기능을 사용하지 않으려는 고객은 AdministrativeFormFields 클래스의 use fields 기능으로 구성을 끌 수 있습니다.

1. 사용자가 왼쪽 창의 ‘Type Of Test Status’ 메뉴를 클릭하면 이미 구성된 검사 상태 유형을 볼 수 있어야 합니다.

1. 아직 구성된 검사 상태가 없으면 페이지에 상세 항목이 표시되지 않습니다. 페이지 나누기는 ELIS의 다른 페이지와 동일하게 한 번에 20개 항목을 표시합니다. 목록은 ‘Test Status Name’ 순으로 정렬됩니다.

사용자가 ‘Type Of Test Status’ 메뉴 페이지에서 ‘Add’ 버튼을 클릭하면 Add Type of Test Status 페이지로 이동합니다.

1. 새 검사 상태를 생성하는 단계이므로 ID는 표시되지 않습니다. 상태 유형은 기본값이 ‘SAMPLE’인 드롭다운에서만 선택하며 현재 선택지는 SAMPLE과 TEST입니다. 상태 유형은 미리 구성되며 추가 유형이 필요하면 ‘AllowedTestStatusTypes’에 구성해야 합니다. 여기의 유형은 Test 수준보다 하위여야 하므로 하나의 ID에 여러 Test가 있을 수 있는 Result, Analysis, Panel, Accession 등은 사용할 수 없습니다. Status Name은 필수이자 고유한 문자열이며 최대 50자이고 공백으로 구분된 여러 단어를 사용할 수 있습니다. Description은 선택 사항인 고유 문자열이며 최대 200자입니다. Active, Result Required, Approval Required는 모두 ‘Yes’ 또는 ‘No’를 선택하는 필수 라디오 필드이며 기본 선택값은 없습니다. Approval Required는 Validation 페이지의 승인 없이 검사 상태 데이터를 동기화해야 할 때 사용할 수 있으나 이 스토리의 범위에는 포함되지 않습니다. 페이지의 Next와 Previous는 비활성화됩니다. Exit는 목록 페이지로 돌아가며 Save는 앞의 검증을 수행한 뒤 폼을 백엔드로 제출합니다. 비즈니스 계층은 StatusName과 Description의 고유성을 확인합니다. 중복 값이면 레코드를 생성하지 않고 ‘An error occurred while updating.’ 오류를 표시합니다. 성공하면 clinlims.type_of_test_status 테이블에 새 레코드를 만들고, 검사 상태 ID가 표시되는 같은 페이지에 머물거나 다시 이동하여 추가 수정 후 재제출할 수 있습니다. 이때 Next/Previous 버튼이 활성화됩니다.

1. 목록 페이지에서 수정할 상태 유형을 선택한 뒤 ‘Type Of Test Status’ 메뉴 페이지의 ‘Edit’ 버튼을 클릭하면 Edit Type of Test Status 페이지로 이동합니다. 수정 화면에서 Type of Test status는 null이 아닌 텍스트입니다. 기존 상태 유형의 수정 내용을 제출할 때도 앞에서 설명한 모든 편집 가능 필드 검증이 적용됩니다. 제출에 성공하면 clinlims.type_of_test_status 테이블의 데이터가 갱신되고 목록 페이지로 이동합니다.

1. flagForShowingTestStatus라는 새 플래그가 도입되었습니다.

이 플래그는 siteInformation 테이블에 추가되며 true 또는 false로 설정할 수 있습니다. false이면 고객에게 Type of Test Status 드롭다운이 표시되지 않습니다.

위 플래그가 OFF/False일 때의 결과 목록 화면:

플래그가 ON/True일 때의 결과 목록 화면:

1. 사용자가 ELIS에 로그인하고 오늘 수집된 검체를 클릭하여 결과를 입력합니다. 작업 영역에는 결과 입력, 결과 승인, 인쇄의 세 가지 옵션이 표시됩니다. 결과 입력을 선택하면 결과 입력 폼으로 이동합니다. 사용자가 가장 먼저 선택할 새 필드 ‘Test Status’가 나타나며 기본값은 비어 있습니다. 검사 상태를 선택하지 않으면 결과, 비정상, 의뢰 사유, 기관의 네 필드로 구성된 결과 영역은 현재와 동일하게 표시됩니다.

Test Status 드롭다운에는 고객 요구에 따라 이미 구성된 활성 검사 상태만 모두 표시되어야 합니다.

1. 사용자가 검사 상태 드롭다운에서 결과가 필요하지 않도록 구성된 옵션(type_of_test_status.isResultRequired=N)을 선택하면 결과 영역이 회색으로 비활성화됩니다. Tab 키로도 결과를 입력할 수 없고 관련 파일 업로드만 허용됩니다. 선택한 상태에 관한 추가 메모를 입력할 수 있도록 메모 영역이 활성화됩니다. 메모는 선택 사항이므로 입력하지 않아도 제출할 수 있습니다. 검사 상태를 기본값/빈 값으로 되돌리면 결과 영역이 다시 활성화됩니다.

1. 검사 상태를 선택하여 폼을 제출하면 clinlims.test_status 테이블에서 검사 상태가 해당 검사에 매핑되어야 합니다.

1. 이미 저장된 검사 상태를 수정하려는 사용자는 적절한 작업 버튼을 클릭하여 결과 입력 페이지로 이동합니다. 저장된 검사 상태 유형의 result required 값이 다음과 같으면 페이지를 불러올 때 결과 영역을 비활성화해야 합니다.

‘N’.

1. 사용자가 결과를 입력하여 제출한 뒤 잘못 입력했음을 알고 검사 상태를 선택해 수정하는 경우, 검사 상태와 함께 폼을 제출하면 기존 결과가 데이터베이스(clinlims.result, clinlims.test_result)에서 삭제되어야 합니다. 결과가 null이 아닌 값에서 null로 바뀌므로 메모 입력은 필수입니다.
   

1. 결과 입력 페이지에서 검사가 외부 의뢰된 경우 사용자는 적절한 옵션으로 이를 표시합니다. 외부 의뢰 시 현재 결과 영역이 비활성화되며 검사 상태 필드도 비활성화되어야 합니다.
   

1. 결과 입력 페이지를 불러올 때 검사가 외부 의뢰로 표시되어 있으면 검사 상태 필드는 계속 비활성화됩니다.
   

1. 결과 입력 페이지에서 결과 입력을 허용하도록 구성된 옵션(type_of_test_status.isResultRequired=Y)을 선택하면 결과 영역은 회색으로 표시되거나 비활성화되지 않아야 합니다. 선택한 상태에 관한 추가 메모를 입력할 수 있도록 메모 영역이 활성화되지만 메모 없이도 폼을 제출할 수 있습니다. 주로 성공 또는 부분 성공 검사에 사용되며 검사 상태와 함께 결과도 입력할 수 있어야 합니다.

범위 제외:

1. 검사 상태를 OpenMRS로 다시 동기화하는 기능은 이 스토리의 범위에 포함되지 않습니다.

커뮤니티 승인을 받은 가정:

1. Validation 페이지에는 Test Status가 없어도 됩니다. 고객이 검증/승인 페이지에 정보를 표시해야 한다면 편집할 수 없는 텍스트로 보여야 합니다. 기술자가 상태를 수정하려면 검사를 반려한 뒤 결과 입력 페이지에서 올바른 상태를 다시 입력해야 합니다.