사용자가 텍스트 및 숫자 답변을 입력할 수 있도록 현장조사에 텍스트, 정수, 소수 질문을 포함할 수 있습니다.
텍스트 질문을 사용하면 현장조사에 자유 형식의 텍스트로 응답할 수 있습니다. 기본적으로 양식에는 한 줄 입력이 가능한 텍스트 상자가 표시됩니다. 텍스트가 텍스트 상자의 크기를 넘으면 동일한 크기로 유지되며 줄바꿈 없이 수평으로 스크롤됩니다. 이 기능은 짧은 답변에 적합합니다. 텍스트 입력이 특정 형식을 따르도록 하려면 입력 마스크를 적용할 수 있습니다. 또한 정규식을 적용하여 이메일 주소 또는 웹사이트 URL 등 특정 형식에 맞지 않는 응답을 자동으로 거부하도록 텍스트 필드를 제한할 수 있습니다.
정수 및 소수 질문 유형은 사용자가 유효한 숫자 값만 입력하도록 제한합니다. 이러한 질문 유형의 제약 조건 열에서는 최소값과 최대값을 지정하여 답변이 지정된 범위 내에 있지 않으면 사용자가 현장조사를 제출하지 못하도록 할 수 있습니다.
모양을 설정하여 이러한 질문 유형의 동작 및 표시 방식을 변경할 수 있습니다. 특정 모양을 지원하는 제출 앱을 확인하려면 모양을 참고하세요.
텍스트 모양
비고:
Survey123 Mobile에서는 텍스트 질문에 다중 행 모양만 지원됩니다.
Survey123 웹 앱에서 predictivetext 및 nopredictivetext 모양은 지원되지 않습니다.
모양 열을 다중 행으로 설정하면 텍스트 질문이 다중 행 텍스트 상자로 표시됩니다. 이처럼 더 큰 텍스트 상자는 긴 답변에 적합합니다. 입력하는 동안 텍스트가 자동으로 줄바꿈되며 캐리지 리턴이 허용됩니다.
비고:
Survey123 현장 앱에서 사용되는 양식의 경우, body::esri:style 열에 defaultHeight 매개변수를 설정하여 다중 행 텍스트 상자의 기본 높이를 설정할 수 있습니다. 예를 들어 body::esri:style 열에 defaultHeight=5를 입력하면 현장조사가 열릴 때 다중 행 텍스트 상자가 5줄 높이로 표시됩니다. 이 매개변수를 설정하지 않으면 현장조사가 열릴 때 여러 줄 텍스트 상자가 3줄로 표시됩니다.
모양을 predictivetext 또는 nopredictivetext로 설정하면 모바일 기기에서 텍스트 질문에 대한 예측 텍스트가 각각 활성화되거나 비활성화됩니다. 기본 설정에 따라, Android에서는 텍스트 질문의 예측 텍스트 기능이 비활성화되어 있으며, 이로 인해 일부 키보드에서는 음성 텍스트 변환 기능이 비활성화될 수 있습니다. 텍스트 질문에 대해 음성 텍스트 변환 기능을 활성화하려면 해당 질문에 predictivetext 모양을 적용하세요. iOS에서는 기본 설정에 따라 예측 텍스트가 활성화되어 있습니다.
모양을 지오코드로 설정하면 텍스트 질문이 지오코딩된 주소를 검색하고 제출하는 데 사용됩니다.
모양은 InfraMarker 태그 ID를 가져오고 거리 측정기에서 값을 가져오는 데에도 사용할 수 있습니다.
지오코딩된 주소 검색 및 제출
비고:
이 섹션에서는 Survey123 현장 앱에서만 사용할 수 있는 기능을 설명합니다. 이 기능은 Survey123 Mobile에서는 사용할 수 없습니다.
모양 열을 지오코드로 설정하면 텍스트 질문이 지오코딩된 주소를 검색하고 제출하는 데 사용됩니다. 사용자가 주소 입력을 시작하면 기관에서 사용할 수 있는 기본 로케이터를 기반으로 위치를 제안하는 일련의 자동 완성 옵션이 나타납니다. 사용자가 로그인되어 있지 않으면 ArcGIS World Geocoder가 사용됩니다. 지오코드 모양은 인터넷 연결이 필요하며 오프라인 환경에서는 작동하지 않습니다.
최종적으로 선택한 주소는 문자열로 피처 레이어에 전송됩니다. 그러나 지오코딩된 전체 데이터는 전송되기 전에 일시적으로 JSON 객체로 저장되므로 개별 등록정보를 다른 필드로 추출할 수 있습니다.
JSON 객체에서 특정 등록정보를 추출하려면 다른 질문의 계산 열에 있는 pulldata("@json") 함수를 사용합니다.
pulldata("@json", ${address}, "location.x")
pulldata("@json", ${address}, "searchCandidate")
개별 등록정보를 정의하지 않으면 전체 JSON 객체를 단일 텍스트 필드에 반환할 수 있습니다.
pulldata("@json", ${address})
pulldata("@json") 함수에 대한 자세한 내용은 JSON에서 값 가져오기를 참고하세요.
결과를 반환할 특정 로케이터를 설정하려면 bind::esri:parameters 열에 로케이터의 항목 ID를 입력합니다(예시: geocode=36ff9e8c13e042a58cfce4ad87f55d19). ArcGIS Online 현장조사에 사용되는 로케이터는 ArcGIS Online의 항목이어야 합니다. ArcGIS Enterprise 현장조사에 사용되는 로케이터는 현장조사와 동일한 포털의 항목이어야 합니다.
사용 가능한 등록정보는 사용된 로케이터에 따라 다릅니다. 예외적으로 searchText 등록정보는 사용된 로케이터와 관계없이 사용할 수 있으며 주소 검색에 사용된 정확한 문자열 또는 결과 목록에서 선택한 옵션을 반환합니다.
body::esri:style 열에서 다음 매개변수 중 하나를 설정하여 지오코드 모양 질문 표시를 추가로 제어할 수 있습니다.
비고:
indicator, proximity, maxResults, suggestions 매개변수는 Survey123 웹 앱에서 지원되지 않습니다.
- indicator — 지오코딩된 결과가 현재 기기 위치로부터의 방향과 거리를 표시하도록 허용합니다. 이 매개변수는 distance, direction, 쉼표로 구분된 두 값 또는 none으로 설정할 수 있습니다. 이 매개변수는 기본 설정에 따라 거리만 표시하도록 설정됩니다.
- proximity — 지오코딩된 결과가 기기 위치의 특정 반경 내에서만 결과를 표시할지 여부를 제어합니다. 이 매개변수는 다음 표준 단위가 뒤에 오는 숫자를 허용합니다. m(미터), km(킬로미터), ft(피트), mi(마일) 또는 yd(야드). 단위를 입력하지 않으면 미터가 기본값으로 설정됩니다. 0으로 설정한 경우 검색 결과에서 인접도가 고려되지 않습니다. 이 매개변수는 기본 설정에 따라 on으로 설정되어 거리로 인해 위치를 필터링하지 않고 인접도를 기준으로 제안을 정렬할 수 있습니다.
- maxResults — 제공되는 최대 결과 수를 제어합니다. 예를 들어, maxResults=10은 가능한 최대 10개의 결과를 반환합니다. 이 매개변수는 기본 설정에 따라 최대 6개의 결과를 표시하도록 설정됩니다.
- suggestions — ArcGIS REST API의 suggest 작업에 대한 인터페이스 역할을 합니다. 이 매개변수가 yes(으)로 설정되면 suggest 작업이 잠재적인 위치의 드롭다운 목록을 채웁니다. 이 매개변수가 no(으)로 설정되거나 지오코드 서비스에서 suggest 작업을 지원하지 않는 경우 findAddressCandidates 작업이 잠재적인 위치의 드롭다운 목록을 채웁니다. 이 매개변수는 기본 설정에 따라 yes(으)로 설정됩니다.
InfraMarker 태그 ID 가져오기
비고:
이 섹션에서는 Survey123 현장 앱에서만 사용할 수 있는 기능을 설명합니다. 이 기능은 Survey123 Mobile에서는 사용할 수 없습니다.
아래에 설명된 모양을 사용하여 InfraMarker RFID 태그의 데이터를 읽거나 해당 태그에 데이터를 작성합니다.
텍스트 질문의 모양 열을 inframarker로 설정하면 태그에 작성할 정보를 정의할 수 있습니다. 해당 정보에는 assetOwner, assetName, latitude, longitude를 포함할 수 있으며 이러한 값은 현장조사의 다른 질문에서 파생될 수 있습니다. 예를 들어 계산 열의 다음 식은 asset_name, asset_owner, lat, long 질문의 답변을 태그에 작성합니다.
concat("assetName=", ${asset_name}, "&assetOwner=", ${asset_owner}, "&latitude=", ${lat}, "&longitude=", ${long})
동일한 현장조사에서 다른 텍스트 질문의 모양을 getinframarkerid로 설정하면 현장조사에서 고유한 24자의 InfraMarker 태그 ID를 가져와서 저장합니다.
자세한 내용은 InfraMarker 문서를 참고하세요.
거리 측정기에서 값 가져오기
비고:
이 섹션에서는 Survey123 현장 앱에서만 사용할 수 있는 기능을 설명합니다. 이 기능은 Survey123 Mobile에서는 사용할 수 없습니다.
모양 열을 거리 측정기로 설정하면 텍스트 질문이 전체 JSON 객체 또는 거리 측정기에서 반환된 지정된 값을 사용할 수 있습니다. 이 질문을 통해 전체 JSON 객체를 사용하도록 하는 경우, 전체 값이 들어맞도록 하려면 이 질문의 bind::esri:fieldLength를 1,000으로 설정해야 합니다.
정수 또는 소수 질문에 거리 측정기 모양을 설정하면 거리 측정기에서 반환되는 특정 값을 사용할 수 있습니다. bind::esri:parameters 열에 height, azimuth, horizontalDistance, slopeDistance 또는 inclination 값 중 하나를 사용하여 저장할 측정값을 지정합니다. 예를 들어, measurement=height는 거리 측정기에서 반환된 높이 값만 저장합니다.
정수 모양
비고:
Survey123 Mobile에서는 정수 질문에 대해 스피너 모양만 지원됩니다.
Survey123 웹 앱에서 이러한 정수 모양은 지원되지 않습니다.
모양 열을 스피너로 설정하면 정수 질문에 값을 1씩 늘리거나 줄이는 버튼이 표시됩니다. 버튼을 선택하면 놓을 때까지 값 증감이 계속 진행됩니다.
모양을 숫자로 설정하면 강조된 정수 질문이 값을 입력할 수 있는 사용자 설정 숫자 키보드와 함께 제공됩니다. 이 키보드에는 값을 양수나 음수로 설정하는 버튼도 포함되어 있습니다.
모양을 계산기로 설정하면 강조된 정수 질문이 값을 입력 및 수정할 수 있는 사용자 설정 계산기 키보드와 함께 제공됩니다.
모양을 디스트레스로 설정하면 정수 질문의 선택 항목이 불안 척도로 제공됩니다. 불안 척도란 스트레스, 고통, 행복감 등의 감정을 평가하는 데 사용되는 10점 만점 평가입니다.
소수 모양
비고:
Survey123 Mobile에서는 소수 질문에 대해 스피너 모양만 지원됩니다.
Survey123 웹 앱에서 이러한 소수 모양은 지원되지 않습니다.
모양 열을 스피너로 설정하면 소수 질문에 값의 마지막 자릿수를 1씩 늘리거나 줄이는 버튼이 표시됩니다. 버튼을 선택하면 놓을 때까지 값 증감이 계속 진행됩니다.
기본값을 사용하여 질문의 소수점 이하 자릿수를 정의하면 스피너가 기본값을 따릅니다. 스피너는 다음 예와 같은 방식으로 여러 소수 값을 처리합니다.
- 1.0이 1.1, 1.2, 1.3, 1.4로 증가함
- 3.07이 3.08, 3.09, 3.10, 3.11로 증가함
- 2.000000이 2.000001, 2.000002, 2.000003으로 증가함
모양을 숫자로 설정하면 소수 질문이 값을 입력할 수 있는 사용자 설정 숫자 키보드와 함께 제공됩니다. 이 키보드에는 값을 양수나 음수로 설정하는 버튼도 포함되어 있습니다.
모양을 계산기로 설정하면 강조된 소수 질문이 값을 입력 및 수정할 수 있는 사용자 설정 계산기 키보드와 함께 제공됩니다.
모양을 1,000단위 구분 기호로 설정하면 소수 질문에 대한 답이 1,000단위 구분 기호를 사용해 표시됩니다. 이는 현장조사 응답의 일부로 전송된 값에 영향을 주지 않으며 앱에 표시하는 데만 영향을 미칩니다. 구분 기호는 기기의 로캘에 따라 설정되며 임시 저장, 임시 보관함, 수신함, 발신함 폴더에서 현장조사를 열거나 기본값 또는 계산을 통해 응답이 채워질 때만 적용됩니다. 수동으로 값을 입력할 경우 1,000단위 구분 기호가 표시되지 않습니다.
