XLSForm의 질문 유형 중 일부에는 현장조사에서 질문의 스타일 또는 동작을 제어할 수 있는 추가 매개변수가 있습니다. 이러한 매개변수는 어떤 경우에는 질문 유형이 지원하는 모양을 보완합니다. 모든 매개변수가 모든 제출 앱(Survey123 Mobile, Survey123 현장 앱, Survey123 웹 앱)에서 지원되는 것은 아닙니다. 앱 지원에 대한 자세한 내용은 아래의 매개변수 테이블을 참조하세요. 이 테이블은 질문 유형 및 각 매개변수를 입력할 수 있는 현장조사 워크시트의 XLSForm 열을 기준으로 구성되어 있습니다.
매개변수를 공백으로 구분하여 동일한 열에 질문에 대한 여러 매개변수를 추가할 수 있습니다. 예를 들어, 범위 질문의 body::esri:style 열에는 다음과 같이 startColor, endColor, color 매개변수를 포함할 수 있습니다.startColor=Orange endColor=White color=#FF6347
일반
이 섹션에서는 여러 질문 유형의 bind::esri:parameters 및 body::esri:style XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.
다음 테이블에서는 텍스트, 정수, 소수, 비고, 날짜, 시간, 날짜 및 시간, 단답형, 선다형, 지오포인트, 계산, 숨김 질문 유형의 bind::esri:parameters XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.
bind::esri:parameters
| 매개변수 | 설명 | 제출 앱 |
|---|---|---|
| calculationMode | 질문의 계산이 계산되는 시기를 제어합니다. 값: auto | manual | always | whenEmpty 예: | 웹 앱 현장 앱 |
다음 테이블에서는 텍스트, 정수, 소수, 단답형(자동 완성 모양 사용), 선다형(자동 완성 모양 사용), 바코드 질문 유형의 body::esri:style XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.
body::esri:style
| 매개변수 | 설명 | 제출 앱 |
|---|---|---|
| placeholderText | 질문이 비어 있는 경우 질문의 입력 영역에 나타나는 텍스트를 지정합니다. 값: @[hint] | @[guidance_hint] 예: | Survey123 Mobile 현장 앱 |
*Survey123 Mobile에서만 지원됩니다.
오디오
다음 테이블에서는 오디오 질문 유형의 bind::esri:parameters XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.
bind::esri:parameters
| 매개변수 | 설명 | 제출 앱 |
|---|---|---|
| 코덱 | 오디오 녹음의 기본 코덱을 지정합니다. 여러 코덱을 쉼표로 구분하여 제공할 수 있습니다. 기기와 호환되는 첫 번째 코덱이 사용됩니다. 값: <codec name> 예: | Survey123 Mobile 현장 앱 |
| fileName | 파일 이름을 지정합니다. 값: <expression> 예: | 웹 앱 |
| max-duration | 오디오 녹음의 최대 지속 시간(초)을 지정합니다. 웹 앱의 기본 지속 시간은 600(10분)입니다. 값: <seconds> 예: | Survey123 Mobile 웹 앱 현장 앱 |
| max-size | 오디오 녹음의 최대 파일 크기(메가바이트)를 지정합니다. 현장 앱의 기본 크기는 10MB입니다. 값: <megabytes> 예: | Survey123 Mobile 현장 앱 |
바코드
다음 테이블에서는 바코드 질문 유형의 body::esri:style XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.
body::esri:style
| 매개변수 | 설명 | 제출 앱 |
|---|---|---|
사용자가 스캔할 수 있는 바코드의 유형을 지정합니다. 여러 유형을 쉼표로 구분하여 제공할 수 있습니다. barcodeType 매개변수가 제공되지 않으면 지원되는 모든 바코드 유형은 aztec, code39, datamatrix, maxicode, pdf417을 제외하고 스캔할 수 있습니다. 값: all | 1d | 2d | <barcode types>
1차원 유형: codabar | code128 | code39 | code93 | ean13 | ean8 | itf | upca | upce | upceanextension 2차원 유형: aztec | datamatrix | maxicode | pdf417 | qrcode | rss14 | rssexpanded 예: | 현장 앱 |
파일
다음 테이블에서는 파일 질문 유형의 bind::esri:parameters XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.
bind::esri:parameters
그룹
다음 테이블에서는 그룹 시작 질문 유형의 body::esri:style XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.
body::esri:style
| 매개변수 | 설명 | 제출 앱 |
|---|---|---|
| backgroundColor borderColor | 그룹 또는 페이지의 배경 및 경계 색상을 설정합니다. 자세한 내용은 그룹, 페이지, 반복 색상을 참고하세요. 값: <HTML color name> | <hex color code> 예:
| Survey123 Mobile 현장 앱 |
| 그룹의 그리드 레이아웃 스타일을 설정합니다. 값: dynamic-grid | fixed-grid 예: | 현장 앱 |
이미지
이 섹션에서는 이미지 질문 유형의 지정된 XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.
다음 테이블에서는 bind::esri:parameters XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.
bind::esri:parameters
| 매개변수 | 설명 | 제출 앱 |
|---|---|---|
| allowAdds | 기존 레코드를 편집할 때 새 이미지 추가를 비활성화합니다. 값: false 예: | 현장 앱 |
| fileName | 파일 이름을 지정합니다. 값: <expression> 예: | 웹 앱 현장 앱 |
| max-size | 최대 파일 크기(MB)를 지정합니다. 기본값은 10MB입니다. 값: <megabytes> 예: | 웹 앱 |
애노테이트 모양이 있는 이미지 질문의 경우, 감지된 객체 주위에 경계 상자 및 레이블의 애노테이션 그래픽을 자동으로 생성합니다. 애노테이션의 스타일 및 서식을 정의하려면 이러한 등록정보를 추가합니다. 필수 등록정보: <model_name> 선택 등록정보: minScore | cameraPreview | label | class | boundingBoxes | outlineWidth | fontSize | font | bold | italic 예: | 현장 앱 | |
객체 감지 또는 이미지 분류를 수행하고 현장조사에서 EXIF 결과를 사용합니다. 필수 등록정보: <model_name> 선택 등록정보: minScore | cameraPreview | label | class 예: | 현장 앱 | |
경계 상자를 자동으로 생성하거나 수동으로 추가하고 대상 영역에 수정 효과를 적용합니다. 필수 등록정보: <model_name> | @faces | @manual 선택 등록정보: minScore | cameraPreview | label | class | effect | symbol | fillColor | scale 예: | 현장 앱 | |
watermark topLeftWatermark topCenterWatermark topRightWatermark leftCenterWatermark centerWatermark rightCenterWatermark bottomLeftWatermark bottomCenterWatermark bottomRightWatermark | 이미지 워터마크의 위치를 지정합니다. 내용 및 서식을 정의하기 위해 등록정보를 추가합니다. 자세한 내용은 워터마크를 참고하세요. 등록정보: text | color | outlineColor | outlineWidth | haloColor | size | font | bold | italic | margin | image | imageSize 예: | 현장 앱 |
다음 테이블에서는 이미지 질문 유형의 body::esri:style XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.
body::esri:style
| 매개변수 | 설명 | 제출 앱 |
|---|---|---|
| allowRename | 사용자가 파일 이름을 수동으로 편집할 수 있는지 여부를 지정합니다. 값: true | false 예: | 현장 앱 |
| fileNameVisible | 파일 이름이 현장조사에 표시되는지 여부를 지정합니다. 값: true | false 예: | 현장 앱 |
| footerText | 서명 모양이 있는 이미지 질문의 경우 서명 팝업 하단에 표시할 텍스트를 지정합니다. 값을 지정하지 않으면 서명 아래에 질문의 안내 힌트가 나타납니다. 이는 footerText=@[hint]을(를) 사용하여 질문의 힌트로 변경할 수 있습니다. 값: <none> | @[hint] 예: | Survey123 Mobile 현장 앱 |
| 방법 | 이미지 질문에 대한 캡처 방법을 지정합니다. map 값은 애노테이트 모양이 있는 이미지 질문에만 지원됩니다. 값: browse | camera | map 예: | 웹 앱 현장 앱 |
| palette | 그리기 또는 애노테이트 모양이 있는 이미지 질문의 경우 사용자 설정 그리기 도구 팔레트를 지정합니다. 값: <palette name> 예: | 현장 앱 |
| previewHeight | 이미지를 선택한 후 이미지 미리 보기의 높이를 설정합니다. 이미지 미리 보기에서 불필요한 공백을 제거해 최대 크기로 설정하려면 previewHeight=0을 사용합니다. 값: <lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels 예: | 현장 앱 |
다음 테이블에서는 이미지 질문 유형의 parameters XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.
parameters
| 매개변수 | 설명 | 제출 앱 |
|---|---|---|
| max-pixels | 이미지 질문의 경우 기존 종횡비를 유지하면서 가장 긴 가장자리에서 이미지의 최대 크기를 설정합니다. 서명 모양이 있는 이미지 질문의 경우 서명 팝업의 최대 너비를 설정합니다. 그리기 모양이 있는 이미지 질문의 경우 캔버스를 사각형(1:1) 이미지로 설정합니다. 값: <pixels> 예: | 웹 앱 현장 앱 |
맵 질문
다음 테이블에서는 지오포인트, 지오추적, 지오쉐이프 질문 유형의 지정된 XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.
다음 테이블에서는 bind::esri:parameters XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.
bind::esri:parameters
| 매개변수 | 설명 | 제출 앱 |
|---|---|---|
지오코딩된 결과를 반환하도록 로케이터를 설정합니다. 값: <locator item ID> 예: | 웹 앱 현장 앱 |
다음 테이블에서는 지오포인트, 지오추적, 지오쉐이프 질문 유형의 body::esri:style XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.
body::esri:style
| 매개변수 | 설명 | 제출 앱 |
|---|---|---|
| height | 맵 미리보기의 높이를 설정합니다. 값: <lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels 예: | 현장 앱 |
lineColor2 fillColor3 | 라인 또는 폴리곤 피처의 라인 및 채우기 색상을 지정합니다. 이는 Survey123의 맵 미리 보기에만 적용됩니다. 자세한 내용은 지오메트리 심볼을 참고하세요. 값: <HTML color name> | <hex color code> 예: | Survey123 Mobile 현장 앱 |
| lineWidth2 | 라인 또는 폴리곤 피처의 라인 너비를 픽셀 단위로 지정합니다. 이는 Survey123의 맵 미리 보기에만 적용됩니다. 값: <pixels> 예: | Survey123 Mobile 현장 앱 |
| map | 기본 베이스맵을 설정합니다. 값: <map name> | <map item ID> 예: | 웹 앱 현장 앱 |
mapTools | 지오포인트, 지오추적, 지오쉐이프 질문에 사용할 수 있는 맵 도구를 제어합니다. 값: search | mapSwitcher | zoom | home | locate 예: | 현장 앱 |
| method2 | 취득 방법을 지정합니다. 버텍스 방법을 사용하는 경우 추가 매개변수를 설정할 수 있습니다. 값: sketch | vertex 현장 앱 streaming | beep | haptic | edit 에만 해당되는 버텍스에 대한 추가 값 예: | 웹 앱 현장 앱 |
| minCaptureZoomLevel | 지오메트리를 취득할 수 있는 최소 수준을 지정합니다. 값: <integer> 예: | 웹 앱 |
| overlay | 해당 현장조사에서 다른 모든 지오포인트, 지오쉐이프 또는 지오추적 질문에 대한 반복 내 첫 번째 지오포인트 질문의 포인트 위치를 표시합니다. 내용 및 스타일을 정의하기 위해 등록정보를 추가합니다. 값: <repeat name> 등록정보: view | preview | icon | iconColor | iconOutlineColor | iconSize | label | labelColor | labelOutlineColor | fontSize 예: | 현장 앱 |
precision | 맵 질문에 취득하고 현장조사의 개별 응답 패널에 표시할 소수 자릿수를 지정합니다. 해당 매개변수가 설정되지 않은 경우 사용 가능한 모든 소수 자릿수가 맵 질문에 취득되지만 개별 응답 패널에는 6자리의 소수 자릿수만 표시됩니다. 값: <integer> 예: | 웹 앱 |
| snapMode | 스내핑 동작을 지정합니다. 포인트는 다른 피처에 스내핑할 수 있고 라인 및 폴리곤은 다른 피처 또는 그 자체에 스내핑할 수 있습니다. method=vertex인 경우에만 사용할 수 있습니다. 값: feature | self2 예: | 웹 앱 |
| symbol1 | 맵에서 포인트 마커로 사용할 .png 파일을 지정합니다. 위치 및 크기를 정의하기 위해 등록정보를 추가합니다. 값: <file name>.png 등록정보: x | y | scale 예: | 현장 앱 |
1 — 지오포인트 질문 유형에서만 지원됩니다.
2 — 지오쉐이프 및 지오추적 질문 유형에서만 지원됩니다.
3 — 지오쉐이프 질문 유형에서만 지원됩니다.
선다형 질문
다음 테이블에서는 단답형, 선다형, 순위 질문 유형의 parameters XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.
parameters
| 매개변수 | 설명 | 제출 앱 |
|---|---|---|
| 랜덤화 | 선택 목록의 선택 항목 순서를 랜덤화합니다. 값: true 예: | 웹 앱 현장 앱 |
범위
이 섹션에서는 범위 질문 유형의 지정된 XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다. 매개변수를 함께 사용하는 경우, 공백으로 구분해야 합니다.
다음 테이블에서는 body::esri:style XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다. 자세한 내용은 스타일 옵션을 참고하세요.
body::esri:style
| 매개변수 | 설명 | 제출 앱 |
|---|---|---|
startColor endColor color | 범위 슬라이더의 색상을 지정합니다.
값: <HTML color name> | <hex color code> 예: | Survey123 Mobile 웹 앱 현장 앱 |
다음 테이블에서는 범위 질문 유형의 parameters XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다. 자세한 내용은 범위 슬라이더 매개변수를 참고하세요.
parameters
| 매개변수 | 설명 | 제출 앱 |
|---|---|---|
start end step | 범위 슬라이더의 시작, 끝, 단계 값을 지정합니다. 값: <integer> | <decimal> 예: | Survey123 Mobile 웹 앱 현장 앱 |
반복
이 섹션에서는 반복 시작 질문 유형의 지정된 XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.
다음 테이블에서는 bind::esri:parameters XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.
bind::esri:parameters
| 매개변수 | 설명 | 제출 앱 |
|---|---|---|
| allowAdds | 새 반복 레코드를 추가할 수 있습니다. 값: true | false 예: | 현장 앱 |
| allowUpdates | 기존의 반복 레코드를 수정할 수 있습니다. 값: true | false 예: | 현장 앱 |
| query | 기존의 반복 레코드를 양식에 표시할 수 있습니다. 사용 가능한 레코드를 필터링하려면 추가 쿼리 매개변수를 지정합니다. 값: <none> | "SQL statement" 예: | 현장 앱 |
다음 테이블에서는 반복 시작 질문 유형의 body::esri:style XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.
body::esri:style
| 매개변수 | 설명 | 제출 앱 |
|---|---|---|
| backgroundColor borderColor | 반복의 배경 및 경계 색상을 설정합니다. 자세한 내용은 그룹, 페이지, 반복 색상을 참고하세요. 값: <HTML color name> | <hex color code> 예:
| Survey123 Mobile 현장 앱 |
테이블 형식 모양이 적용된 반복의 경우 테이블 형식 뷰에서 레코드 추가 버튼 및 새 레코드로 복사 옵션의 모드를 지정합니다. 기본값은 row입니다. 값이 row이면 새 레코드가 테이블 형식 뷰에 추가됩니다. 값이 form이면 새 레코드가 양식 뷰에서 열립니다. 값: row | form 예: | Survey123 Mobile | |
테이블 형식 모양이 적용된 반복의 경우 테이블 형식 뷰에서 양식 뷰에서 편집 옵션을 표시하거나 숨깁니다. 기본값은 true입니다. 비고:반복에 오류가 있는 경우, editInFormView 매개변수가 false로 설정되어 있는 경우에도 양식 뷰에서 편집 옵션이 활성화됩니다. 값: true | false 예: | Survey123 Mobile | |
테이블 형식 모양이 적용된 반복의 경우 테이블 형식 뷰에서 새 레코드로 복사 옵션을 표시하거나 숨깁니다. 이 옵션을 사용하면 사용자가 반복에 포함된 레코드를 복제할 수 있습니다. 기본값은 true입니다. addRecordMode 매개변수는 복제된 레코드가 추가되는 방식을 결정합니다. 값: true | false 예: | Survey123 Mobile | |
테이블 형식 모양이 적용된 반복의 경우 테이블 형식 뷰에서 편집을 활성화하거나 비활성화합니다. 기본값은 true입니다. 값이 false이면 테이블 형식 뷰의 모든 셀이 읽기 전용이 됩니다. 값: true | false 예: | Survey123 Mobile |
다음 테이블에서는 테이블 형식 반복에 포함된 질문의 body::esri:style XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.
body::esri:style
| 매개변수 | 설명 | 제출 앱 |
|---|---|---|
테이블 형식 모양이 적용된 반복의 경우 테이블 형식 뷰에서 질문을 열로 표시합니다. 기본값은 false입니다. 값: true | false 예: | Survey123 Mobile |
텍스트
이 섹션에서는 텍스트 질문 유형의 지정된 XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.
다음 테이블에서는 bind::esri:parameters XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.
bind::esri:parameters
| 매개변수 | 설명 | 제출 앱 |
|---|---|---|
| 지오코드 | 지오코드 모양이 있는 텍스트 질문의 경우 지오코드 모양을 사용할 때 지오코딩된 결과를 반환하도록 로케이터를 설정합니다. 값: <locator item ID> 예: | 웹 앱 현장 앱 |
다음 테이블에서는 텍스트 질문 유형의 body::esri:style XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.
body::esri:style
| 매개변수 | 설명 | 제출 앱 |
|---|---|---|
| defaultHeight | 다중 행 모양의 텍스트 질문의 경우 텍스트 상자의 처음 높이를 설정합니다. 답변 텍스트를 수용할 수 있도록 텍스트 상자의 높이가 증가합니다. 값: <number of lines> 예: | 현장 앱 |
| indicator | 지오코드 모양의 텍스트 질문의 경우, 지오코딩된 결과가 현재 기기 위치로부터의 방향과 거리를 표시하도록 허용합니다. 값: direction | distance | none 예: | 현장 앱 |
| maxResults | 지오코드 모양의 텍스트 질문의 경우 반환할 최대 결과 수를 지정합니다. 기본값은 6입니다. 값: <number of results> 예: | 웹 앱 현장 앱 |
| 인접도 | 지오코드 모양이 있는 텍스트 질문의 경우 지오코딩된 결과가 기기 위치의 특정 반경 내에서만 결과를 표시할지 여부를 지정합니다. 값: <distance>m | km | ft | mi | yd 예: | 현장 앱 |
| 제안 | 지오코드 모양이 있는 텍스트 질문의 경우 제안이 채워지는 방식을 변경합니다. 기본값은 예입니다. 값: yes | no 예: | 현장 앱 |
거리 측정기
다음 테이블에서는 거리 측정기에서 값을 가져오기 위해 텍스트, 정수, 소수 질문 유형의 bind::esri:parameters XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.
bind::esri:parameters
| 매개변수 | 설명 | 제출 앱 |
|---|---|---|
측정 | 모양이 거리 측정기인 텍스트, 소수, 정수 질문의 경우, 질문에 어떤 측정을 저장할지 설정합니다. 값에 공백이 포함된 경우 값의 목록을 따옴표 안에 넣습니다. 값: height | azimuth | horizontalDistance | slopeDistance | inclination | multipleHeights 예: | 현장 앱 |