XLSForm의 질문 유형 중 일부에는 현장조사에서 질문의 스타일 또는 동작을 제어할 수 있는 추가 매개변수가 있습니다. 이러한 매개변수는 어떤 경우에는 질문 유형이 지원하는 모양을 보완합니다. 아래 테이블은 XLSForm에 사용할 수 있는 매개변수의 오버뷰 및 각 매개변수를 허용하는 현장조사 워크시트의 열을 제공합니다. 모든 매개변수가 ArcGIS Survey123 현장 앱 및 웹 앱 모두에서 지원되는 것은 아닙니다. 현장 앱 및 웹 앱 지원에 대한 자세한 내용은 각 매개변수에 대한 설명서 항목을 참조하세요.
매개변수를 공백으로 구분하여 동일한 열에 질문에 대한 여러 매개변수를 추가할 수 있습니다. 예를 들어, 지오쉐이프 질문은 다음과 같이 body::esri:style 열에 map, method, lineColor, fillColor 매개변수를 포함할 수 있습니다.
map="Imagery Hybrid" method=vertex lineColor=#DC143C fillColor=LightYellow
일반
다음 테이블에는 다양한 질문 유형과 함께 사용할 수 있는 XLSForm 매개변수가 포함되어 있습니다. 지원하는 질문 유형의 목록은 각 매개변수의 설명을 참조하세요. 이러한 매개변수는 현장 앱에서만 지원됩니다.
XLSForm 열 | 매개변수 | 설명 |
---|---|---|
bind::esri:parameters | calculationMode | 질문의 계산이 계산되는 시기를 제어합니다. 질문 유형: text | decimal | integer | note | date | time | dateTime | select_one | select_multiple | geopoint | calculate | hidden 값: auto | manual | always | whenEmpty 예:
|
body::esri:style | placeholderText | 질문이 비어 있는 경우 질문의 입력 영역에 나타나는 텍스트를 지정합니다. 질문 유형: text | integer | decimal | select_one(자동 완성 모양 포함) | barcode 값: @[hint] | @[guidance_hint] 예:
|
오디오
다음 테이블에는 오디오 질문 유형과 함께 사용할 수 있는 XLSForm 매개변수가 포함되어 있습니다. 이러한 매개변수는 설명에 달리 명시되지 않은 한 현장 앱에서만 지원됩니다.
XLSForm 열 | 매개변수 | 설명 |
---|---|---|
bind::esri:parameters | codec | 오디오 녹음의 기본 코덱을 지정합니다. 여러 코덱을 쉼표로 구분하여 제공할 수 있습니다. 기기와 호환되는 첫 번째 코덱이 사용됩니다. 값: <codec name> 예:
|
fileName | 파일 이름을 지정합니다. 값: <expression> 이 매개변수는 웹 앱에서만 지원됩니다. 예:
| |
max-duration | 오디오 녹음의 최대 지속 시간(초)을 지정합니다. 웹 앱의 기본 지속 시간은 600(10분)입니다. 값: <seconds> 예:
| |
max-size | 오디오 녹음의 최대 파일 크기(메가바이트)를 지정합니다. 현장 앱의 기본 크기는 10MB입니다. 값: <megabytes> 예:
|
바코드
다음 테이블에는 바코드 질문 유형과 함께 사용할 수 있는 XLSForm 매개변수가 포함되어 있습니다. 이러한 매개변수는 현장 앱에서만 지원됩니다.
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 예:
|
파일
다음 테이블에는 파일 질문 유형과 함께 사용할 수 있는 XLSForm 매개변수가 포함되어 있습니다.
그룹
다음 테이블에는 그룹 시작 질문 유형과 함께 사용할 수 있는 XLSForm 매개변수가 포함되어 있습니다. 이러한 매개변수는 현장 앱에서만 지원됩니다.
XLSForm 열 | 매개변수 | 설명 |
---|---|---|
body::esri:style | backgroundColor borderColor | 그룹 또는 페이지의 배경 및 경계 색상을 설정합니다. 자세한 내용은 그룹, 페이지, 반복 색상을 참고하세요. 값: <HTML color name> | <hex color code> 예:
|
layout | 그룹의 그리드 레이아웃 스타일을 설정합니다. 값: dynamic-grid | fixed-grid 예:
|
이미지
다음 테이블에는 이미지 질문 유형과 함께 사용할 수 있는 XLSForm 매개변수가 포함되어 있습니다. 이러한 매개변수는 설명에 달리 명시되지 않은 한 현장 앱에서만 지원됩니다.
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 | allowRename | 사용자가 파일 이름을 수동으로 편집할 수 있는지 여부를 지정합니다. 값: true | false 예:
|
fileNameVisible | 파일 이름이 현장조사에 표시되는지 여부를 지정합니다. 값: true | false 예:
| |
footerText | 서명 모양이 있는 이미지 질문의 경우 서명 팝업 하단에 표시할 텍스트를 지정합니다. 값을 지정하지 않으면 서명 아래에 질문의 안내 힌트가 나타납니다. 이는 footerText=@[hint]을(를) 사용하여 질문의 힌트로 변경할 수 있습니다. 값: <none> | @[hint] 예:
| |
method | 이미지 질문에 대한 캡처 방법을 지정합니다. map 값은 애노테이트 모양이 있는 이미지 질문에만 지원됩니다. 이 매개변수는 웹 앱에서도 지원됩니다. 값: browse | camera | map 예:
| |
palette | 그리기 또는 애노테이트 모양이 있는 이미지 질문의 경우 사용자 설정 그리기 도구 팔레트를 지정합니다. 값: <palette name> 예:
| |
previewHeight | 이미지를 선택한 후 이미지 미리 보기의 높이를 설정합니다. 이미지 미리 보기에서 불필요한 공백을 제거해 최대 크기로 설정하려면 previewHeight=0을 사용합니다. 값: <lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels 예:
| |
parameters | max-pixels | 이미지 질문의 경우 기존 종횡비를 유지하면서 가장 긴 가장자리에서 이미지의 최대 크기를 설정합니다. 서명 모양이 있는 이미지 질문의 경우 서명 팝업의 최대 너비를 설정합니다. 그리기 모양이 있는 이미지 질문의 경우 캔버스를 사각형(1:1) 이미지로 설정합니다. 이 매개변수는 웹 앱에서도 지원됩니다. 값: <pixels> 예:
|
맵 질문
다음 테이블에는 지오포인트, 지오추적, 지오쉐이프 질문 유형과 함께 사용할 수 있는 XLSForm 매개변수가 포함되어 있습니다. 이러한 매개변수는 설명에 달리 명시되지 않은 한 현장 앱에서만 지원됩니다.
XLSForm 열 | 매개변수 | 설명 |
---|---|---|
body::esri:style | height | 맵 미리보기의 높이를 설정합니다. 값: <lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels 예:
|
lineColor² fillColor³ | 라인 또는 폴리곤 피처의 라인 및 채우기 색상을 지정합니다. 이는 Survey123의 맵 미리 보기에만 적용됩니다. 자세한 내용은 스타일 옵션을 참고하세요. 값: <HTML color name> | <hex color code> 예:
| |
lineWidth² | 라인 또는 폴리곤 피처의 라인 너비를 픽셀 단위로 지정합니다. 이는 Survey123의 맵 미리 보기에만 적용됩니다. 값: <pixels> 예:
| |
map | 기본 베이스맵을 설정합니다. 이 매개변수는 웹 앱에서도 지원됩니다. 값: <map name> | <map item ID> 예:
| |
mapTools | 지오포인트, 지오추적, 지오쉐이프 질문에 사용할 수 있는 맵 도구를 제어합니다. 이 매개변수는 현장 앱에서만 지원됩니다. 값: search | mapSwitcher | zoom | home | locate 예:
| |
method² | 취득 방법을 지정합니다. 버텍스 방법을 사용하는 경우 추가 매개변수를 설정할 수 있습니다. 이 매개변수는 웹 앱에서도 지원됩니다. 값: 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 | self² 예:
| |
symbol¹ | 맵에서 포인트 마커로 사용할 .png 파일을 지정합니다. 위치 및 크기를 정의하기 위해 등록정보를 추가합니다. 값: <file name>.png 등록정보: x | y | scale 예:
|
¹지오포인트 질문 유형에서만 지원됩니다.
²지오쉐이프 및 지오추적 질문 유형에서만 지원됩니다.
³지오쉐이프 질문 유형에서만 지원됩니다.
선다형 질문
다음 테이블에는 단답형, 선다형, 순위 질문 유형과 함께 사용할 수 있는 XLSForm 매개변수가 포함되어 있습니다. 이 매개변수는 필드 앱과 웹 앱에서 지원됩니다.
XLSForm 열 | 매개변수 | 설명 |
---|---|---|
parameters | randomize | 선택 목록의 선택 항목 순서를 랜덤화합니다. 값: true 예:
|
범위
다음 테이블에는 범위 질문 유형과 함께 사용할 수 있는 XLSForm 매개변수가 포함되어 있습니다. 이러한 매개변수는 현장 앱과 웹 앱에서 지원됩니다.
XLSForm 열 | 매개변수 | 설명 |
---|---|---|
body::esri:style | startColor endColor color | 범위의 시작과 끝에서 슬라이더의 색상을 지정합니다. color 매개변수를 사용하여 슬라이더의 시작 및 선택한 값 간의 공간을 채우는 데 사용되는 색상을 지정합니다. 매개변수는 공백으로 구분해야 합니다. 자세한 내용은 스타일 옵션을 참고하세요. 값: <HTML color name> | <hex color code> 예:
|
매개변수 | start end step | 범위 슬라이더의 시작, 끝, 단계 값을 지정합니다. 매개변수는 공백으로 구분해야 합니다. 자세한 내용은 범위 매개변수를 참고하세요. 값: <integer> | <decimal> 예:
|
반복
다음 테이블에는 반복 시작 질문 유형과 함께 사용할 수 있는 XLSForm 매개변수가 포함되어 있습니다. 이러한 매개변수는 현장 앱에서만 지원됩니다.
XLSForm 열 | 매개변수 | 설명 |
---|---|---|
bind::esri:parameters | allowAdds | 새 반복 레코드를 추가할 수 있습니다. 값: true | false 예:
|
allowUpdates | 기존의 반복 레코드를 수정할 수 있습니다. 값: true | false 예:
| |
query | 기존의 반복 레코드를 양식에 표시할 수 있습니다. 사용 가능한 레코드를 필터링하려면 추가 쿼리 매개변수를 지정합니다. 값: <none> | "SQL statement" 예:
| |
body::esri:style | backgroundColor borderColor | 반복의 배경 및 경계 색상을 설정합니다. 자세한 내용은 그룹, 페이지, 반복 색상을 참고하세요. 값: <HTML color name> | <hex color code> 예:
|
텍스트
다음 테이블에는 텍스트 질문 유형과 함께 사용할 수 있는 XLSForm 매개변수가 포함되어 있습니다. 이러한 매개변수는 설명에 달리 명시되지 않은 한 현장 앱에서만 지원됩니다.
XLSForm 열 | 매개변수 | 설명 |
---|---|---|
bind::esri:parameters | geocode | 지오코드 모양이 있는 텍스트 질문의 경우 지오코드 모양을 사용할 때 지오코딩된 결과를 반환하도록 로케이터를 설정합니다. 이 매개변수는 웹 앱에서도 지원됩니다. 값: <locator item ID> 예:
|
측정 | 모양이 거리 측정기인 텍스트 질문의 경우, 질문에 어떤 측정을 저장할지 설정합니다. 값에 공백이 포함된 경우 값의 목록을 따옴표 안에 넣습니다. 값: height | azimuth | horizontalDistance | slopeDistance | inclination | multipleHeights 예:
| |
body::esri:style | defaultHeight | 다중 행 모양의 텍스트 질문의 경우 텍스트 상자의 처음 높이를 설정합니다. 답변 텍스트를 수용할 수 있도록 텍스트 상자의 높이가 증가합니다. 값: <number of lines> 예:
|
indicator | 지오코드 모양의 텍스트 질문의 경우, 지오코딩된 결과가 현재 기기 위치로부터의 방향과 거리를 표시하도록 허용합니다. 값: direction | distance | none 예:
| |
maxResults | 지오코드 모양의 텍스트 질문의 경우 반환할 최대 결과 수를 지정합니다. 기본값은 6입니다. 값: <number of results> 이 매개변수는 웹 앱에서도 지원됩니다. 예:
| |
proximity | 지오코드 모양이 있는 텍스트 질문의 경우 지오코딩된 결과가 기기 위치의 특정 반경 내에서만 결과를 표시할지 여부를 지정합니다. 값: <distance>m | km | ft | mi | yd 예:
| |
suggestions | 지오코드 모양이 있는 텍스트 질문의 경우 제안이 채워지는 방식을 변경합니다. 기본값은 예입니다. 값: yes | no 예:
|
거리 측정기
다음 테이블에는 텍스트, 소수, 정수 질문 유형과 함께 사용하여 거리 측정기의 값을 가져올 수 있는 XLSForm 매개변수가 포함되어 있습니다. 이러한 매개변수는 설명에 달리 명시되지 않은 한 현장 앱에서만 지원됩니다.
XLSForm 열 | 매개변수 | 설명 |
---|---|---|
bind::esri:parameters | 측정 | 모양이 거리 측정기인 텍스트 질문의 경우, 질문에 어떤 측정을 저장할지 설정합니다. 값에 공백이 포함된 경우 값의 목록을 따옴표 안에 넣습니다. 값: height | azimuth | horizontalDistance | slopeDistance | inclination | multipleHeights 예:
|