XLSForm용 Esri 사용자 설정 열은 Survey123 사용자에게 추가 기능을 제공합니다.
필드 유형
bind::esri:fieldType 사용자 설정 열을 사용하여 현장조사 질문을 위해 ArcGIS에 생성할 필드의 유형과 길이를 제어합니다. 지원되는 필드 유형에 대한 자세한 내용은 ArcGIS 필드 데이터 유형을 참고하세요.
일부 질문의 경우 Survey123에서 기본 설정에 따라 할당하는 필드 유형을 변경할 수 있습니다. 다음 테이블에 몇 가지 예시가 나와 있습니다.
| 질문 유형 | 기본 필드 유형 | 의견 |
|---|---|---|
select_one | esriFieldTypeString | 선택 사항이 정수로 저장되도록 esriFieldTypeInteger로 변경합니다. |
date | esriFieldTypeDate | esriFieldTypeDate에는 항상 시간 요소가 포함됩니다. 날짜만 저장하려면 esriFieldTypeDateOnly로 변경합니다. |
dateTime | esriFieldTypeDate | esriFieldTypeDate는 표준 시간대를 나타내지 않습니다. 필드에 표준 시간대를 포함하려면 esriFieldTypeTimestampOffset으로 변경하세요. esriFieldTypeTimestampOffset이 설정되면 날짜 및 시간 질문의 양식에 표준 시간대 선택기가 표시됩니다. 기본 설정에 따라 기기의 현재 표준 시간대가 적용됩니다. |
time | esriFieldTypeString | 시간을 시간 값으로 저장하려면 esriFieldTypeTimeOnly로 변경합니다. |
필드 유형을 제어하려면 다음 값 중 하나를 bind::esri:fieldType 열에 입력합니다.
- esriFieldTypeString
- esriFieldTypeDate
- esriFieldTypeDateOnly
- esriFieldTypeTimeOnly
- esriFieldTypeTimestampOffset
- esriFieldTypeInteger
- esriFieldTypeBigInteger
- esriFieldTypeSingle
- esriFieldTypeDouble
- esriFieldTypeSmallInteger
- esriFieldTypePointZ
- esriFieldTypeGUID
bind::esri:fieldType 열은 피처 레이어에서 생성된 필드 유형만 제어합니다. 현장조사 중에 질문에 대한 필드 유형을 제어하려면 bind::type 열을 사용하세요. 예를 들어 int 값을 calculate 질문의 bind::type 열에 입력하면 필드가 기본 필드 유형인 문자열이 아닌 정수로 처리됩니다. bind::type 열에는 다음과 같은 값을 입력할 수 있습니다.
- int
- decimal
- string
- 날짜
- 날짜 및 시간
- 시간
bind::esri:fieldType 열에는 생성된 피처 레이어에서 질문을 누락시키는 null 값도 허용됩니다. 질문이 현장조사에 여전히 표시되고 정상적으로 작동하지만 답변이 피처 레이어에 제출되지 않으며 응답을 검토하는 동안 표시되지 않습니다. 이는 결과를 표시할 필요가 없지만 프레젠테이션 목적으로는 표시해야 하는 계산, 제약 조건 또는 기타 질문에 적합합니다.
다음 질문 유형은 null 필드 유형을 지원하지 않습니다.
- select_one or other
- select_multiple or other
- hidden
비고:
지오포인트, 지오추적, 지오쉐이프 질문은 Null 필드 유형이 없는 지오포인트, 지오추적 또는 지오쉐이프 질문이 현장조사에 하나 이상 있거나 반복되는 경우에만 Null 필드 유형을 지원합니다.
필드 길이
bind::esri:fieldLength 사용자 설정 열을 사용하여 현장조사 질문을 위해 ArcGIS에 생성할 문자열(텍스트) 필드의 길이를 제어합니다.
비고:
정수 및 소수 질문은 이 방식으로 제어할 수 없습니다. 데이터베이스는 숫자 필드의 길이를 지정하지 않으며 유효한 값 범위는 숫자 필드 유형에 따라 결정됩니다. 예를 들어 정수 필드에는 -2,147,483,648~2,147,483,647의 정수 값이 저장됩니다.
필드 별칭
기본 설정에 따라 현장조사 필드의 별칭에는 ArcGIS에서 현장조사가 열릴 때 기본적으로 참조되는 필드 레이블과 같은 값이 상속됩니다. 이는 필드의 새 별칭이 될 값을 bind::esri:fieldAlias 열에 입력하여 변경할 수 있습니다.
숨김 및 계산 질문은 양식에 나타나지 않으므로 레이블 필드의 내용이 유지되지 않습니다. 따라서 Survey123 웹사이트나 ArcGIS에서 현장조사 레코드를 볼 때 이러한 유형의 질문에 대해서는 열 헤더에 표시된 질문 이름이 나타납니다. 숨김 및 계산 질문의 열 헤더에 레이블이 표시되도록 하려면 스프레드시트의 bind::esri:fieldAlias 열을 사용하여 레이블을 지정합니다.
입력 마스크
입력 마스크는 문자와 심볼을 사용하여 텍스트(text) 질문에 대한 일련의 형식을 제공합니다. 입력 마스크를 질문에 적용할 경우 모든 응답은 입력 마스크에서 정의된 특정 패턴을 따라야 합니다. Survey123 필드 앱 및 웹 앱에서는 모든 입력 마스크가 충족될 때까지 현장조사 응답을 제출할 수 없습니다.
팁:
입력 마스크는 text 질문 유형에만 적용할 수 있습니다. integer 또는 decimal 질문 유형의 경우 constraint 열을 사용하여 답변을 제한합니다. 자세한 내용은 제약 조건을 참고하세요.
입력 마스크를 질문에 적용하려면 body::esri:inputMask 열에 마스크를 정의합니다. 다음 테이블에는 입력 마스크에 사용할 수 있는 문자와 심볼이 나와 있습니다.
| 문자 | 의미 |
|---|---|
| A | ASCII 영문자가 필요합니다. 문자는 A~Z와 a~z 사이여야 합니다. |
| a | ASCII 영문자가 허용되지만 필수는 아닙니다. |
| N | ASCII 영숫자가 필요합니다. 문자는 A~Z, a~z, 0~9 사이여야 합니다. |
n | ASCII 영숫자가 허용되지만 필수는 아닙니다. |
X | 공백이 아닌 문자가 필요합니다. |
x | 공백이 아닌 문자가 허용되지만 필수는 아닙니다. |
| 9 | ASCII 숫자가 필요합니다. 숫자는 0~9 사이여야 합니다. |
0 | ASCII 숫자가 허용되지만 필수는 아닙니다. 숫자는 0~9 사이여야 합니다. |
| D | ASCII 숫자가 필요합니다. 숫자는 1~9 사이여야 합니다. |
d | ASCII 숫자가 허용되지만 필수는 아닙니다. 숫자는 1~9 사이여야 합니다. |
# | ASCII 숫자 또는 +/- 기호가 허용되지만 필수는 아닙니다. |
| H | 16진수 문자가 필요합니다. 문자는 A~F, a~f, 0~9 사이여야 합니다. |
시간 | 16진수 문자가 허용되지만 필수는 아닙니다. |
| B | 이진 문자가 필요합니다. 문자는 0~1 사이여야 합니다. |
b | 2진 문자가 허용되지만 필수는 아닙니다. |
| > | 모든 후속 영문자가 대문자입니다. |
| < | 모든 후속 영문자가 소문자입니다. |
| ! | 대소문자 변환을 해제합니다. |
| \ | 위에 나온 특수 문자를 구분 기호로 사용하기 위해 이스케이프합니다. |
마스크는 문자열과 구분 기호로 구성되며 필요에 따라 입력 마스크 끝의 세미콜론과 공백에 사용할 문자가 뒤에 올 수 있습니다. 공백 문자는 편집 후 텍스트에서 제거됩니다. 다음 테이블에는 마스크 예가 나와 있습니다.
| 마스크 예시 | 설명 |
|---|---|
| >A<xxxxxxxxxxxx | 대문자인 첫 자와 소문자인 후속 문자로 구성된 텍스트입니다. |
| AAA-AAA-AAA;_ | 대시(-)가 구분 기호로 사용되고, 입력 마스크 끝에 세미콜론이 있으며, 완성될 각 문자를 나타내는 밑줄(_)이 그 뒤에 오는 고유 식별자입니다. |
| B9.99;- | pH 값을 나타냅니다. 0 또는 1 중 하나만 올 수 있는 첫 자와 소수점 이하 두 자리로 구성된 숫자입니다. 입력 마스크 끝에 세미콜론이 위치하고, 그 뒤에 완성될 각 문자를 나타내는 데 사용되는 대시(-)가 옵니다. |
| 999-99-9999 | 미국 사회 보장 번호입니다. |
| (999) 999-9999 | 미국 전화번호입니다. |
| 900kg | 0에서 999 사이의 중량(킬로그램 단위)입니다. |
| 99999 | 5자리의 미국 우편 번호입니다. |
| AAA | IATA 공항 코드입니다. |
워크플로
갤러리에서 실행한 거리 측정기 타일로 필드를 채울 수 있다는 것을 나타내려면 bind::esri:workflow 사용자 설정 열을 사용합니다. 이 열은 텍스트 질문에서만 지원되며, bind::esri:workflow 열에는 다음 값을 사용해야 합니다.
- rangefinderMode=height
- rangefinderMode=offset
- rangefinderMode=height,offset
- rangefinderHeight
각 rangefinderMode 값은 현장 작업자에 대해 유사한 UX를 활성화합니다. 사용자가 원하는 거리 측정기 워크플로를 선택하고 나면, 현장조사를 선택하고 기구로 1~3샷을 찍도록 사용자를 안내합니다. 그런 다음 현장조사가 자동으로 실행되어 현장 작업자가 다른 질문에 대한 답을 작성할 수 있습니다.
rangefinderHeight 값은 현장 작업자가 이 값을 사용하여 앞으로 화살표와 뒤로 화살표를 통해 높이 값을 수신하도록 구성된 각 현장조사 질문을 찾아볼 수 있다는 점에서 고유합니다. 모든 높이가 측정되면 현장 작업자는 완료를 누르고 현장조사를 계속하여 다른 질문에 대한 답을 작성합니다.