ArcGIS Survey123에서는 다양한 XLSForm 사양이 지원됩니다. 이 참조 가이드에는 Survey123에서 사용할 수 있는 XLSForm 기능이 요약되어 있습니다. 현장조사는 Survey123 Connect 또는 Survey123 웹사이트에서 생성할 수 있습니다. 몇몇 기능은 한 곳에서만 제공되며 또 다른 몇몇 기능은 Survey 123 Connect와 Survey123에서 모두 사용 가능합니다.
질문 유형
다음 테이블에서는 Survey123 Connect, Survey123 현장 앱, Survey123 웹 디자이너, Survey123 웹 앱에서 사용할 수 있는 질문 유형에 대해 설명합니다. 일부 질문의 경우 플랫폼 간 동작 및 구현에 차이가 있으며, 이러한 차이점은 테이블 뒤의 메모를 참조하세요.
| Survey123 Connect 질문 유형 | Survey123 웹 디자이너 질문 유형 | 설명 | Survey123 현장 앱에서 지원됨 | Survey123 웹 앱에서 지원됨 |
|---|---|---|---|---|
| 오디오⁴ | 오디오⁴ ⁶ | 현장 앱에서 오디오 클립을 녹음합니다. 오디오 클립을 녹음하거나 웹 앱에서 업로드된 오디오 파일을 사용합니다. | 예 | 예 |
| 바코드 | 바코드 또는 QR 코드를 스캔합니다. | 예 | 예 | |
| 그룹 시작 | 질문 그룹을 시작합니다. | 예 | 예 | |
| 반복 시작 | N/A | 일련의 반복 질문을 시작합니다. | 예 | 예 |
| 계산 | N/A | 양식의 값에 대해 계산을 수행합니다. 계산 필드에는 계산 결과가 포함됩니다. | 예 | 예 |
| 소수¹ | 소수 입력입니다. | 예 | 예 | |
| 날짜 | 날짜 입력입니다. | 예 | 예 | |
| 날짜 및 시간 | 날짜와 시간 입력입니다. | 예 | 예 | |
| deviceid | N/A | 현장조사가 수행된 특정 기기를 나타내는 UUID입니다. | 예 | 아니요 |
| 이메일² | N/A | 기관 계정으로 로그인하는 경우 이 질문에는 계정 이메일 주소가 자동으로 채워집니다. | 예 | 예 |
| 종료 | N/A | 현장조사 종료일과 시간입니다. | 예 | 예 |
| 그룹 종료 | 질문 그룹을 종료합니다. | 예 | 예 | |
| 반복 종료 | N/A | 일련의 반복 질문을 종료합니다. | 예 | 예 |
| 파일 | 기기의 파일을 사용할 수 있습니다. | 예 | 예 | |
| 지오포인트³ | 제공된 GPS 좌표를 수집합니다. 기본값은 현재 위치입니다. | 예 | 예 | |
| 지오쉐이프³ | 맵에서 폴리곤을 수집합니다. | 예 | 예 | |
| 지오추적³ | 맵에서 라인을 수집합니다. | 예 | 예 | |
| 숨김 | N/A | 양식에 표시되지 않는 피처 레이어 필드를 생성합니다. 이 필드의 데이터 스키마는 bind::esri:fieldType 및 bind::esri:fieldLength 열을 사용하여 지정합니다. | 예 | 예 |
| 정수¹ | 정수 입력입니다. | 예 | 예 | |
| 이미지 | 기기의 파일에서 가져온 이미지 또는 직접 촬영한 사진을 사용할 수 있습니다. | 예 | 예 | |
| 메모 | 화면에 텍스트를 표시합니다. 비고는 숨겨진 계산을 처리할 수도 있습니다. | 예 | 예 | |
| 범위 | 슬라이더⁶ | 지정된 숫자 범위의 입력입니다. | 예 | 예 |
| rank list_name | 순위 질문으로, 선택 항목을 순위대로 나열할 수 있습니다. list_name을 선택 목록의 이름으로 바꿉니다. | 예 | 예 | |
| select_one list_name | 선다형 질문으로, 한 개의 답변만 선택할 수 있습니다. list_name을 선택 목록의 이름으로 바꿉니다. | 예 | 예 | |
| select_one_from_file file_name.csv | N/A | 선다형 질문으로, 한 개의 답변만 선택할 수 있습니다. file_name.csv를 선택 항목의 목록이 포함된 현장조사의 미디어 폴더에 있는 파일 이름으로 바꿉니다. | 예 | 예 |
| select_multiple list_name | 선다형 질문으로, 여러 개의 답변을 선택할 수 있습니다. list_name을 선택 목록의 이름으로 바꿉니다. | 예 | 예 | |
| select_multiple_from_file file_name.csv | N/A | 선다형 질문으로, 여러 개의 답변을 선택할 수 있습니다. file_name.csv를 선택 항목의 목록이 포함된 현장조사의 미디어 폴더에 있는 파일 이름으로 바꿉니다. | 예 | 예 |
| 시작 | N/A | 현장조사 시작일과 시간입니다. | 예 | 예 |
| 텍스트 | 주소⁶, 이메일⁶, 여러 줄 텍스트⁵ ⁶, 한 줄 텍스트⁶, 웹사이트⁶ | 텍스트 입력입니다. 정규식이 이메일 및 웹사이트에 적용됩니다. 지오코드 모양은 주소에 적용됩니다. | 예 | 예 |
| 시간 | 시간 입력입니다. | 예 | 예 | |
| 사용자 이름 | N/A | 기관 계정으로 로그인하는 경우 이 질문에는 계정 사용자 이름이 자동으로 채워집니다. | 예 | 예 |
¹웹 디자이너에서는 정수 질문과 소수 질문이 숫자라는 단일 질문 유형으로 결합되었습니다. 현장조사 디자이너는 질문 등록정보의 체크 박스를 사용하여 필수 입력을 정의할 수 있습니다.
²Survey123 Connect와 Survey123 웹 디자이너에 제공되는 이메일 질문 유형은 서로 다르게 구현됩니다. Survey123 Connect의 구현에서는 사용자가 로그인한 기관 계정의 이메일 주소로 자동으로 채워지는 반면, Survey123 웹 디자이너의 경우 이메일 주소와 일치하는 형식만 허용되는 텍스트 필드로 구현됩니다.
³지오포인트, 지오추적, 지오쉐이프 질문은 맵이라는 단일 질문 유형으로 결합되었습니다. 현장조사 디자이너는 질문 등록정보의 체크 박스를 사용하여 필수 입력을 정의할 수 있습니다. 주소라는 추가 질문 유형을 사용하면 지오코딩된 포인트를 제출할 수 있습니다.
⁴오디오 질문은 웹 앱에서와 같이 Survey123 현장 앱에서 업로드할 수 없습니다. 현장 앱에서 오디오 업로드를 허용하려면 파일 질문을 사용합니다.
⁵Survey123 Connect에 있는 일부 모양은 Survey123 웹 디자이너에서 개별 질문 유형으로 제공됩니다. 여기에는 여러 줄 텍스트, 드롭다운, 리커트 척도가 해당됩니다.
⁶웹 디자이너는 각 질문에 대해 답변 캐싱 옵션을 제공합니다. 웹 앱에서 현장조사 레코드를 제출한 후 질문에 대한 답변이 브라우저에 캐시되며 기기에서 이 현장조사에 대해 작성된 이후 제출 항목에 답변을 미리 불러옵니다. 답변 캐싱은 오디오, 이미지, 파일 업로드, 시그니처를 제외한 모든 질문 유형에 설정할 수 있습니다.
기본값
대다수 질문 유형의 경우 현장조사를 불러올 때 자동으로 사용되는 기본 답변을 정의할 수 있습니다. 이 기능은 XLSForm의 기본 열과 비슷한 용도입니다.
데이터 유효성 검사
편집 탭에서 이 항목은 필수 질문임을 선택한 경우 해당 설문조사 질문은 질문에 값이 포함되어 있는 경우에만 양식을 완성할 수 있습니다.
대부분의 질문에는 최소 및 최대 길이를 설정할 수 있는 기능도 있습니다. 이 기능을 사용하면 질문의 답변이 정의된 제한 길이 내에 속하지 않으면 현장조사가 제출되지 않도록 할 수 있습니다. 해당 기능은 Survey123 XLSForm 사양의 제약 조건 또는 bind::esri:fieldLength 열과 같은 역할을 합니다.
특수 문자
질문 이름 및 선택 이름은 공백, 쉼표, 하이픈, 괄호, 중괄호 같은 특수 문자 또는 $, %, # 등의 문자를 포함할 수 없습니다. 선다형 질문의 선택 이름에는 공백이나 쉼표가 포함되지 않는 것이 중요합니다.