선다형

Survey123에서는 단답형(하나의 답만 선택), 선다형(여러 답 선택), 순위(선택 항목을 순위대로 나열) 질문이 지원됩니다.

비고:

순위 지정 질문은 현재 현장 앱과 웹 앱에서만 지원됩니다.

선다형 질문을 작성할 때는 선택 항목 워크시트를 Excel 워크북에 추가해야 합니다. 아래에는 단답형 질문의 예시가 나와 있습니다.

현장조사 워크시트의 목록 이름인 yes_no는 선택 항목 워크시트의 목록 이름과 일치해야 합니다. 그래야 양식에서 특정 질문에 대한 올바른 답 선택 목록이 표시됩니다.

기본 설정에 따라 현장조사가 발행되면 단답형 질문의 선택 항목이 현장조사의 피처 레이어에 코드 값 도메인으로 추가됩니다. 발행 프로세스 중에 도메인 생성을 비활성화할 수 있습니다. 자세한 내용은 발행 옵션을 참고하세요.

주의:

다음은 중복 선택 이름이 포함된 선택 목록을 사용할 경우의 제한 사항입니다.

• 선다형 질문에는 중복 선택 이름이 지원되지 않습니다.
• 중복 선택 이름은 다국어 현장조사에서 지원되지 않습니다.
• 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}')

모양

모양 열을 숨김으로 설정하면 선택 질문이 드롭다운 메뉴로 표시됩니다.

모양을 가로로 설정하면 단답형 질문에 대한 선택 항목은 같은 너비의 열에 가로로 표시됩니다.

축소 모양은 가로 모양과 비슷하지만 열 너비를 결정하는 데 다른 방법을 사용하여 선택 항목이 공간을 덜 차지하도록 만들 수 있습니다.

비고:

Survey123 Connect에서 하이픈으로 구분되는 숫자를 제공하여 축소 모양의 최대 열 수를 지정할 수 있습니다. 예를 들어, 축소 3은 현장 앱 또는 웹 앱에서 사용되는 현장조사에서 선다형 질문의 열 수를 최대 3개로 제한합니다.

축소 및 가로-축소 모양은 동일합니다. Survey123 웹 앱에서 이러한 모양은 열을 사용하는 대신 선택 질문의 선택 항목 레이블을 추가 간격 없이 행에 나란히 맞춥니다.

단답형 질문의 경우, 모양 열을 리커트로 설정하면 선택 항목이 리커트 척도로 표시됩니다. 리커트 척도란 응답자가 질문 내용에 대한 대칭적 동의-반대 척도에서 자신의 동의 수준을 지정할 수 있는 등급 척도입니다.

모양을 자동 완성으로 설정하면 선택 질문이 텍스트 필드와 드롭다운 메뉴로 표시됩니다. 필드에 텍스트를 입력하면 드롭다운 메뉴가 해당 텍스트가 포함된 답변으로 제한됩니다. 이 설정은 선택 목록이 매우 긴 경우에 유용합니다.

비고:

선다형 질문에 대한 자동 완성 모양은 Survey123 Mobile에서만 지원됩니다. 현장 앱 또는 웹 앱에서는 지원되지 않습니다.

모양을 검색으로 설정하면 현장조사 미디어 폴더의 CSV 테이블 또는 기존 피처 레이어나 테이블 값으로 선택 질문의 선택 항목 목록을 채울 수 있습니다. 자세한 내용은 검색 모양을 사용하여 동적 선택 항목 목록 생성을 참고하세요.

모양을 이미지-맵으로 설정하면 SVG 파일을 사용하여 선택 가능한 영역이 선택지로 포함된 이미지로 선택 질문을 현장 앱에 표시할 수 있습니다. 자세한 내용은 SVG 파일 사용을 참고하세요

검색 모양을 사용하여 동적 선택 항목 목록 생성

비고:

이 섹션에서는 Survey123 Connect 및 Survey123 현장 앱에서만 사용할 수 있는 기능을 설명합니다. 이 기능은 Survey123 Studio 또는 Survey123 Mobile에서는 사용할 수 없습니다.

단답형 및 선다형 질문에서는 검색 모양을 지원하며, 이 모양을 사용하면 현장조사의 미디어 폴더에 있는 CSV 테이블이나 기존 피처 레이어 또는 테이블의 값으로 선택 항목 목록을 채울 수 있습니다. 검색 모양을 사용할 경우 선택 워크시트에 항목을 계속 포함해야 하지만 각 선택 항목을 나열하는 대신 기존 피처 레이어 또는 테이블의 필드 이름을 참조합니다.

다음 예시에서는 us_states라는 선택 목록이 선택 워크시트에 정의되어 있으며, 선택 이름과 레이블 모두에 STATE_NAME 필드를 사용합니다.

다음 예시에서 이 선택 목록은 다른 선택 목록과 동일한 방식으로 현장조사 워크시트에서 참조되지만 선택 항목을 검색할 기존 피처 레이어를 참조하는 검색 모양 식이 포함됩니다.

검색 모양 식은 변수를 쉼표로 구분하여 다음과 같은 방식으로 구성해야 합니다.

search(tableName, searchType, searchColumn, searchText, filterColumn, filterText)

tableName 매개변수는 현장조사 media 폴더의 .csv 파일 이름(예시: airports) 또는 내부적으로 테이블을 참조하기 위해 Survey123 이름이 앞에 오는 피처 레이어 또는 맵 서비스 레이어의 URL을 허용합니다. 이 테이블 이름이 호스팅 레이어 이름과 일치할 필요는 없지만 Survey123에서 내부적으로 검색을 참조하는 방식이므로 현장조사에 사용된 다른 모든 테이블 이름 및 .csv 파일과 달라야 합니다. 필요한 경우 쿼리 요청 매개변수를 피처 레이어의 REST 엔드포인트에 추가하거나 서비스 레이어를 매핑하여 검색 동작을 구성할 수 있습니다. 다음 예시에서는 피처 레이어 URL이 resultRecordCount 매개변수와 함께 추가되어 처음 10개의 쿼리 결과로 선택 목록을 채우며, 검색 결과는 airports라는 이름으로 내부에 저장됩니다.

"airports?url=https://services1.arcgis.com/e7dVfn25KpfE6dDd/arcgis/rest/services/Airports2/FeatureServer/0&resultRecordCount=10"

선택 목록은 WHERE 식을 사용하여 필터링할 수도 있습니다. 다음 예시를 tableName으로 사용하는 경우 선택 목록이 앨라배마주 또는 알래스카주 외의 주만 표시하도록 필터링됩니다.

"state?url=https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/USA_States_Generalized_Boundaries/FeatureServer/0&where=STATE_NAME
NOT IN('Alabama', 'Alaska')"

비고:

현장조사를 Survey123 웹 앱에서 사용하려는 경우, 특수 문자가 포함된 검색 매개변수를 인코딩해야 합니다. 인코딩하면 특수 문자(식의 와일드카드 등)가 퍼센트 기호(%)와 그 뒤에 오는 해당 문자의 16진수 값으로 대체됩니다.

다음 추가 매개변수는 선택 사항이지만 검색에서 제공하는 결과 범위를 좁히는 데 사용할 수 있습니다.

매개변수	설명
searchType	수행되는 검색 유형을 제어하고 검색 중인 테이블이 피처 레이어 내의 공간 테이블인지 아니면 CSV 또는 피처 테이블의 비공간 테이블인지에 따라 다른 값을 허용합니다. 공간 테이블의 경우 허용되는 검색 유형은 intersects, contains, crosses, envelope_intersects, index_intercepts, overlaps, touches, within입니다. 자세한 내용은 공간 관계를 참고하세요. 비공간 테이블의 경우 지원되는 검색 유형은 contains, startswith, endswith, matches입니다.
searchColumn	searchText 매개변수의 텍스트를 검색할 열을 결정합니다. 이러한 열은 테이블 자체에서 가져옵니다. 또한 피처 레이어의 공간 테이블은 @geopoint, @geotrace, @geoshape 열을 검색할 수 있습니다.
searchText	searchColumn 매개변수에서 검색하고 반환할 텍스트를 포함합니다.

또한 다음 필터 매개변수를 검색 식에 추가하여 선택 목록 값을 더욱 세부적으로 조정할 수 있습니다.

매개변수	설명
filterColumn	filterText 매개변수에 제공된 텍스트와 일치하는 항목을 검색하도록 열을 설정합니다. 검색 쿼리는 이 텍스트가 포함된 결과만 반환합니다. filterColumn 및 filterText 매개변수는 함께 사용해야 합니다.
filterText	filterColumn 매개변수에 의해 제공된 열에서 검색되는 텍스트입니다. filterColumn 및 filterText 매개변수는 함께 사용해야 합니다.

아래의 검색 식 예시에는 검색 모양의 선택적 매개변수 중 일부가 포함되어 있습니다. 이전 질문을 검색 텍스트로 사용하여 .csv 파일 콘텐츠로 선택 목록을 채웁니다.

search('csvName', 'matches', 'breed', ${DogQuestion})

비고:

검색 모양이 있는 질문은 자동 완성 모양이 있는 선택 질문과 동일한 방식으로 Survey123 웹 앱에 제공됩니다.

기타 지정

선다형 질문의 경우 현장조사에 원하는 선택 항목이 나열되어 있지 않을 때 기타 항목을 선택할 수 있는 옵션이 포함될 수 있습니다. 이 경우 응답자에게 기타 옵션을 지정하라는 메시지가 나타날 수 있습니다. 수동 방법 또는 빌트인 방법을 사용하여 XLSForm에서 이와 같이 할 수 있습니다. 빌트인 방법은 수동 방법에 비해 구성이 빠르고 편하지만 몇 가지 제한 사항이 있습니다.

수동 방법

수동 방법은 기타 선택 항목의 이름과 레이블 및 기타 응답을 수집하는 텍스트 질문의 이름과 레이블을 지정할 수 있기 때문에 권장합니다. 이러한 이름과 레이블의 번역을 제공할 수 있습니다. 또한 텍스트 질문에 제약 조건 및 모양을 적용하고 필수 항목으로 지정할 수 있습니다.

우선 기타 선택 항목을 선택 항목 워크시트의 질문과 관련된 선택 목록에 추가합니다. 목록의 기타 선택 항목과 마찬가지로 이 선택 항목의 이름과 레이블을 지정합니다. 다음은 색상 선택 목록에 기타라는 이름의 선택 항목이 있는 예시입니다.

현장조사 워크시트에서 텍스트 질문을 추가하여 기타 응답을 수집합니다. 관련성 식을 추가하여 기타 선택 항목이 선택된 경우에만 텍스트 질문이 연관되게 할 수 있습니다. 다음은 단답형 질문의 답이 기타인 경우에 기타 색상(other_color) 질문이 연관되어 있는 예시입니다.

다국어 현장조사의 경우 질문과 선택 항목을 번역할 수 있습니다. 다음은 현장조사 워크시트에서 단답형 질문 및 텍스트 질문에 대한 프랑스어 및 그리스어 번역이 제공된 예시입니다.

선택 항목 워크시트에서는 기타 선택 항목에 대한 번역이 제공됩니다.

빌트인 방법

빌트인 방법에서는 Survey123 Studio 및 Survey123 Connect가 이 방법을 통해 기타 선택 항목 및 질문을 자동으로 생성하여 기타 응답을 수집합니다. 이 방법을 사용하려면 현장조사 워크시트의 유형 열에서 선택 목록 이름 뒤에 or_other를 입력합니다. 기타 선택 항목이 질문에 대한 선택 목록에 표시됩니다. 기타 선택 항목을 선택하면 기타 지정 질문이 표시되어 사용자가 답변을 입력할 수 있습니다. 이 답변을 저장하기 위해 Survey123 Studio 및 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 Studio, Survey123 Connect, Survey123 Mobile, 현장 앱에만 표시됩니다.

외부 선택 목록에 질문을 포함하려면 select_one_from_file 또는 select_multiple_from_file 질문 유형 다음에 .csv 파일 이름을 입력하세요(예시: select_one_from_file CoverType.csv). 파일 이름은 대소문자를 구분하며 공백이 허용되지 않습니다.

다음과 같은 두 가지 방법으로 .csv 파일을 포함할 수 있습니다. 파일을 현장조사의 media 폴더에 저장하거나 ArcGIS에서 호스팅하는 .csv 파일에 연결합니다.

팁:

선택 항목 워크시트의 선택 목록을 .csv 파일로 마이그레이션하는 작업을 자동화하려면 선택 목록을 CSV로 변환 도구를 실행합니다.

.csv 파일 연결

비고:

이 섹션에서는 Survey123 Connect 및 Survey123 현장 앱에서만 사용할 수 있는 기능을 설명합니다. 이 기능은 Survey123 Studio 또는 Survey123 Mobile에서는 사용할 수 없습니다.

현장조사에 ArcGIS 콘텐츠의 .csv 파일을 연결하려면 다음을 수행합니다.

1. .csv 파일이 ArcGIS Online 또는 ArcGIS Enterprise에 호스팅되어 있으며 현장조사와 동일한 공유 권한으로 설정되어 있는지 확인합니다.
2. 콘텐츠 연결을 시도하기 전에 현장조사가 ArcGIS에 발행되었는지 확인합니다.
3. Survey123 Connect에서 현장조사를 열고 연결된 콘텐츠 탭을 클릭합니다. 콘텐츠 연결 버튼을 클릭하고 CSV를 선택한 후 연결하려는 .csv 파일을 찾아 선택합니다.

연결된 .csv 파일의 선택 항목을 양식 미리 보기에 표시하려면 Survey123 Connect의 연결된 콘텐츠 탭에서 다운로드 버튼 을 클릭합니다. 이렇게 하면 현장조사의 미디어 폴더에 .csv 파일 복사본이 저장됩니다. 연결된 파일은 현장 앱의 현장조사와 함께 자동으로 다운로드됩니다.

현장조사의 미디어 폴더에 .csv 파일을 수동으로 저장한 후 나중에 ArcGIS에 같은 이름의 .csv 파일을 업로드하고 현장조사에 연결하면 현장조사의 .csv 파일은 연결된 콘텐츠로부터 업데이트됩니다(더 최신일 경우).

선택 목록을 CSV로 변환

비고:

이 섹션에서는 Survey123 Connect 및 Survey123 현장 앱에서만 사용할 수 있는 기능을 설명합니다. 이 기능은 Survey123 Studio 또는 Survey123 Mobile에서는 사용할 수 없습니다.

선택 항목 워크시트의 지정된 선택 목록을 미디어 폴더의 새 .csv 파일로 자동으로 마이그레이션하려면 Survey123 Connect에서 선택 목록을 CSV로 변환 도구를 실행합니다. 또한 이 도구는 현장조사 워크시트의 해당 질문이 select_one_from_file 및 select_multiple_from_file 질문 유형을 사용하도록 수정합니다.

도구를 실행하려면 다음을 수행합니다.

1. 도구를 실행할 수 있도록 Survey123 Connect에서 Python 환경을 구성합니다. 자세한 내용은 Python 구성을 참고하세요.
2. 현장조사의 XLSForm을 엽니다. 선택 항목 워크시트에서 esri_tool_convert_csv 열을 추가합니다. 외부 선택 목록으로 변환하려는 각 선택 목록의 하나 이상의 행에 yes 값을 추가합니다. 파일을 저장한 후 닫습니다.
3. 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