Diary (일지)
일지(Diary)는 참여자가 정해진 빈도로 반복해서 작성하는 양식입니다. 매일, 매주, 또는 특정 주기마다 증상, 활동, 복약 상태 등을 기록하여 시간에 따른 변화를 추적합니다. 임상시험에서 참여자의 상태를 지속적으로 모니터링하고 데이터를 수집하는 데 필수적인 도구입니다.
일지는 동의서나 설문과 달리 반복 작성이 핵심입니다. 연구 기간 동안 정해진 일정에 따라 여러 번 작성하며, 각 작성 시점마다 참여자의 상태를 기록합니다. 이를 통해 연구자는 증상의 변화 추이, 치료 효과, 부작용 발생 패턴 등을 시계열로 분석할 수 있습니다.
이 문서에서는 일지 양식을 만들고 설정하는 방법을 안내합니다. 여러 필드(Field)를 추가하여 사용자의 필요에 맞는 일지 양식을 완성할 수 있습니다.
양식 화면은 필드 목록 영역과 설정 영역으로 나누어집니다. 좌측에서는 추가할 필드를 선택하고, 우측에서는 선택한 필드의 상세 설정을 관리합니다.
필드 추가
왼쪽 필드 목록에서 원하는 항목을 선택하여 양식을 설정할 수 있습니다. 필드를 추가하려면 해당 필드를 클릭하거나 드래그하여 양식에 배치합니다.
일지에서는 날짜, 시간, 증상 기록, 복약 여부 등 다양한 유형의 필드를 사용할 수 있습니다. 매일 반복 작성해야 하므로 간결하고 직관적인 필드를 선택하는 것이 중요합니다. 너무 많은 질문은 참여자의 작성 부담을 증가시켜 데이터 품질을 저하시킬 수 있습니다.
필드 목록
일지 양식에 사용 가능한 필드 목록과 각 항목의 설명입니다.
Text 필드는 간단한 단일 텍스트 입력 필드를 제공합니다. 증상 요약, 복용한 약물명 등 짧은 답변을 받을 때 사용합니다.
Text Area 필드는 여러 줄의 텍스트를 입력받을 수 있는 필드입니다. 상세한 증상 설명, 특이사항 기록 등 긴 서술이 필요한 경우에 적합합니다.
Select 필드는 드롭다운 형식으로 단일 옵션을 선택할 수 있습니다. 여러 선택지 중 하나만 선택해야 하는 경우에 사용하며, 화면 공간을 절약할 수 있습니다.
Checkbox 필드는 여러 옵션 중 원하는 항목을 복수 선택할 수 있습니다. 경험한 증상을 모두 선택하거나 복용한 약물을 모두 체크하는 경우에 사용됩니다.
Radio 필드는 단일 옵션을 선택할 수 있는 원형 버튼 필드입니다. Select와 유사하지만 모든 선택지가 화면에 표시되어 직관적으로 선택할 수 있습니다. "복약 여부: 예/아니오"와 같은 간단한 질문에 적합합니다.
Range 필드는 범위를 조절할 수 있는 슬라이더 필드입니다. 통증 정도를 0부터 10까지의 척도로 평가하는 등 연속적인 수치 입력에 사용합니다.
Date 필드는 날짜를 선택할 수 있는 필드입니다. 모바일 친화적인 MobileDatePicker UI가 적용되어 있어 모바일 기기에서도 편리하게 날짜를 입력할 수 있습니다. 일지 작성 시 보통 자동으로 현재 날짜가 입력되지만, 필요한 경우 수동으로 날짜를 선택할 수 있습니다.
Time 필드는 시간을 선택할 수 있는 필드입니다. 모바일 친화적인 MobileTimePicker UI가 적용되어 있습니다. 복약 시간, 증상 발생 시간 등을 기록할 때 사용합니다.
Datetime 필드는 날짜와 시간을 함께 선택할 수 있는 필드입니다. 모바일 친화적인 MobileDateTimePicker UI가 적용되어 있습니다.
Video 필드는 비디오 파일 또는 링크를 삽입할 수 있습니다. 일지 작성 가이드 영상을 제공하거나 교육 자료를 포함할 때 사용합니다.
Banner 필드는 배너 이미지를 삽입할 수 있습니다. 일지 작성 안내나 중요한 공지사항을 시각적으로 전달할 수 있습니다.
Image Select 필드는 이미지를 선택하거나 첨부할 수 있는 필드입니다. 참여자가 직접 증상 부위를 촬영하거나 복약 인증 사진을 업로드할 때 사용합니다.
필드 설정
Basic Information
추가된 필드는 우측 설정 영역에서 상세하게 설정할 수 있습니다. 각 필드는 다음과 같은 기본 정보를 설정합니다.
Label은 양식 항목의 제목 또는 라벨을 설정합니다. 사용자가 이해하기 쉬운 명칭을 입력합니다. 예를 들어 "오늘 경험한 증상을 선택해주세요"와 같이 명확하게 작성합니다.
Description은 해당 필드에 대한 추가 설명이나 가이드를 제공합니다. 설명을 통해 사용자의 이해를 돕습니다. 예를 들어 "여러 개 선택 가능합니다"와 같은 안내를 추가할 수 있습니다.
WebhookKey는 시스템에서 사용하는 고유 키 값입니다. 특정 이벤트를 구분하는 데 사용되며, 데이터 수집 및 분석 시 식별자로 활용됩니다.
Placeholder는 필드에 입력될 내용을 예시로 표시하는 가이드 텍스트입니다. 사용자가 입력 전 확인합니다. 예를 들어 "예: 두통"과 같이 입력 형식을 안내할 수 있습니다.
Require Validation은 항목에 대한 유효성 검사를 활성화합니다. 이 옵션을 ON으로 설정하면 필수 입력 필드로 설정되어 참여자가 반드시 응답해야 합니다. 일지의 핵심 항목은 필수로 설정하는 것이 좋습니다.
Default Hidden은 해당 필드를 기본적으로 숨김 상태로 설정합니다. ON으로 설정하면 화면에 표시되지 않으며, 특정 조건에 따라 표시되도록 로직을 설정할 수 있습니다.
참고: 필드 유형에 따라 추가적으로 입력해야 할 항목이 있을 수 있습니다.
예시: Radio 필드의 경우 선택 옵션을 설정해야 합니다.
필드 순서 변경
Drag & Drop 기능을 사용하여 필드의 순서를 간편하게 변경할 수 있습니다. 필드를 클릭한 상태로 드래그하여 원하는 위치로 이동하면 순서가 변경됩니다. 일지는 매일 작성하므로 논리적이고 직관적인 순서로 배치하여 작성 부담을 줄이는 것이 중요합니다.
필드 로직 설정
필드 간 로직 설정을 통해 다양한 형태의 일지를 구성할 수 있습니다. 항목 작성 상태에 따라 다음 항목의 표시 여부 및 흐름을 제어할 수 있습니다. 이를 통해 응답자에게 관련된 질문만 표시하여 일지 작성 경험을 개선할 수 있습니다.
사용 예시: 조건부 표시
예를 들어 참여자가 특정 증상을 선택하면 해당 증상에 대한 상세 질문이 표시되도록 설정할 수 있습니다. 이를 통해 불필요한 질문을 건너뛰고 효율적인 일지 작성이 가능합니다.
예시 로직:
- 질문 A: "오늘 두통이 있었습니까?"
- 응답이 '예' → 질문 B: "두통의 정도를 0-10 척도로 평가해주세요"
- 응답이 '아니오' → 질문 C: "다음 질문으로 이동"
이러한 로직 설정을 통해 응답자의 상황에 맞는 질문만 표시되므로 일지 작성 시간을 단축하고 데이터 품질을 향상시킬 수 있습니다.
필드 미리보기 (Participant's View)
우측 하단에는 일지 대상자가 보는 미리보기 화면이 제공됩니다. 이를 통해 양식 생성 및 로직 설정 결과를 사전에 확인할 수 있습니다.
미리보기 기능을 활용하면 양식 생성 및 로직 설정의 결과를 즉시 확인할 수 있습니다. 참여자 입장에서 일지가 어떻게 보이는지, 로직이 의도대로 작동하는지 점검할 수 있습니다. 일지는 반복 작성되므로 작성 흐름이 자연스럽고 효율적인지 사전에 확인하는 것이 매우 중요합니다.
사용 방법
양식 빌더 화면에서 필드를 설정한 후, 화면 우측 하단의 미리보기 버튼을 클릭합니다. 미리보기 화면에서 양식과 로직의 동작을 확인하고, 필요한 경우 수정합니다.
참고: 일지 작성 시 대상자에게 항목당 한 페이지씩 화면이 표시됩니다. 각 질문마다 화면을 넘기며 응답하므로 모바일 환경에서도 편리하게 작성할 수 있습니다.
양식 설정
상단 Function 기능을 통해 Journal Settings, Settings 등 전체 양식의 설정을 관리할 수 있습니다. 일지는 반복 작성되는 특성상 Journal Settings가 매우 중요합니다.
JOURNAL SETTINGS 탭에서는 일지의 작성 빈도, 횟수, 유효기간 등을 설정합니다. 이 설정에 따라 참여자가 일지를 작성할 수 있는 시점과 횟수가 결정됩니다.
SETTING 탭에서는 양식의 이름, 버전, Site Mapping 등 상세 설정을 관리합니다. 양식을 어느 연구 기관에 적용할지 매핑하는 작업도 이곳에서 진행합니다.
JOURNAL SETTINGS
일지 설정은 총 작성 횟수, 빈도, 시작일, 유효기간 등을 설정하여 일지 작성의 기준을 정의하는 기능입니다. 이 설정은 일지의 핵심으로, 연구 계획에 맞게 정확히 설정해야 합니다.
횟수는 총 일지 작성 횟수를 설정합니다. 제한 옵션을 선택하면 입력 값에 따라 횟수를 제한할 수 있습니다. 예를 들어 28회로 설정하면 28번만 작성할 수 있습니다. 무제한 옵션을 선택하면 제한 없이 일지를 작성할 수 있습니다.
빈도는 일지 작성의 빈도를 설정합니다. 시작일을 기준으로 적용되며, 입력 값 단위는 D(일), W(주), M(월)입니다. 예를 들어 "1D"로 설정하면 매일, "2W"로 설정하면 2주마다 작성합니다. 개별 옵션을 선택하면 항목별로 빈도를 개별 설정할 수 있고, 자율 옵션을 선택하면 빈도 설정 없이 자유롭게 작성할 수 있습니다.
허용기간은 일지 작성 시점을 기준으로 허용 기간을 설정합니다. 입력값은 일 단위이며, 설정된 기간이 지나면 작성이 불가능합니다. 예를 들어 허용기간을 1일로 설정하면 해당 일지의 작성일로부터 1일 내에만 작성할 수 있습니다.
후기 일지 작성 가능 여부는 허용 기간 이후에도 일지 작성이 가능한지 설정합니다. 체크하면 허용 기간이 지난 후에도 일지를 작성할 수 있습니다. 지연 사유 설정이 존재하는 경우에만 지연 사유가 필수 입력 항목으로 변경되어, 늦게 작성하는 이유를 기록할 수 있습니다.
시작일은 기준일로부터 며칠 뒤 시작할지 설정합니다. 기준은 참여자에게 양식이 매핑된 날이며, 입력 값 단위는 D(일), W(주), M(월)입니다. 예를 들어 "3D"로 설정하면 매핑 후 3일 뒤부터 일지 작성이 시작됩니다.
유효기간은 양식을 작성할 수 있는 유효기간을 설정합니다. 유효기간 이후에는 양식 작성이 불가능합니다. 입력 방식은 시작일부터 종료일을 지정합니다. 예를 들어 연구 기간이 90일이면 시작일로부터 90일 후를 종료일로 설정합니다.
지연사유 설정은 시스템 연동시 일지작성 지연시 사용할 사유를 Value와 Label값으로 전달 됩니다. 사유 추가 텍스트 입력 여부를 선택하게 되면 지연사유가 발생하게되면 사유를 추가적으로 텍스트로 작성하게 됩니다.
수정사유 설정은 시스템 연동시 일지를 수정하게 되면 해당 값을 Value와 Label값으로 전달 됩니다. 사유 추가 텍스트 입력 여부를 선택하게되면 일지 데이터가 수정시 수정 사유를 추가적으로 작성하게 됩니다.
SETTING
양식의 이름, 버전, Effective Date, Site Mapping 등의 세부 설정을 관리할 수 있습니다. 이 설정은 일지를 실제로 사용하기 전에 반드시 완료해야 합니다.
이름은 일지 양식의 고유한 이름을 설정합니다. 예를 들어 "증상 일지 v1.0"과 같이 일지의 용도와 버전 정보를 포함하여 명명할 수 있습니다.
버전은 일지의 버전 정보를 기록합니다. 일지 내용이 수정될 때마다 버전을 갱신하여 관리할 수 있습니다. 버전 관리는 연구 기간 중 일지 내용 변경을 추적하는 데 중요합니다.
Effective Date는 해당 일지가 유효한 기간을 설정합니다. 특정 날짜부터 유효하거나 특정 날짜까지만 사용할 수 있도록 제한할 수 있습니다.
Site Mapping은 이 일지를 어느 연구 기관에 적용할지 매핑하는 설정입니다. Site Mapping이 되지 않으면 해당 양식을 사용할 수 없으므로 반드시 설정해야 합니다.
위 항목에서 해당 양식을 삭제할 수 있습니다. 삭제 전에는 반드시 양식이 사용 중인지 확인하시기 바랍니다.
각 항목별로 반드시 'SAVE' 버튼을 눌러 저장해 주시기 바랍니다. 저장하지 않으면 입력한 내용이 손실될 수 있습니다.