XLSForm은 양식 작성을 간소화하는 개방형 표준입니다. 양식은 스프레드시트를 사용하여 사람이 읽기 편한 형식으로 작성됩니다. XLSForm에 대한 정보는 https://xlsform.org/를 방문하세요. Survey123은 XLSForm 표준의 피처를 대부분(일부 제외) 지원합니다.
XLSForm 호환 스프레드시트는 여러 가지 도구를 사용하여 작성할 수 있습니다. Microsoft Excel이 가장 일반적으로 사용되지만 Kingsoft Spreadsheets, Google Sheets, OpenOffice Calc도 사용할 수 있습니다. ArcGIS Survey123에 사용할 수 있는 XLSForm 스프레드시트를 내보내는 온라인 XForms 빌더도 사용할 수 있습니다.
ArcGIS Survey123에는 XLS 파일 생성을 위해 XLSForm 작성 도구와 함께 사용할 수 있는 Survey123 Connect 데스크톱 도구가 포함되어 있으며 이러한 도구를 사용하여 양식을 편리하게 작성할 수 있습니다. Survey123 Connect에서는 양식을 작성하거나 편집한 대로 XLSForm 파일을 미리 보고, ArcGIS Online 및 ArcGIS Enterprise에 발행하고, 데이터 수집을 위한 양식 사양을 기반으로 피처 레이어를 생성할 수 있습니다. ArcGIS Survey123 Connect는 Windows에서 사용할 수 있습니다.
양식을 ArcGIS에 발행한 후에는 Survey123 웹사이트를 사용하여 ArcGIS 기관 구성원과 공유할 수 있습니다. 현장조사 결과를 내보낼 뿐 아니라 Survey123 현장 앱을 통해 수집된 데이터의 맵과 테이블을 분석할 수도 있습니다.
이 항목에서는 ArcGIS Survey123 Connect와 Microsoft Excel을 사용하여 양식을 작성하는 것으로 가정합니다.
일반적으로 각 Excel 워크북에는 현장조사와 선택 항목이라는 2개의 워크시트가 있습니다. 필요에 따라 설정이라는 세 번째 워크시트(아래에 설명되어 있음)를 추가할 수도 있습니다. 워크시트에는 양식을 사용하기 위해서 꼭 제공되어야 하는 일련의 필수 열이 있습니다. 또한 각 워크시트에는 양식의 각 항목에 대한 동작을 추가로 제어할 수 있는 일련의 선택적 열도 있습니다. 각 항목의 경우 각 필수 열에 값이 있어야 하며 선택적 열은 비워 둘 수 있습니다. Excel 워크북에 추가한 열은 필수 열이든 선택적 열이든 관계없이 임의의 순서로 나타날 수 있습니다. 선택적 열을 생략하고 행 수를 비워 둘 수 있습니다. 모든 .xls 파일 서식이 무시되므로 분할 라인, 음영, 기타 글꼴 서식을 사용하여 양식의 가독성을 향상시킬 수 있습니다.
현장조사 워크시트
이 워크시트에서는 양식에 대한 전반적인 구조를 제공합니다. 질문에 대한 전체 목록과 질문이 양식에 나타나는 방식에 대한 정보가 포함됩니다. 일반적으로 각 행은 하나의 질문을 나타냅니다. 하지만 UX를 향상시키기 위해 양식에 추가할 수 있는 추가 기능(아래에 설명되어 있음)이 있습니다.
현장조사 워크시트에는 유형과 이름 그리고 레이블 또는 힌트라는 3개의 필수 열이 있습니다.
- 유형 열은 추가하려는 XLSForm 질문의 유형을 지정합니다. 이 열에 사용할 수 있는 질문 유형 목록이 일목요연하게 정의되어 있습니다.
- 이름 열은 질문의 응답이 저장될 피처 레이어 필드의 이름을 지정합니다. 이 열에는 공백이나 특수 문자가 허용되지 않습니다. 이름은 각 레이어에 있는 모든 질문에 대해 고유해야 합니다.
- 레이블 열과 힌트 열에는 질문 텍스트가 포함됩니다. 이 텍스트는 양식에서 보이는 텍스트입니다. 질문에는 레이블이나 힌트가 하나 이상 있어야 합니다. 경고 메시지를 피하려면 레이블을 제공하는 것이 좋습니다. 이러한 열에는 공백과 특수 문자가 허용됩니다. 또는 번역 열을 사용할 수도 있습니다. 또한 레이블과 힌트에는 현장조사에서 다른 질문의 응답으로 대체될 제한된 HTML 코드와 변수가 지원됩니다. 자세한 내용은 비고를 참고하세요.
Survey123이 지원하는 열이 다음 테이블에 모두 포함되어 있습니다. 이러한 열은 고급 템플릿의 현장조사 워크시트에 포함되어 있으며 워크시트에 나타나는 순서대로 이 테이블에 나열됩니다.
| 열 | 설명 |
|---|---|
| 유형 | 제공된 목록에서 질문 유형을 선택합니다. 단답형(select_one)이나 선다형(select_multiple) 질문을 사용할 경우 유효한 목록 이름을 입력합니다. |
| 이름 | 피처 레이어의 필드 이름입니다. |
| 레이블 | 현장조사에 표시되는 질문 레이블입니다. |
| 힌트 | 현장조사 질문에 쉽게 답변할 수 있도록 도와주는 정보입니다. |
| 안내 힌트 | 아이콘을 눌러야 표시되는 추가 정보입니다. |
| 모양 | 현장조사 내 해당 필드의 모양을 선택합니다. |
| 필수 정보 | 현장조사를 완료하기 전에 해당 필드의 값이 필요한 경우 예를 선택합니다. |
| 필수 정보 메시지 | 필수 필드에 대한 응답이 없는 경우 해당 열의 메시지가 표시되어 답변을 요청합니다. |
| 읽기 전용 | 해당 필드의 값을 읽기 전용으로 설정하려면 예를 선택합니다. 이러한 값은 현장조사에서 편집할 수 없습니다. |
| 기본 | 해당 필드의 기본값을 설정합니다. 해당 열은 현장조사를 기본값으로 미리 채웁니다. 따라서 주로 사용되는 답변을 입력하거나 사용할 답변 선택 항목 유형을 표시하여 시간을 절약할 수 있습니다. |
| calculation | 이전 질문의 값을 사용하여 계산을 수행합니다(예시: ${number} * 100). 계산 필드를 참조하여 결과를 표시합니다(예시: The answer is ${calc}). |
| constraint | 입력 가능한 숫자 범위를 제한합니다(예시: .>0 및 .<100). 해당 열은 모든 질문 유형에 사용할 수 있습니다. |
| constraint_message | 제약 조건이 충족되지 않은 경우 해당 메시지가 표시되어 유효한 답변을 요청합니다. |
| relevant | 이렇게 하면 이전 질문에 대한 응답에 따라 질문을 건너뛰거나 추가 질문이 나타나도록 설정할 수 있습니다. 관련 열의 조건을 충족하면 질문이 표시됩니다(예시: ${name} = 'value'). 이 열에 의해 숨겨진 질문은 null 값만 제출합니다. |
| choice_filter | 계단식 선택을 사용하는 경우 해당 필드에는 선택 항목 탭의 추가 속성 열과 일치하는 식이 포함됩니다(예시: attribute = ${value}). |
| repeat_count | 해당 값은 반복에 사용할 수 있는 레코드의 개수를 지정합니다. 반복 개수가 지정된 후에는 레코드를 반복에 추가하거나 반복에서 삭제할 수 없습니다. |
| media::audio | 오디오 파일을 프로젝트의 미디어 하위 폴더로 복사하고 오디오 파일 이름(예시: audio.mp3)을 입력하여 질문에 오디오를 제공할 수 있습니다. |
| media::image | 이미지 파일을 프로젝트의 미디어 하위 폴더로 복사하고 이미지 파일의 이름(예시: image.jpg)을 입력하여 질문에 이미지를 표시할 수 있습니다. |
| bind::type | 질문에 대한 기본 필드 유형을 덮어쓰는 필드 유형입니다. |
| bind::esri:fieldType | 피처 레이어의 대상 필드 유형을 정의합니다. 해당 열은 기본 필드 유형을 덮어쓰는 데 사용할 수 있습니다. 예를 들어 기본 설정에 따라 계산 필드와 단답형 필드가 문자열인 경우 피처 레이어의 값을 정수(Integer)로 저장하려면 esriFieldTypeInteger를 선택합니다. |
| bind::esri:fieldLength | 피처 레이어의 대상 필드 길이를 정의합니다. 해당 열은 기본 필드 길이를 덮어쓰는 데 사용할 수 있습니다. |
| bind::esri:fieldAlias | 피처 레이어의 필드 별칭에 대한 값을 입력합니다. 해당 열은 질문 레이블에서 파생되는 기본 필드 별칭 값을 덮어쓰는 데 사용할 수 있습니다. |
| body::esri:style | 질문 스타일 및 동작(예시: 그룹 및 반복의 배경 색상)을 정의하는 식을 입력합니다. |
| bind::esri:parameters | Survey123에 특정한 질문에 대한 매개변수를 입력합니다(예시: 현장조사 편집 시 반복 동작을 제어하는 매개변수). |
| bind::esri:workflow | 거리 측정기 측정 모드에서 현장조사를 사용할 수 있도록 지원하는 매개변수를 입력합니다. |
| 매개변수 | 질문에 대한 표준 XLSForm 매개변수를 입력합니다(예시: 범위 질문에 대한 start, end, step 매개변수). |
| body::accept | 파일 질문에 허용되는 파일 유형을 설정합니다. 여러 파일 확장자가 쉼표로 구분된 파일 확장자를 허용합니다(예시: .jpg, .png). |
| body::esri:visible | 이렇게 하면 이전 질문에 대한 응답에 따라 질문을 건너뛰거나 추가 질문이 나타나도록 설정할 수 있습니다. body::esri:visible 열의 조건을 충족하면 질문이 표시됩니다(예시: ${name} = 'value'). 이 열에 의해 숨겨진 질문은 계속하여 값을 포함하며 제출합니다. |
| body::esri:inputMask | 문자와 심볼을 사용하여 데이터 입력에 대한 일련의 형식을 제공하는 입력 마스크를 사용할 수 있도록 식을 입력합니다. |
| label::language(xx) | 질문 레이블에 대한 번역을 입력합니다. 언어는 해당 이름과 코드로 지정해야 합니다(예시: label::Español (es)). 각 언어에 대한 새 열을 추가합니다. 언어 목록은 현장조사의 드롭다운 메뉴에서 나타납니다. |
| hint::language(xx) | 질문 힌트에 대한 번역을 입력합니다. 언어는 해당 이름과 코드로 지정해야 합니다(예시: hint::Español(es)). 각 언어에 대한 새 열을 추가합니다. 언어 목록은 현장조사의 드롭다운 메뉴에서 나타납니다. |
| guidance_hint::language(xx) | 안내 힌트에 대한 번역을 입력합니다. 언어는 해당 이름과 코드로 지정해야 합니다(예시: guidance_hint::Español(es)). 각 언어에 대한 새 열을 추가합니다. 언어 목록은 현장조사의 드롭다운 메뉴에서 나타납니다. |
| required_message::language(xx) | 필수 질문에 대한 답변이 없는 경우 표시되는 메시지에 대한 번역을 입력합니다. 언어는 해당 이름과 코드로 지정해야 합니다(예시: required_message::Español(es)). 각 언어에 대한 새 열을 추가합니다. 언어 목록은 현장조사의 드롭다운 메뉴에서 나타납니다. |
| body::accuracyThreshold | 위치 값에 대한 임계값(미터 단위)을 입력합니다. 이 수치보다 클 경우 위치 값이 허용되지 않습니다. 지오쉐이프 및 지오추적 질문의 버텍스와 지오포인트에 적용됩니다. |
| bind::esri:warning | 조건이 충족되지 않은 경우에 경고를 표시하는 식을 적용합니다. |
| bind::esri:warning_message | bind::esri:warning 조건이 충족되지 않은 경우 표시되는 메시지입니다. |
| bind::saveIncomplete | 앱에서 질문 후 응답이 자동으로 저장되도록 하려면 true로 설정합니다. |
선택 항목 워크시트
이 워크시트는 선다형 질문의 답 선택 항목을 지정하는 데 사용됩니다. 각 행은 하나의 답 선택 항목을 나타냅니다. 목록 이름이 같은 답 선택 항목은 연관된 선택 항목의 일부이며 한 질문에 다 함께 나타납니다. 또한 일련의 선택 항목을 여러 질문에 다시 사용할 수 있습니다(예시: 예/아니요 질문).
선택 항목 워크시트에는 목록 이름, 이름, 레이블이라는 3개의 필수 열이 있습니다.
- 목록 이름 열에서는 일련의 연관된 답변 선택 항목을 그룹화할 수 있습니다. 목록 이름이 같은 선택 항목은 한 질문에 대한 답변 집합으로 제공됩니다.
- 이름 열은 ArcGIS에서 지속될 값을 지정합니다. 이름 열의 값에는 특수 문자가 허용되지 않습니다. 선택 목록에 중복 선택 이름을 포함하지 않는 것을 권장합니다. 중복 선택 이름에 대한 자세한 내용은 선다형 질문을 참고하세요.
- 레이블 열에는 양식에서 보여질 답변 선택 항목이 그대로 나타납니다. 또는 레이블 번역 열을 사용할 수도 있습니다.
Excel로 양식을 작성할 때는 정확한 구문을 사용해야 합니다. 예를 들어 choices 대신 Choices나 choice를 사용하면 양식이 작동되지 않습니다.
설정 워크시트
설정 워크시트는 선택 사항이며 이 워크시트에서 양식을 추가적으로 사용자 정의할 수 있습니다. 사용 가능한 사용자 정의에는 양식이 편집 중일 때 표시될 제목, 완료된 각 양식을 고유하게 식별하는 인스턴스 이름, 현장조사의 고유 버전 식별자 등이 포함됩니다. 자세한 내용은 설정을 참고하세요.
보조 워크시트
Survey123 템플릿에는 양식에 사용할 수 있는 등록정보, 연산자, 함수가 들어 있는 워크시트가 포함되어 있습니다. 또한 이러한 워크시트는 현장조사의 드롭다운 목록과 기타 데이터 유효성 검사 규칙 그리고 설정 워크시트를 채우는 데 사용됩니다. 데이터 유효성 검사가 정상적으로 작동되도록 하려면 보조 워크시트의 내용을 수정하지 않는 것을 권장합니다.
질문 유형
XLSForm에는 여러 가지 질문 유형이 지원됩니다. 예를 들어 한 매장의 이름과 위치를 수집하려면 다음과 같이 작성합니다.
다음 테이블에는 XLSForm의 유형 열에 입력할 수 있는 질문, 질문에 허용되는 입력, 양식이 발행될 때 해당 질문에 대한 관련 ArcGIS 피처 레이어에 생성되는 필드 유형이 나와 있습니다. 현장조사 작성자는 여러 질문 유형에 대해 필드 유형을 변경할 수 있습니다. 필드 유형에 대한 자세한 내용은 Esri 사용자 설정 열을 참고하세요.
| 질문 유형 | 답변 입력 | 기본 필드 유형 |
|---|---|---|
| integer | 정수 입력입니다. | esriFieldTypeInteger |
| decimal | 소수 입력입니다. | esriFieldTypeDouble |
| 범위 | 지정된 숫자 범위의 입력입니다. | esriFieldTypeInteger |
| text | 텍스트 입력입니다. | esriFieldTypeString |
| select_one list_name | 선다형 질문으로 사용자가 한 개의 답변만 선택할 수 있습니다. list_name을 선택 목록의 이름으로 바꿉니다. 필드 유형을 변경할 수 있지만 선택 항목 이름은 식에 사용된 경우 현장 앱에서 항상 문자열로 취급됩니다. | esriFieldTypeString |
| select_multiple list_name | 선다형 질문으로 사용자가 여러 개의 답변을 선택할 수 있습니다. list_name을 선택 목록의 이름으로 바꿉니다. 필드 유형을 변경할 수 없으며, 선택 항목 이름은 식에 사용된 경우 현장 앱에서 항상 문자열로 취급됩니다. | esriFieldTypeString |
| rank list_name1 | 순위 질문으로 선택 항목을 순위대로 나열합니다. list_name을 선택 목록의 이름으로 바꿉니다. 필드 유형을 변경할 수 없으며, 선택 항목 이름은 식에 사용된 경우 현장 앱에서 항상 문자열로 취급됩니다. | esriFieldTypeString |
| note | 화면에 비고를 표시하며 입력은 받지 않습니다. 숨겨진 계산을 표시할 수도 있습니다. | esriFieldTypeString |
| 지오포인트 | 단일 GPS 좌표를 수집합니다. 필드 유형을 변경할 수 없습니다. | esriFieldTypeGeometry |
| 지오추적 | 맵에서 라인을 수집합니다. 필드 유형을 변경할 수 없습니다. | esriFieldTypeGeometry |
| 지오쉐이프 | 맵에서 폴리곤을 수집합니다. 필드 유형을 변경할 수 없습니다. | esriFieldTypeGeometry |
| 날짜 | 날짜 입력입니다. | esriFieldTypeDate |
| 시간 | 시간 입력입니다. | esriFieldTypeString |
| 날짜 및 시간 | 날짜와 시간 입력이 허용됩니다. | esriFieldTypeDate |
| 이미지 | 사진을 촬영합니다. | 첨부 파일 |
| begin group | 질문 그룹을 시작합니다. | N/A |
| end group | 질문 그룹을 종료합니다. | N/A |
| begin repeat | 일련의 반복 질문을 시작합니다. | N/A |
| end repeat | 일련의 반복 질문을 종료합니다. | N/A |
| 계산 | 양식의 값에 대해 계산을 수행합니다. 이 질문 유형은 숨겨지며 양식에 나타나지 않습니다. | esriFieldTypeString |
| username2 | ArcGIS Online 또는 ArcGIS Enterprise에 로그인한 경우 이 필드에 계정 사용자 이름이 자동으로 채워집니다. 이 질문 유형은 숨겨지며 양식에 나타나지 않습니다. | esriFieldTypeString |
| email2 | ArcGIS Online 또는 ArcGIS Enterprise에 로그인한 경우 이 필드에 계정 이메일 주소가 자동으로 채워집니다. 이 질문 유형은 숨겨지며 양식에 나타나지 않습니다. | esriFieldTypeString |
| hidden | 양식에 나타나지 않는 필드입니다. 데이터 스키마를 지정하려면 bind::esri:fieldType 및 bind::esri:fieldLength 열을 사용합니다. | esriFieldTypeString |
| 바코드 | 바코드를 스캔합니다. | esriFieldTypeString |
| start | 현장조사 시작일과 시간입니다. | esriFieldTypeDate |
| end | 현장조사 종료일과 시간입니다. | esriFieldTypeDate |
| deviceid | Survey123에서 생성된 고유 ID로 현장조사가 수행된 특정 기기를 나타냅니다. Survey123이 IMEI가 없을 수 있는 기기에서 실행되므로 이 ID는 모바일 기기의 IMEI(International Mobile Equipment Identity)와 구별됩니다. 이 질문 유형은 숨겨지며 양식에 나타나지 않습니다. | esriFieldTypeString |
| 오디오 | 오디오 샘플을 녹음합니다. | 첨부 파일 |
| 파일1 | 기기에 파일을 업로드합니다. | 첨부 파일 |
1 — 파일 및 순위 지정 질문 유형은 현재 Survey123 현장 앱에서만 지원됩니다.
2 — 더 유연한 옵션은 pulldata("@property") 함수를 사용하여 값을 가져오는 것입니다. 기기, 사용자, 현장조사 등록정보를 참고하세요.
Survey123 Connect에서 질문 유형 샘플을 사용해 Survey123에서 지원되는 모든 질문 유형을 포함하는 양식을 확인해 보세요. Survey123 웹 디자이너의 질문 유형별 표시 방식은 질문 유형 참조에서 확인하세요.
메타데이터
XLSForm에는 메타데이터 수집을 위한 다음과 같은 데이터 유형 옵션이 있습니다.
| 메타데이터 유형 | 설명 |
|---|---|
| start | 현장조사 시작일과 시간입니다. |
| end | 현장조사 종료일과 시간입니다. |
| username | ArcGIS Online 또는 ArcGIS Enterprise에 로그인되어 있는 현재 사용자의 사용자 이름을 기록합니다. 이 데이터 유형은 입력을 받지 않습니다. |
| ArcGIS Online 또는 ArcGIS Enterprise에 로그인되어 있는 현재 사용자의 이메일 주소를 기록합니다. 이 데이터 유형은 입력을 받지 않습니다. | |
| deviceid | Survey123에서 생성된 고유 ID로 현장조사가 수행된 특정 기기를 나타냅니다. Survey123이 IMEI가 없을 수 있는 기기에서 실행되므로 이 ID는 모바일 기기의 IMEI와 구별됩니다. |
비고:
XLSForm 메타데이터 요소 subscriberid, simserial, phonenumber는 지원되지 않습니다.
이 메타데이터 모두를 수집하려면 다음을 현장조사 첫 부분에 추가하세요.
위에 설명된 메타데이터 항목이 ArcGIS Survey123에서 자동으로 취득됩니다. 이러한 메타데이터는 양식에서 질문으로 나타나지 않지만, 현장조사가 제출된 후 값을 볼 수 있습니다.
시작 또는 종료 유형을 추가하면 ArcGIS Survey123에서는 현장조사의 피처 레이어에 시간을 자동으로 활성화합니다. 이런 방식을 통해, 데이터가 제출된 날짜를 기반으로 현장조사 콘텐츠를 필터링할 수 있습니다. 또한 시작 항목과 종료 항목을 추가하여 양식이 열렸을 때부터 완료 플래그가 지정되었을 때까지의 경과 시간을 정확하게 파악할 수도 있습니다.
힌트
양식에서 질문에 대한 힌트를 추가하여(질문에 포함하지는 않음) 사용자에게 질문에 답하는 요령을 안내할 수도 있습니다. XLSForm에서 질문에 대한 힌트를 추가할 수 있습니다. 힌트 열과 힌트 메시지를 추가하세요. 다음 예를 참고하세요.
비고:
반복 시작과 그룹 시작 질문에는 힌트가 지원되지 않습니다.
또한 guidance_hint 열을 사용하여 질문에 대한 안내 힌트를 추가할 수 있습니다. 안내 힌트는 사용자에게 질문 답변 방법에 대한 추가 지침을 제공하지만 사용자가 힌트 옆에 나타나는 안내 힌트 버튼을 누를 때까지 숨겨져 있습니다. 안내 힌트는 질문에 이미 힌트가 있는 경우에만 사용할 수 있습니다.
플레이스 홀더 텍스트
body::esri:style 열에서 placeholderText 매개변수를 설정하여 값을 직접 입력할 수 있는 질문(예시: 텍스트, 정수, 소수 질문, 자동 완성 모양의 선택 질문)에 플레이스 홀더 텍스트를 제공할 수도 있습니다. placeholderText=@[hint] 또는 placeholderText=@[guidance_hint]을(를) 사용하면 힌트나 안내 힌트가 숨겨지고 대신 힌트 텍스트가 질문의 입력 영역 내에 배치됩니다. 질문이 비어 있는 경우 플레이스 홀더 텍스트가 입력 영역에 나타납니다.
비고:
플레이스 홀더 텍스트는 Survey123 웹 앱에서 지원되지 않습니다.
템플릿 업데이트
비고:
이 섹션에서는 Survey123 Connect에서만 사용할 수 있는 기능을 설명합니다. 이 기능은 Survey123 Studio에서는 사용할 수 없습니다.
고급 템플릿에는 Survey123 현장 앱에서 지원되는 모든 XLSForm 기능이 포함되어 있으며 Survey123 Connect의 새 현장조사 대화 상자에서 사용할 수 있습니다. 이 템플릿은 새 기능을 추가하고 현장조사 작성 경험을 향상시키기 위해 정기적으로 업데이트됩니다. 이전 버전의 템플릿을 문제 없이 계속 사용할 수 있지만 최신 변경 사항을 활용하기 위해 기존 현장조사를 최신 XLSForm 템플릿으로 업데이트할 수 있습니다.
XLSForm 템플릿 업데이트 도구는 현장조사에 대한 기존 XLSForm을 최신 버전의 고급 템플릿으로 업데이트합니다. 현장조사, 선택 항목, 설정 워크시트의 내용을 새 템플릿의 해당 행 및 열에 복사하여 수행합니다. 추가한 열은 새 템플릿 및 외부 선택을 사용하는 경우 external_choices 워크시트에도 복사됩니다.
도구를 실행하려면 Python에서 Survey123 Connect 환경을 구성해야 합니다. 자세한 내용은 Python 구성을 참고하세요.
Survey123 Connect에서 업데이트할 현장조사를 엽니다. 도구를 클릭하고 XLSForm 템플릿 업데이트를 클릭합니다. 도구가 실행 중일 때 대화 상자에 메시지가 표시됩니다. 프로세스가 완료되면 현장조사 폴더의 .xlsx 파일이 최신 템플릿으로 업데이트되고 Survey123 Connect의 양식 미리 보기를 다시 불러옵니다. 도구가 실행되는 동안 오류가 발생하는 경우 기존 XLSForm이 유지됩니다.
비고:
현장조사의 XLSForm은 .xlsx 파일이어야 합니다. XLSForm 템플릿 업데이트 도구는 .xls 파일에서 실행할 수 없습니다.
기존 XLSForm의 열, 데이터 유효성 검사, 셀 서식, 글꼴 스타일이 업데이트된 XLSForm에 있는지 확인하는 것을 권장합니다. 해당 도구는 기존 XLSForm의 백업 및 로그 파일을 C:\Users\<username>\ArcGIS\My Survey Designs\<surveyName>\debug\template_updater에 생성합니다. 백업에서 현장조사를 복원하려면 .xlsx 폴더의 template_updater 파일을 현장조사의 루트 폴더에 복사합니다. 기존 XLSForm을 삭제하고 원본과 일치하도록 백업 이름을 바꿉니다.
비고:
각 행의 첫 번째 열에 있는 셀의 채우기 색상이 업데이트된 템플릿의 전체 행에 적용됩니다.
다국어 현장조사의 경우 label::language (xx) 및 hint::language (xx)와 같은 기본 언어 열은 업데이트된 템플릿에서 제외됩니다.
특수 문자
질문 이름 및 선택 이름은 공백, 쉼표, 하이픈, 괄호, 중괄호 같은 특수 문자 또는 $, %, # 등의 문자를 포함할 수 없습니다. select_multiple 질문의 선택 이름에는 공백이나 쉼표가 포함되지 않는 것이 중요합니다.