XLSForm에서는 단답형(select_one)(하나의 답만 선택), 선다형(select_multiple)(여러 답 선택), 순위(선택 항목을 순위대로 나열) 질문이 지원됩니다. 선다형 질문을 작성할 때는 선택 항목 워크시트를 Excel 워크북에 추가해야 합니다. 아래에는 단답형 질문의 예시가 나와 있습니다.
현장조사 워크시트의 yes_no는 선택 항목 워크시트의 목록 이름 열에 있는 yes_no와 일치해야 합니다. 그래야 양식에서 특정 질문에 대한 올바른 답 선택 목록이 표시됩니다.
기본 설정에 따라 현장조사가 발행되면 단답형 질문의 선택 항목이 현장조사의 피처 레이어에 코드 값 도메인으로 추가됩니다. 발행 프로세스 중에 도메인 생성을 비활성화할 수 있습니다. 자세한 내용은 발행 옵션을 참고하세요.
단답형 질문에 대한 선택 항목을 수정하고 현장조사를 다시 발행할 때 Survey123 Connect에 변경 사항에 대한 요약이 표시되며 해당 변경 사항을 피처 레이어의 도메인에 적용할지 여부를 결정할 수 있습니다. 자세한 내용은 현장조사 업데이트를 참고하세요.
주의:
다음은 중복 선택 이름이 포함된 선택 목록을 사용할 경우의 제한 사항입니다.
- 선다형 질문에는 중복 선택 이름이 지원되지 않습니다.
- 중복 선택 이름은 다국어 현장조사에서 지원되지 않습니다.
- jr:choice-name() 함수는 목록에서 첫 번째 중복 선택 항목의 레이블을 반환합니다.
- 수신함, 임시 저장, 임시 보관함, 발신함, 오버뷰 폴더에서 열면 단답형 질문이 목록의 첫 번째 중복 선택 항목으로 되돌아갑니다.
다음과 같이 여러 답변을 선택할 수 있는 선다형 질문을 추가할 수도 있습니다.
기본 설정에 따라 이러한 선택 항목은 선택 항목 워크시트에 제공된 순서대로 나타납니다. 이 기본 설정 대신 매개변수 열에 randomize=true를 입력하여 선택 항목이 나타나는 순서를 랜덤화할 수 있습니다.
주의:
선다형(select_multiple) 또는 순위 질문에서 수집된 모든 값은 쉼표로 구분된 목록으로 저장되므로 선택 목록의 이름 열에 쉼표를 사용하지 마세요. 또한 선다형(select_multiple) 또는 순위 질문의 경우 단답형(select_one) 질문에서 제출된 이름 및 레이블이 아닌 선택 항목의 이름만 피처 레이어에 보냅니다.
순위 질문의 값은 사용자가 선택 항목 순서를 수정할 때까지 비어 있습니다. 기본값이 설정되어 있다면 사용자가 선택 항목 순서를 수정하지 않는 한 기본 순서가 적용됩니다.
선다형 질문에 대한 개별 응답은 selected-at 함수를 사용하여 반환할 수 있습니다. 다음의 경우 선다형 질문에 대한 첫 번째 응답의 이름 값이 반환됩니다.
selected-at(${species}, 0)
응답의 레이블을 보내려면 jr:choice-name 함수를 사용합니다. 동일한 선다형 질문에 대한 두 번째 응답의 레이블 값을 얻으려면 다음을 사용하세요.
jr:choice-name(selected-at(${species}, 1), '${species}')
기타 지정
선다형 질문의 경우 현장조사에 원하는 선택 항목이 나열되어 있지 않을 때 기타 항목을 선택할 수 있는 옵션이 포함될 수 있습니다. 이 경우 응답자에게 기타 옵션을 지정하라는 메시지가 나타날 수 있습니다. 수동 방법 또는 빌트인 방법을 사용하여 XLSForm에서 이와 같이 할 수 있습니다. 빌트인 방법은 수동 방법에 비해 구성이 빠르고 편하지만 몇 가지 제한 사항이 있습니다.
수동 방법
수동 방법은 기타 선택 항목의 이름과 레이블 및 기타 응답을 수집하는 텍스트 질문의 이름과 레이블을 지정할 수 있기 때문에 권장합니다. 이러한 이름과 레이블의 번역을 제공할 수 있습니다. 또한 텍스트 질문에 제약 조건 및 모양을 적용하고 필수 항목으로 지정할 수 있습니다.
우선 기타 선택 항목을 선택 항목 워크시트의 질문과 관련된 선택 목록에 추가합니다. 목록의 기타 선택 항목과 마찬가지로 이 선택 항목의 이름과 레이블을 지정합니다. 다음은 색상 선택 목록에 기타라는 이름의 선택 항목이 있는 예시입니다.
현장조사 워크시트에서 텍스트 질문을 추가하여 기타 응답을 수집합니다. 관련성 식을 추가하여 기타 선택 항목이 선택된 경우에만 텍스트 질문이 연관되게 할 수 있습니다. 다음은 단답형 질문의 답이 기타인 경우에 기타 색상(other_color) 질문이 연관되어 있는 예시입니다.
다국어 현장조사의 경우 질문과 선택 항목을 번역할 수 있습니다. 다음은 현장조사 워크시트에서 단답형 질문 및 텍스트 질문에 대한 프랑스어 및 그리스어 번역이 제공된 예시입니다.
선택 항목 워크시트에서는 기타 선택 항목에 대한 번역이 제공됩니다.
빌트인 방법
Survey123 Connect에서는 이 방법을 통해 기타 선택 항목 및 질문을 자동으로 생성하여 기타 응답을 수집합니다. 이 방법을 사용하려면 현장조사 워크시트의 유형 열에서 선택 목록 이름 뒤에 or_other를 입력합니다. 기타 선택 항목이 질문에 대한 선택 목록에 표시됩니다. 기타 선택 항목을 선택하면 기타 지정 질문이 표시되어 사용자가 답변을 입력할 수 있습니다. 이 답변을 저장하기 위해 Survey123 Connect는 선다형 질문 이름 뒤에 _other를 사용하여(예시: favorite_toppings_other) 피처 레이어에 추가 필드를 자동 생성합니다. 다음을 참고하세요.
주의:
기타 지정 질문의 레이블은 영어 이외의 언어로 표시되지 않습니다.
기존 피처 레이어에서 현장조사를 생성하는 경우 기타 지정 질문 필드가 자동으로 생성되지 않고 현장조사가 발행되지 않습니다. 선다형 질문 이름 뒤에 _other를 사용하여(예시: favorite_toppings_other) 피처 레이어에서 수동으로 기타 지정 질문 필드를 생성해야 합니다.
외부 선택 목록
단답형 질문과 선다형 질문의 선택 목록은 외부 .csv 파일에 저장할 수 있습니다. 이 기능은 대형 선택 목록, 여러 선택 목록이 있는 현장조사, Survey123 외부에서 관리되는 선택 목록에 유용합니다. 선택 항목이 추가 워크시트에 나열되어야 하는 외부 선택과 외부 선택 목록을 혼동해서는 안 됩니다.
.csv 파일에는 이름 및 레이블 열이 포함되어야 합니다.
비고:
.csv 파일에 열 머리글이 없거나 파일 행 끝에 후행 쉼표가 있으면 파일을 현장조사로 가져올 수 없습니다.
최상의 결과를 위해, UTF-8 문자 인코딩을 사용하여 .csv 파일을 인코딩합니다. Microsoft Excel을 사용하여 .csv 파일을 생성하는 경우 CSV UTF-8로 저장합니다.
번역된 레이블 열은 .csv 파일에 포함될 수 있지만 번역된 선택 사항은 Survey123 웹 앱이 아닌 Survey123 Connect 및 Survey123 현장 앱에만 표시됩니다.
외부 선택 목록에 질문을 포함하려면 select_one_from_file 또는 select_multiple_from_file 질문 유형 다음에 .csv 파일 이름을 입력하세요(예시: select_one_from_file CoverType.csv). 파일 이름은 대소문자를 구분하며 공백이 허용되지 않습니다.
다음과 같은 두 가지 방법으로 .csv 파일을 포함할 수 있습니다. 파일을 현장조사의 media 폴더에 저장하거나 ArcGIS에서 호스팅하는 .csv 파일에 연결합니다.
팁:
선택 항목 워크시트의 선택 목록을 .csv 파일로 마이그레이션하는 작업을 자동화하려면 선택 목록을 CSV로 변환 도구를 실행합니다.
.csv 파일 연결
현장조사에 ArcGIS 콘텐츠의 .csv 파일을 연결하려면 다음을 수행합니다.
- .csv 파일이 ArcGIS Online 또는 ArcGIS Enterprise에 호스팅되어 있으며 현장조사와 같은 공유 권한을 가지고 있는지 확인합니다.
- 콘텐츠 연결을 시도하기 전에 현장조사가 ArcGIS에 발행되었는지 확인합니다.
- Survey123 Connect에서 현장조사를 열고 연결된 콘텐츠 탭을 클릭합니다. 콘텐츠 연결 버튼을 클릭하고 CSV를 선택한 후 연결하려는 .csv 파일을 찾아 선택합니다.
연결된 .csv 파일의 선택 항목을 양식 미리 보기에 표시하려면 Survey123 Connect의 연결된 콘텐츠 탭에서 다운로드 버튼 
을 클릭합니다. 이렇게 하면 현장조사의 미디어 폴더에 .csv 파일 복사본이 저장됩니다. 연결된 파일은 Survey123 현장 앱의 현장조사와 함께 자동으로 다운로드됩니다.
현장조사의 미디어 폴더에 .csv 파일을 수동으로 저장한 후 나중에 ArcGIS에 같은 이름의 .csv 파일을 업로드하고 현장조사에 연결하면 현장조사의 .csv 파일은 연결된 콘텐츠로부터 업데이트됩니다(더 최신일 경우).
선택 목록을 CSV로 변환
선택 항목 워크시트의 지정된 선택 목록을 미디어 폴더의 새 .csv 파일로 자동으로 마이그레이션하려면 Survey123 Connect에서 선택 목록을 CSV로 변환 도구를 실행합니다. 또한 이 도구는 현장조사 워크시트의 해당 질문이 select_one_from_file 및 select_multiple_from_file 질문 유형을 사용하도록 수정합니다.
도구를 실행하려면 다음을 완료합니다.
- 도구를 실행할 수 있도록 Survey123 Connect에서 Python 환경을 구성합니다. 자세한 내용은 Python 구성을 참고하세요.
- 현장조사의 XLSForm을 엽니다. 선택 항목 워크시트에서 esri_tool_convert_csv 열을 추가합니다. 외부 선택 목록으로 변환하려는 각 선택 목록의 하나 이상의 행에 yes 값을 추가합니다. 파일을 저장한 후 닫습니다.
- Survey123 Connect에서 현장조사를 열고 도구를 클릭한 후 선택 목록을 CSV로 변환을 선택합니다.
변환이 완료되면 마이그레이션한 각 선택 목록에 대해 .csv 파일이 미디어 폴더에 저장됩니다. 파일 이름이 기존 선택 목록 이름 값(list_name 열)과 일치합니다. 선택 항목 워크시트가 마이그레이션되지 않은 나머지 목록만 포함하도록 업데이트됩니다. 원본의 사용자 설정 열 헤더는 계속 포함됩니다. 현장조사 워크시트에서 해당 단답형 및 선다형 질문이 새 외부 선택 목록을 참조하도록 select_one_from_file 및 select_multiple_from_file로 변경됩니다. 기존 선택 항목 워크시트는 결과를 확인하거나 되돌릴 수 있도록 choices_backup 워크시트에 저장됩니다. 백업 워크시트를 유지하거나 삭제할 수 있습니다.
이 도구는 순위 질문, 테이블-목록 그룹 또는 검색 모양이 있는 질문에서 사용되는 선택 목록을 변환하지 않습니다. 해당 선택 목록을 사용하는 질문은 현장조사에서 수정되지 않습니다.
도구에서 지원되지 않는 질문을 감지하는 경우 영향을 받은 선택 목록 이름과 함께 디버그 폴더에 .xlsx 파일이 생성됩니다. 다음 폴더에서 이 파일을 찾을 수 있습니다.
C:\Users\<username>\ArcGIS\My Survey Designs\<surveyName>\debug\convertchoicelists