각 질문 유형의 모양을 설정하여 질문이 제공되는 방식을 변경할 수 있습니다. 현장조사 질문의 모양과 기능을 변경하려면 스프레드시트에 모양 열을 추가합니다.
이러한 모양이 Survey123 현장 앱 및 웹 앱에서 모두 지원되는 것은 아닙니다. 각 환경에서 작동할 것으로 예상되는 모양을 설명하는 테이블은 빠른 참조를 참고하세요. 이 테이블은 Survey123 고급 XLSForm 템플릿의 모양 워크시트에서도 확인할 수 있습니다.
팁:
현장조사에 질문이 어떻게 표시되는지 확인하려면 Survey123 Connect의 모양 샘플을 참고하세요. ArcGIS 계정을 사용하여 샘플을 발행하면 Survey123 웹 앱에 질문이 어떻게 표시되는지도 확인할 수 있습니다.
여러 모양
모양을 공백으로 구분하여 질문의 모양 열에 여러 모양을 추가할 수 있습니다. 모양의 순서는 상관없습니다. 예를 들어 이미지 질문의 모양 열에 다음과 같은 세 가지 모양을 지정할 수 있습니다.
annotate new-front multiline
격자 레이아웃을 사용하는 현장조사에서 질문의 너비 모양을 지정할 수 있습니다. 너비는 질문 유형에 지원되는 모양의 조합으로 지정할 수 있습니다. 예를 들어 격자 레이아웃의 단답형 질문은 모양 열에 다음을 포함할 수 있습니다.
w3 likert
질문 숨기기
모양을 숨김으로 설정하면 현장조사를 작성할 때 그룹 및 반복을 비롯한 모든 질문 유형이 뷰에서 숨겨집니다. 하지만 기본값과 계산은 사용되어 제출됩니다. 이 방법은 모든 질문 유형에 적용할 수 있으므로 숨김 질문 유형보다 더 유용합니다.
텍스트
모양을 다중 행으로 설정하면 텍스트 질문이 여러 줄 텍스트 상자로 제공됩니다. defaultHeight 매개변수를 body::esri:style 열에 설정하여 텍스트 상자의 기본 높이를 설정할 수 있습니다. 예를 들어 body::esri:style 열에 defaultHeight=5를 입력하면 현장조사가 열릴 때 여러 줄 텍스트 상자가 5줄로 표시됩니다. 이 매개변수를 설정하지 않으면 현장조사가 열릴 때 여러 줄 텍스트 상자가 3줄로 표시됩니다.
모양을 predictivetext 또는 nopredictivetext로 설정하면 모바일 기기에서 텍스트 질문에 대한 예측 텍스트가 각각 활성화되거나 비활성화됩니다. 기본 설정에 따라 Android에서는 텍스트 질문에 대해 예측 텍스트가 비활성화되어 있으며 iOS에서는 활성화되어 있습니다.
비고:
질문 높이 조정은 Survey123 웹 앱에서 지원되지 않습니다.
predictivetext 및 nopredictivetext 모양은 Survey123 웹 앱에서 지원되지 않습니다.
Android에는 예측 텍스트가 기본 설정에 따라 텍스트 질문에 대해 비활성화되어 있으며 일부 키보드에서 음성 텍스트 변환 기능을 비활성화할 수 있습니다. 텍스트 질문에 대해 음성 텍스트 변환 기능을 활성화하려면 해당 질문에 predictivetext 모양을 적용하세요.
InfraMarker 텍스트
다음 모양을 사용하여 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 문서를 참고하세요.
지오코드
모양을 지오코드로 설정하면 텍스트 질문이 지오코딩된 주소를 검색하고 제출하는 데 사용됩니다. 주소 입력을 시작하면 기관에서 사용할 수 있는 기본 로케이터를 기반으로 위치를 제안하는 일련의 자동 완성 옵션이 나타납니다. 사용자가 로그인하지 않으면 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 — 지오코딩된 결과가 현재 기기 위치로부터의 방향과 거리를 표시하도록 허용합니다. 이 매개변수는 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(으)로 설정됩니다.
지오코드 모양은 인터넷 연결이 필요하며 오프라인 환경에서는 작동하지 않습니다.
비고:
indicator, proximity, maxResults, suggestions 매개변수는 Survey123 웹 앱에서 지원되지 않습니다.
거리 측정기
모양을 거리 측정기로 설정하면 텍스트 질문이 전체 JSON 객체 또는 거리 측정기에서 반환된 지정된 값을 사용할 수 있습니다. 이 질문을 통해 전체 JSON 객체를 사용하도록 하는 경우, 전체 값이 들어맞도록 하려면 이 질문의 bind::esri:fieldLength를 1000으로 설정해야 합니다.
모양을 거리 측정기로 설정하면 정수 또는 소수 질문에 거리 측정기에서 반환된 특정 값을 사용할 수 있습니다. bind::esri:parameters 열에 height, azimuth, horizontalDistance, slopeDistance, inclination 값 중 하나를 사용하여 어떤 측정을 저장할지 지정합니다. 예를 들어, measurement=height는 거리 측정기에서 반환된 높이 값만 저장합니다.
날짜
모양을 연도로 설정하면 날짜 질문이 연도 전용 버튼(연도 값을 늘리거나 줄이는 화살표 포함)으로 제공됩니다.
모양을 월 연도로 설정하면 날짜 질문이 월 버튼과 연도 버튼으로 제공됩니다. 각 버튼에는 해당 값을 늘리거나 줄이는 화살표가 포함되어 있습니다.
비고:
연도 및 월 연도 모양은 현재 월 및 연도의 값으로 현장조사를 불러올 때 나타납니다. 하지만 이들 모양 유형에는 이러한 값이 포함되지 않으므로 수동으로 편집하거나 기본값 또는 계산이 적용되어 있지 않는 한 빈 값이 제출됩니다.
모양을 주수로 설정하면 날짜 질문이 날짜 선택을 위한 캘린더 선택기로 제공되며 날짜를 선택하면 그 해의 해당 주수가 나타납니다. 예를 들어 2016년 4월 27일을 선택하면 17주가 결과로 나타납니다.
비고:
주수 모양은 Survey123 웹 앱에서 지원되지 않습니다.
단답형
모양을 숨김으로 설정하면 단답형 질문의 선택 항목이 드롭다운 메뉴로 제공됩니다.
모양을 가로로 설정하면 단답형 질문에 대한 선택 항목은 같은 너비의 열에 가로로 표시됩니다.
축소 모양은 가로 모양과 비슷하지만 열 너비를 결정하는 데 다른 방법을 사용하여 선택 항목이 공간을 덜 차지하도록 만들 수 있습니다.
하이픈으로 구분되는 숫자를 제공하여 축소 모양의 최대 열 수를 지정할 수 있습니다. 예를 들어, compact-3은 질문의 열을 최대 3개로 제한합니다.
축소 및 가로-축소 모양은 동일합니다. Survey123 웹 앱에서 이러한 모양은 열을 사용하는 대신 단답형 질문의 선택 레이블을 추가 공백 없이 행에 나란히 맞춥니다.
모양을 리커트로 설정하면 단답형 질문의 선택 항목이 리커트 척도로 제공됩니다. 리커트 척도란 응답자가 질문 내용에 대한 대칭적 동의-반대 척도에서 자신의 동의 수준을 지정할 수 있는 등급 척도입니다.
모양을 자동 완성으로 설정하면 단답형 질문이 텍스트 필드와 드롭다운 메뉴로 제공됩니다. 필드에 텍스트를 입력하면 드롭다운 메뉴가 해당 텍스트가 포함된 답변으로 제한됩니다. 이 설정은 선택 목록이 매우 긴 경우에 유용합니다.
모양을 이미지 맵으로 설정하면 단답형 질문이 media::image 열에서 참조된 이미지로 제공되며 선택 가능한 이미지 영역이 선택 항목으로 제공됩니다. 이 모양을 사용하려면 SVG 파일이 현장조사의 미디어 폴더에 제공되어야 하며 선택 항목 목록의 이름 값이 SVG 파일 영역의 경로 ID와 일치해야 합니다. 자세한 내용은 SVG 파일 사용을 참고하세요.
비고:
이미지 맵 모양은 Survey123 웹 앱에서 지원되지 않습니다.
선다형
모양을 숨김으로 설정하면 선다형 질문의 선택 항목이 드롭다운 메뉴로 제공됩니다.
모양을 가로로 설정하면 선다형 질문에 대한 선택 항목은 같은 너비의 열에 가로로 표시됩니다.
축소 모양은 가로 모양과 비슷하지만 열 너비를 결정하는 데 다른 방법을 사용하여 선택 항목이 공간을 덜 차지하도록 만들 수 있습니다.
하이픈으로 구분되는 숫자를 제공하여 축소 모양의 최대 열 수를 지정할 수 있습니다. 예를 들어, compact-3은 질문의 열을 최대 3개로 제한합니다.
축소 및 가로-축소 모양은 동일합니다. Survey123 웹 앱에서 이러한 모양은 열을 사용하는 대신 선다형 질문의 선택 레이블을 추가 공백 없이 행에 나란히 맞춥니다.
모양을 이미지 맵으로 설정하면 선다형 질문이 media::image 열에서 참조된 이미지로 제공되며 선택 가능한 이미지 영역이 선택 항목으로 제공됩니다. 이 모양을 사용하려면 SVG 파일이 현장조사의 미디어 폴더에 제공되어야 하며 선택 항목 목록의 이름 값이 SVG 파일 영역의 경로 ID와 일치해야 합니다. 자세한 내용은 SVG 파일 사용을 참고하세요.
비고:
이미지 맵 모양은 Survey123 웹 앱에서 지원되지 않습니다.
검색
하나를 선택하고 다중 질문을 선택하면 현장조사 미디어 폴더의 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"
추가 매개변수는 선택 사항이지만 검색에서 제공하는 결과 범위를 좁히는 데 사용할 수 있습니다.
매개변수 | 설명 |
---|---|
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 웹 앱에 제공됩니다.
맵 질문
모양을 눌러서 찾기로 설정하면 양식을 불러온 후 위치를 바로 취득하는 기본 동작 대신 사용자가 질문과 상호작용할 경우에만 지오포인트 질문이 위치 값을 사용합니다. 지오추적 또는 지오쉐이프 질문은 맵과 처음 상호작용할 때 포인트를 취득하지 않고 사용자 위치에 중심이 맞춰집니다.
비고:
눌러서 찾기 모양은 Survey123 현장 앱의 지오추적 및 지오쉐이프 질문에서 지원되지 않습니다.
지오포인트
모양을 숨김 입력으로 설정하면 Survey123 웹 앱에 표시된 지오포인트 질문에 기본 좌표 입력 상자가 아니라 읽기 전용 좌표 값이 나타납니다.
비고:
숨김 입력 모양은 Survey123 현장 앱에서 지원되지 않습니다.
이미지
모양을 서명으로 설정하면 이미지 질문이 서명을 캡처할 수 있는 팝업을 제공합니다.
서명은 팝업과 동일한 크기의 .jpg 이미지 첨부 파일로 저장됩니다. 기본 설정에 따라 팝업 너비는 고정 높이가 200픽셀인 기기의 화면 너비로 확장됩니다. 매개변수 열에 max-pixels 값을 정의하여 이 팝업의 최대 너비를 설정할 수 있습니다(예시: max-pixels=400).
기본 열에 이미지를 제공하여 서명에 대한 사용자 설정 배경을 설정할 수도 있습니다. 기본 이미지의 크기는 팝업의 경사면 방향 비율을 결정합니다.
팝업의 너비는 다음 중 가장 작습니다.
- max-pixels 값
- 기본 이미지의 너비
- 기기 화면의 너비
기본 이미지가 제공되지 않는 한 높이는 200픽셀입니다.
서명 모양을 사용하여 현장조사를 디자인할 경우 모든 대상 기기의 화면 크기를 고려해야 합니다.
body::esri:style 열의 footerText 매개변수를 사용하여 시그니처 질문 팝업에 대한 바닥글 텍스트를 제공할 수 있습니다. 값 없이 footerText 매개변수만 사용하면 서명 아래에 질문의 안내 힌트가 나타납니다. 이는 footerText=@[hint]을(를) 사용하여 질문의 힌트로 변경할 수 있습니다. 바닥글 텍스트에 사용된 힌트 또는 안내 힌트는 질문 이름 아래의 기본 위치에 나타나지 않습니다. 힌트에 대해 자세한 내용은 힌트를 참고하세요.
모양을 다중 행으로 설정하면 이미지 질문은 단일 이미지 질문에 여러 개의 이미지를 허용합니다. 공백으로 구분된 두 모양(예시: 다중 행 애노테이트)을 설정하여 이 모양을 다른 이미지 모양과 결합할 수 있습니다.
제약 조건 열의 count-selected 함수를 사용하여 제출할 수 있는 이미지 수를 제어할 수 있습니다. 예를 들어, count-selected(${image_question}) <= 5에서 제출할 수 있는 이미지 수는 최대 5개로 제한됩니다.
모양을 전면 또는 후면으로 설정하면 이미지 질문이 기기의 카메라만 사용하도록 제한되며, 기본 설정에 따라 각각 전면 또는 후면 카메라를 사용합니다. 공백으로 구분된 두 모양(예시: new-front annotate)을 설정하여 해당 모양을 애노테이트와 결합할 수 있습니다.
비고:
Survey123 웹 앱은 시그니처 모양에 적용될 때 다중 행, max-pixels 매개변수 또는 기본값을 지원하지 않습니다.
전면 및 후면 모양은 Survey123 웹 앱에서 지원되지 않습니다.
다중 행 이미지 질문에는 pulldata("@exif") 함수를 사용할 수 없습니다. 동일한 질문에 제출된 여러 이미지에서 교환 이미지 파일 형식(EXIF) 데이터를 추출해야 할 경우에는 반복을 사용해 보세요.
그리기 및 애노테이트
모양을 그리기로 설정하면 이미지 질문은 스케치할 수 있는 캔버스를 불러오는 버튼을 표시합니다. 그리기 도구 팔레트에서 그리기 도구 간에 전환하고 텍스트 크기, 라인 너비, 색상 등과 같은 각 도구의 설정을 제어할 수 있습니다. 캔버스 인터페이스에 대한 정보는 그리기 및 애노테이트를 참고하세요. 필요에 맞게 그리기 및 애노테이션 도구를 구성할 수 있는 사용자 설정 팔레트를 생성할 수 있습니다. 자세한 내용은 그리기 및 애노테이트 팔레트를 참고하세요.
모양을 애노테이트로 설정하면 이미지 질문에는 기기 카메라를 열어 사진을 찍은 다음 그래픽 및 텍스트로 주석을 달 수 있는 버튼이 표시됩니다. 그리기 도구 팔레트에서 그리기 도구 간에 전환하고 텍스트 크기, 라인 너비, 색상 등과 같은 각 도구의 설정을 제어할 수 있습니다. 캔버스 인터페이스에 대한 정보는 그리기 및 애노테이트를 참고하세요. 필요에 맞게 그리기 및 애노테이션 도구를 구성할 수 있는 사용자 설정 팔레트를 생성할 수 있습니다. 자세한 내용은 그리기 및 애노테이트 팔레트를 참고하세요.
팁:
Survey123 3.13부터는 EXIF 데이터가 원본 이미지에서 애노테이트된 이미지로 복사됩니다.
또는 사용자가 기기 저장소의 기존 이미지나 맵 스냅샷에 애노테이트하도록 할 수 있습니다. 이를 수행하려면 해당 질문에 대해 body::esri:style을 method=browse, method=camera 또는 method=map으로 설정합니다. 애노테이트 모양의 기본 동작은 method=camera을(를) 제공하는 것과 동일합니다. 쉼표로 구분된 여러 옵션을 제공하여 원본 이미지에 대한 여러 옵션을 제공하도록 질문을 설정할 수 있습니다(예시: method=camera,browse).
주의:
설정된 방법과 관계없이 Survey123 웹 앱은 파일 찾아보기 옵션만 표시합니다.
기본값 및 계산은 그리기를 사용하는 이미지 질문과 애노테이트를 사용하는 이미지 질문에서 서로 다르게 동작합니다. 현장조사의 미디어 폴더에 있는 이미지의 파일 이름이 기본값 또는 계산 결과로 사용되는 경우 해당 이미지는 캔버스의 초기 배경으로 사용됩니다. 애노테이트를 사용할 경우 이 이미지는 제공된 이미지로 대체되며 사용자가 이미지 제공을 특별히 거부하거나 이미 제공된 이미지를 다시 설정하는 경우에만 표시됩니다.
비고:
매개변수 열에서 max-pixels 값을 정의하여 이미지의 해상도를 설정할 수 있습니다. 그리기 질문의 경우 max-pixels=1000 설정은 캔버스를 1000x1000픽셀의 정사각형 이미지로 설정합니다. 애노테이트 질문의 경우 max-pixels=1000 설정은 제공된 이미지의 종횡비를 유지하면서 이미지의 가장 긴 면을 1000픽셀로 설정합니다. max-pixels을(를) 설정하지 않은 경우 이미지 크기는 Survey123 Connect의 현장조사에 대한 옵션 설정의 이미지 크기 설정으로 대신 정의됩니다.
이미지 해상도를 설정하는 이러한 두 가지 형식은 질문에 대한 기본 이미지를 제공하여 덮어쓰며, 이 경우 기본 이미지의 해상도가 적용됩니다. 이는 제출된 모든 이미지에 대한 표준 해상도를 보장하는 데 사용할 수 있습니다. 애노테이션을 위한 맵 스냅샷을 제공하면 볼 수 있는 캔버스 영역의 크기로 이미지가 설정되면서 다른 이미지 해상도 설정도 덮어씁니다.
Spike 이미지
이미지 질문은 모양을 지원하여 ikeGPS가 개발한 레이저 측정 솔루션인 Survey123와 Spike을 통합함으로써 사진에서 객체의 위치 및 측정을 취득할 수 있습니다. 모양을 spike, spike 전체 측정, spike 지점 간 측정으로 설정하면 이미지 질문에 iOS 및 Android 기기에서 Spike 모바일 앱을 열 수 있는 버튼이 표시됩니다.
Spike 앱 및 레이저 기기로 촬영한 사진을 통해 객체의 좌표와 객체까지의 거리를 기록하고 면적 및 라인 그리기를 통해 사진에서 객체의 치수를 측정할 수 있습니다. 그러면 측정 마크업이 있는 사진이 현장조사에 첨부되고 좌표 및 측정값을 포함한 사진의 메타데이터를 기록할 수 있게 됩니다. 연관된 Spike 및 측정 메타데이터는 표준 EXIF(Exchangeable Image File) 태그를 사용하여 이미지 파일에 기록됩니다. 그러면 EXIF 정보를 추출하여 다른 필드를 채우는 데 사용할 수 있습니다.
Spike 모양의 차이점은 이미지에 저장된 값의 범위입니다. spike 모양은 거리 및 위치만 측정하지만 spike 전체 측정 모양은 거리, 위치, 면적, 길이를 측정합니다. spike 지점 간 측정 모양은 해당 모양에만 사용되는 일련의 값을 취득합니다. 이러한 값은 P2P로 시작하는 등록정보 이름으로 표시됩니다.
EXIF 태그에 대한 자세한 내용은 Spike 통합을 참고하세요. Spike에 대한 자세한 내용은 Spike 웹사이트를 참고하세요.
비고:
Spike 통합은 Survey123 웹 앱에서 지원되지 않습니다.
정수(Integer)
모양을 디스트레스로 설정하면 정수 질문의 선택 항목이 불안 척도로 제공됩니다. 불안 척도란 스트레스, 고통, 행복감 등의 감정을 평가하는 데 사용되는 10점 만점 평가입니다.
모양을 스피너로 설정하면 정수 질문에 값을 1씩 늘리거나 줄이는 버튼이 표시됩니다. 버튼을 선택하면 놓을 때까지 값 증감이 계속 진행됩니다.
모양을 숫자로 설정하면 강조된 정수 질문이 값을 입력할 수 있는 사용자 설정 숫자 키보드와 함께 제공됩니다. 이 키보드에는 값을 양수나 음수로 설정하는 버튼도 포함되어 있습니다.
모양을 계산기로 설정하면 강조된 정수 질문이 값을 입력 및 수정할 수 있는 사용자 설정 계산기 키보드와 함께 제공됩니다.
비고:
디스트레스, 스피너, 숫자, 계산기 모양은 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단위 구분 기호가 표시되지 않습니다.
비고:
스피너, 숫자, 계산기, 천 단위 구분 기호 모양은 Survey123 웹 앱에서 지원되지 않습니다.
범위
모양을 눈금 없음으로 설정하면 범위 질문은 범위 슬라이더의 위치를 표시하는 라인이나 최소값과 최대값 없이 표시됩니다. 이 경우 질문의 동작은 변경되지 않으며 화면 표시만 변경됩니다. 범위 질문 유형에 대한 자세한 내용은 범위를 참고하세요.
바코드
모양을 숨김으로 설정하면 바코드 질문에는 스캐너를 시작하기 위한 버튼 하나만 나타납니다. 바코드 질문의 값이 포함되는 텍스트 상자는 나타나지 않습니다. 바코드 질문 유형에 대한 자세한 내용은 바코드를 참고하세요.
그룹
그룹 시작 질문의 모양을 축소로 설정하면 질문 그룹이 시작 시 축소되어 나타나며 사용자가 확장할 수 있습니다. 이는 사용자가 읽고 탐색하기에 어려울 수 있는 긴 현장조사에 유용합니다. 이 모양은 시작 그룹 질문에 정의됩니다.
숨김 모양에는 그룹 질문에 대한 효과가 없습니다.
그룹 시작 질문의 모양을 테이블 목록으로 설정한 경우 공통 선택 항목 목록을 가진 그룹의 단답형 질문이 테이블 형식으로 나타납니다. 이 테이블의 맨 위 행에는 선택 항목 목록 레이블이 표시되며 좌측 열에는 질문 레이블이 표시됩니다.
설정 시트의 스타일 열을 페이지로 설정하고 각 그룹 시작 질문의 모양을 현장 목록으로 설정하면 각 그룹이 별도의 현장조사 페이지에 표시됩니다. 앱 하단의 뒤로 및 앞으로 버튼을 사용하여 페이지를 탐색할 수 있습니다. 이 버튼을 길게 눌러 현장조사의 시작 또는 끝을 탐색할 수 있습니다. 페이지 번호를 선택하여 쓰기 가능한 필드로 변환하고 새 페이지 번호를 입력할 수도 있습니다. 이는 현장조사 표시 항목을 나누어 구성하고 불러오기 시간을 줄이는 데 유용합니다.
주의:
페이지 스타일을 사용할 때 현장조사의 각 질문은 현장 목록 모양을 사용하는 그룹에 있어야 합니다.
설정 시트의 스타일 열을 fixed-grid 또는 dynamic-grid로 설정하면 현장조사의 그룹에 포함된 질문이 격자에 표시되도록 설정할 수 있습니다.
고정 격자 스타일은 숨김 모양을 포함하여 각 질문에 대한 플레이스 홀더를 만듭니다. 관련 조건이 충족되면 질문이 나타나고, 그렇지 않으면 공백이 양식에서 해당 위치를 차지합니다.
동적 격자 스타일을 사용하면 관련 조건에 따라 양식에서 질문 및 그룹이 이동할 수 있으므로 기기 화면의 공간을 최대한 활용할 수 있습니다.
설정 워크시트의 격자 레이아웃 스타일은 전체 현장조사에 적용되는 전역 설정입니다. 또한 개별 그룹 또는 반복에 격자 레이아웃 스타일을 적용하여 현장조사의 다른 부분에 다양한 스타일을 사용할 수 있습니다. 그룹 또는 반복 질문의 body::esri:style 열에 다음 중 하나를 입력하여 전역 설정을 재정의할 수 있습니다.
- layout=dynamic-grid
- layout=fixed-grid
그룹의 너비 모양을 w와 격자 분할에 사용되는 열 수로 설정합니다. 예를 들어 w4는 격자의 각 행을 4개 열로 나눕니다. 너비 매개변수는 그룹 또는 반복 내의 질문에도 적용되어 질문이 포괄되어야 하는 상위 그룹 또는 반복의 열 수를 제어합니다. 지정된 질문 너비를 합하여 그룹에 설정된 열 수에 도달하면 다음 질문이 새로운 라인에 표시됩니다. 이러한 너비는 대부분의 다른 모양과 함께 설정할 수 있습니다.
다음 예시에서 수온, 용존 산소량, pH, 전도도에 대한 너비 모양은 각각 w1이고 물 샘플 위치에 대한 너비 모양은 w2입니다.
다음 예시에서 그룹의 너비는 3개의 열(w3)입니다. 첫 번째 반복에서는 2개의 열이 정의되고 이 2개의 열은 상위 열(w2:2) 중 2개에 걸쳐 있습니다. 두 번째 반복에서는 2개의 열이 정의되고 이 2개의 열은 상위 열(w2:1) 중 1개에 걸쳐 있습니다.
다음 이미지는 이러한 중첩 반복이 양식의 그룹에 표시되는 방법을 보여줍니다.
웹 앱에 양식을 표시하려면 웹 앱 실행을 위한 URL 매개변수 너비를 추가하여 전체 화면 너비가 사용되도록 합니다. 다음 이미지에서 그룹의 너비는 8개의 열(w8)이고, 그룹 내의 질문의 너비는 페이지를 적절히 채우기 위해 w2, w3 또는 w5이며, 현장조사 URL에는 ?width=1이 추가되어 브라우저의 전체 너비를 사용합니다.
비고:
테이블 목록 모양은 선다형 질문을 지원하지 않으며 선택 항목 목록 내의 미디어도 지원하지 않습니다.
테이블 목록 모양은 테마 격자 그룹에 배치된 경우 작동하지 않습니다.
이전에는 동적 격자 스타일이 테마 격자로 불렸습니다. 테마 격자 스타일은 이전 버전과의 호환성을 위해 계속 지원되지만, 새 현장조사의 경우 동적 격자 또는 고정 격자 스타일을 사용하는 것을 권장합니다.
격자 레이아웃 스타일 그룹에서는 borderColor가 지원되지 않습니다.
파일
모양을 다중 행으로 설정하면 파일 질문은 단일 파일 질문에 여러 개의 파일을 허용합니다. 제약 조건 열의 count-selected 함수를 사용하여 제출할 수 있는 파일 수를 제어할 수 있습니다. 예를 들어, count-selected(${file_question}) <= 5에서 제출할 수 있는 파일 수는 최대 5개로 제한됩니다.
반복
반복 시작 질문의 모양을 숨김으로 설정하면 반복 가능한 질문 컬렉션이 시작 시 표시되지 않습니다. 반복의 질문을 보려면 사용자가 추가 버튼을 클릭해야 합니다. 이 버튼은 현장조사에서 반복된 질문을 완료할 필요가 없는 경우에 유용합니다. 이 모양은 시작 반복 질문에 정의됩니다.
반복이 숨김으로 설정되어 있고 반복 수가 0인 경우 반복 컨트롤과 해당 레이블이 표시되지 않습니다.
반복 시작 질문의 모양을 축소로 설정하면 반복 가능한 질문 컬렉션이 시작 시 축소된 상태로 나타나며 사용자가 확장할 수 있습니다. 이는 사용자가 읽고 탐색하기에 어려울 수 있는 대규모 현장조사에 유용합니다. 이 모양은 시작 반복 질문에 정의됩니다.
다른 모양과는 달리 반복은 모양을 숨김-축소로 설정하여 숨김과 축소를 모두 동시에 사용할 수 있습니다. 이는 질문을 축소된 방식과 숨겨진 방식 둘 다로 반복에 표시합니다.
설정 시트의 스타일 열을 페이지로 설정하고 각 반복 시작 질문의 모양을 현장 목록으로 설정하면 반복 가능한 질문 컬렉션이 각각 별도의 현장조사 페이지에 표시됩니다. 이 동작은 그룹에서도 동일합니다.
설정 시트의 스타일 열을 고정 격자 또는 동적 격자로 설정하면 현장조사의 반복에 포함된 질문이 격자 레이아웃으로 표시되도록 설정할 수 있습니다. 이 동작은 그룹에서도 동일합니다.