매개변수

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

예:

calculationMode=manual
calculationMode=always

웹 앱

현장 앱

다음 테이블에서는 텍스트, 정수, 소수, 단답형(자동 완성 모양 사용), 선다형(자동 완성 모양 사용), 바코드 질문 유형의 body::esri:style XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.

body::esri:style

매개변수설명제출 앱
placeholderText

질문이 비어 있는 경우 질문의 입력 영역에 나타나는 텍스트를 지정합니다.

값: @[hint] | @[guidance_hint]

예:

placeholderText=@[hint]
placeholderText=@[guidance_hint]

Survey123 Mobile

현장 앱

*Survey123 Mobile에서만 지원됩니다.

오디오

다음 테이블에서는 오디오 질문 유형의 bind::esri:parameters XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.

bind::esri:parameters

매개변수설명제출 앱
코덱

오디오 녹음의 기본 코덱을 지정합니다. 여러 코덱을 쉼표로 구분하여 제공할 수 있습니다. 기기와 호환되는 첫 번째 코덱이 사용됩니다.

값: <codec name>

예:

codec=amr-nb,aac

Survey123 Mobile

현장 앱

fileName

파일 이름을 지정합니다.

값: <expression>

예:

fileName=concat("JobID-", ${job_id})
fileName=concat(${asset_id}, "_", 
  format-date(now(), "%Y%m%d%H%M%S"))

웹 앱

max-duration

오디오 녹음의 최대 지속 시간(초)을 지정합니다. 웹 앱의 기본 지속 시간은 600(10분)입니다.

값: <seconds>

예:

max-duration=45

Survey123 Mobile

웹 앱

현장 앱

max-size

오디오 녹음의 최대 파일 크기(메가바이트)를 지정합니다. 현장 앱의 기본 크기는 10MB입니다.

값: <megabytes>

예:

max-size=5

Survey123 Mobile

현장 앱

바코드

다음 테이블에서는 바코드 질문 유형의 body::esri:style XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.

body::esri:style

매개변수설명제출 앱

barcodeType

사용자가 스캔할 수 있는 바코드의 유형을 지정합니다. 여러 유형을 쉼표로 구분하여 제공할 수 있습니다. barcodeType 매개변수가 제공되지 않으면 지원되는 모든 바코드 유형은 aztec, code39, datamatrix, maxicode, pdf417을 제외하고 스캔할 수 있습니다.

값: all | 1d | 2d | <barcode types>

  • all — code39 및 pdf417을 제외하고 지원되는 모든 유형입니다.
  • 1d — code39를 제외한 모든 1차원 유형입니다.
  • 2d — pdf417을 제외한 모든 2차원 유형입니다.

1차원 유형: codabar | code128 | code39 | code93 | ean13 | ean8 | itf | upca | upce | upceanextension

2차원 유형: aztec | datamatrix | maxicode | pdf417 | qrcode | rss14 | rssexpanded

예:

barcodeType=qrcode,aztec,code128
barcodeType=ean8,itf
barcodeType=2d
barcodeType=pdf417

현장 앱

파일

다음 테이블에서는 파일 질문 유형의 bind::esri:parameters XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.

bind::esri:parameters

매개변수설명제출 앱
fileName

파일 이름을 지정합니다.

값: <expression>

예:

fileName=concat("JobID-", ${job_id})
fileName=concat(${asset_id}, "_", 
  format-date(now(), "%Y%m%d%H%M%S"))

웹 앱

max-size

최대 파일 크기(MB)를 지정합니다. 기본값은 10MB입니다.

값: <megabytes>

예:

max-size=5

웹 앱

그룹

다음 테이블에서는 그룹 시작 질문 유형의 body::esri:style XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.

body::esri:style

매개변수설명제출 앱

backgroundColor

borderColor

그룹 또는 페이지의 배경 및 경계 색상을 설정합니다. 자세한 내용은 그룹, 페이지, 반복 색상을 참고하세요.

값: <HTML color name> | <hex color code>

예:

backgroundColor=LightBlue
borderColor=#4682B4
backgroundColor=#C7FFC7 borderColor=#3C6D9E

Survey123 Mobile

현장 앱

레이아웃

그룹의 그리드 레이아웃 스타일을 설정합니다.

값: dynamic-grid | fixed-grid

예:

layout=fixed-grid

현장 앱

이미지

이 섹션에서는 이미지 질문 유형의 지정된 XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.

다음 테이블에서는 bind::esri:parameters XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.

bind::esri:parameters

매개변수설명제출 앱
allowAdds

기존 레코드를 편집할 때 새 이미지 추가를 비활성화합니다.

값: false

예:

allowAdds=false

현장 앱

fileName

파일 이름을 지정합니다.

값: <expression>

예:

fileName=concat("JobID-", ${job_id})
fileName=concat(${asset_id}, "_", 
  format-date(now(), "%Y%m%d%H%M%S"))

웹 앱

현장 앱

max-size

최대 파일 크기(MB)를 지정합니다. 기본값은 10MB입니다.

값: <megabytes>

예:

max-size=5

웹 앱

smartAnnotation

애노테이트 모양이 있는 이미지 질문의 경우, 감지된 객체 주위에 경계 상자 및 레이블의 애노테이션 그래픽을 자동으로 생성합니다. 애노테이션의 스타일 및 서식을 정의하려면 이러한 등록정보를 추가합니다.

필수 등록정보: <model_name>

선택 등록정보: minScore | cameraPreview | label | class | boundingBoxes | outlineWidth | fontSize | font | bold | italic

예:

smartAnnotation=modelname
  &cameraPreview=true&minScore=0.52
smartAnnotation=modelname&
  cameraPreview=true&minScore=0.52
  &class=classname1,classname2
  &label=false&bold=true

현장 앱

smartAttributes

객체 감지 또는 이미지 분류를 수행하고 현장조사에서 EXIF 결과를 사용합니다.

필수 등록정보: <model_name>

선택 등록정보: minScore | cameraPreview | label | class

예:

smartAttributes=modelname
  &cameraPreview=true&minScore=0.45
smartAttributes=modelname
  &cameraPreview=true
  &class=classname1,classname2
  &label=false

현장 앱

redaction

경계 상자를 자동으로 생성하거나 수동으로 추가하고 대상 영역에 수정 효과를 적용합니다.

필수 등록정보: <model_name> | @faces | @manual

선택 등록정보: minScore | cameraPreview | label | class | effect | symbol | fillColor | scale

예:

redaction=modelname
  &cameraPreview=true&effect=blur
redaction=@manual&effect=blockout
redaction=@faces&cameraPreview=true
  &class=classname1,classname2
  &label=false@effect=symbol&symbol=🐻

현장 앱

watermark

topLeftWatermark

topCenterWatermark

topRightWatermark

leftCenterWatermark

centerWatermark

rightCenterWatermark

bottomLeftWatermark

bottomCenterWatermark

bottomRightWatermark

이미지 워터마크의 위치를 ​​지정합니다. 내용 및 서식을 정의하기 위해 등록정보를 추가합니다. 자세한 내용은 워터마크를 참고하세요.

등록정보: text | color | outlineColor | outlineWidth | haloColor | size | font | bold | italic | margin | image | imageSize

예:

watermark="Example Text
  &outlineColor=White"
bottomLeftWatermark="Example Text
  &bold=true"
topRightWatermark="@[latitude longitude]
  &size=20"

현장 앱

다음 테이블에서는 이미지 질문 유형의 body::esri:style XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.

body::esri:style

매개변수설명제출 앱
allowRename

사용자가 파일 이름을 수동으로 편집할 수 있는지 여부를 지정합니다.

값: true | false

예:

allowRename=false

현장 앱

fileNameVisible

파일 이름이 현장조사에 표시되는지 여부를 지정합니다.

값: true | false

예:

fileNameVisible=true

현장 앱

footerText

서명 모양이 있는 이미지 질문의 경우 서명 팝업 하단에 표시할 텍스트를 지정합니다. 값을 지정하지 않으면 서명 아래에 질문의 안내 힌트가 나타납니다. 이는 footerText=@[hint]을(를) 사용하여 질문의 힌트로 변경할 수 있습니다.

값: <none> | @[hint]

예:

footerText
footerText=@[hint]

Survey123 Mobile

현장 앱

방법

이미지 질문에 대한 캡처 방법을 지정합니다. map 값은 애노테이트 모양이 있는 이미지 질문에만 지원됩니다.

값: browse | camera | map

예:

method=camera
method=map
method=browse,camera,map

웹 앱

현장 앱

palette

그리기 또는 애노테이트 모양이 있는 이미지 질문의 경우 사용자 설정 그리기 도구 팔레트를 지정합니다.

값: <palette name>

예:

palette=SiteLayout

현장 앱

previewHeight

이미지를 선택한 후 이미지 미리 보기의 높이를 설정합니다. 이미지 미리 보기에서 불필요한 공백을 제거해 최대 크기로 설정하려면 previewHeight=0을 사용합니다.

값: <lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels

예:

previewHeight=3lines
previewHeight=120pixels

현장 앱

다음 테이블에서는 이미지 질문 유형의 parameters XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.

parameters

매개변수설명제출 앱
max-pixels

이미지 질문의 경우 기존 종횡비를 유지하면서 가장 긴 가장자리에서 이미지의 최대 크기를 설정합니다.

서명 모양이 있는 이미지 질문의 경우 서명 팝업의 최대 너비를 설정합니다.

그리기 모양이 있는 이미지 질문의 경우 캔버스를 사각형(1:1) 이미지로 설정합니다.

값: <pixels>

예:

max-pixels=1500
max-pixels=400

웹 앱

현장 앱

맵 질문

다음 테이블에서는 지오포인트, 지오추적, 지오쉐이프 질문 유형의 지정된 XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.

다음 테이블에서는 bind::esri:parameters XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.

bind::esri:parameters

매개변수설명제출 앱

지오코드

지오코딩된 결과를 반환하도록 로케이터를 설정합니다.

값: <locator item ID>

예:

geocode=36ff9e8c13e042a58cfce4ad87f55d19

웹 앱

현장 앱

다음 테이블에서는 지오포인트, 지오추적, 지오쉐이프 질문 유형의 body::esri:style XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.

body::esri:style

매개변수설명제출 앱
height

맵 미리보기의 높이를 설정합니다.

값: <lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels

예:

previewHeight=6lines
previewHeight=250pixels

현장 앱

lineColor2

fillColor3

라인 또는 폴리곤 피처의 라인 및 채우기 색상을 지정합니다. 이는 Survey123의 맵 미리 보기에만 적용됩니다. 자세한 내용은 지오메트리 심볼을 참고하세요.

값: <HTML color name> | <hex color code>

예:

lineColor=Black 
fillColor=#9EFFF5

Survey123 Mobile

현장 앱

lineWidth2

라인 또는 폴리곤 피처의 라인 너비를 픽셀 단위로 지정합니다. 이는 Survey123의 맵 미리 보기에만 적용됩니다.

값: <pixels>

예:

lineWidth=3

Survey123 Mobile

현장 앱

map

기본 베이스맵을 설정합니다.

값: <map name> | <map item ID>

예:

map="World Topography"
map=de26a3cf4cc9451298ea173c4b324736

웹 앱

현장 앱

mapTools

지오포인트, 지오추적, 지오쉐이프 질문에 사용할 수 있는 맵 도구를 제어합니다.

값: search | mapSwitcher | zoom | home | locate

예:

mapTools=zoom
mapTools=search,locate

현장 앱

method2

취득 방법을 지정합니다. 버텍스 방법을 사용하는 경우 추가 매개변수를 설정할 수 있습니다.

값: sketch | vertex

현장 앱 streaming | beep | haptic | edit 에만 해당되는 버텍스에 대한 추가 값

예:

method=vertex
method=vertex,streaming
method=vertex,streaming,haptic

웹 앱

현장 앱

minCaptureZoomLevel

지오메트리를 취득할 수 있는 최소 수준을 지정합니다.

값: <integer>

예:

minCaptureZoomLevel=17

웹 앱

overlay

해당 현장조사에서 다른 모든 지오포인트, 지오쉐이프 또는 지오추적 질문에 대한 반복 내 첫 번째 지오포인트 질문의 포인트 위치를 표시합니다. 내용 및 스타일을 정의하기 위해 등록정보를 추가합니다.

값: <repeat name>

등록정보: view | preview | icon | iconColor | iconOutlineColor | iconSize | label | labelColor | labelOutlineColor | fontSize

예:

overlay=campsites&preview=true
overlay=hydrants&label=asset_id&icon=hydrant&iconColor=Red

현장 앱

precision

맵 질문에 취득하고 현장조사의 개별 응답 패널에 표시할 소수 자릿수를 지정합니다. 해당 매개변수가 설정되지 않은 경우 사용 가능한 모든 소수 자릿수가 맵 질문에 취득되지만 개별 응답 패널에는 6자리의 소수 자릿수만 표시됩니다.

값: <integer>

예:

precision=4

웹 앱

snapMode

스내핑 동작을 지정합니다. 포인트는 다른 피처에 스내핑할 수 있고 라인 및 폴리곤은 다른 피처 또는 그 자체에 스내핑할 수 있습니다. method=vertex인 경우에만 사용할 수 있습니다.

값: feature | self2

예:

snapMode=feature
snapMode=self
snapMode=self,feature

웹 앱

symbol1

맵에서 포인트 마커로 사용할 .png 파일을 지정합니다. 위치 및 크기를 정의하기 위해 등록정보를 추가합니다.

값: <file name>.png

등록정보: x | y | scale

예:

symbol=meter.png?x=0.6&y=0.1&scale=1.5

현장 앱

1 — 지오포인트 질문 유형에서만 지원됩니다.

2 — 지오쉐이프 및 지오추적 질문 유형에서만 지원됩니다.

3 — 지오쉐이프 질문 유형에서만 지원됩니다.

선다형 질문

다음 테이블에서는 단답형, 선다형, 순위 질문 유형의 parameters XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.

parameters

매개변수설명제출 앱
랜덤화

선택 목록의 선택 항목 순서를 랜덤화합니다.

값: true

예:

randomize=true

웹 앱

현장 앱

범위

이 섹션에서는 범위 질문 유형의 지정된 XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다. 매개변수를 함께 사용하는 경우, 공백으로 구분해야 합니다.

다음 테이블에서는 body::esri:style XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다. 자세한 내용은 스타일 옵션을 참고하세요.

body::esri:style

매개변수설명제출 앱

startColor

endColor

color

범위 슬라이더의 색상을 지정합니다.

  • 범위 시작 부분의 슬라이더 색상입니다.
  • 범위 끝 부분의 슬라이더 색상입니다.
  • 슬라이더의 시작 부분과 선택한 값 사이의 공간을 채우는 색상입니다.

값: <HTML color name> | <hex color code>

예:

startColor=Blue endColor=Red
startColor=Orange endColor=White color=#FF6347
endColor=#262626 color=Yellow

Survey123 Mobile

웹 앱

현장 앱

다음 테이블에서는 범위 질문 유형의 parameters XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다. 자세한 내용은 범위 슬라이더 매개변수를 참고하세요.

parameters

매개변수설명제출 앱

start

end

step

범위 슬라이더의 시작, 끝, 단계 값을 지정합니다.

값: <integer> | <decimal>

예:

start=0 end=50 step=5
start=10.25 end=1 step=0.25

Survey123 Mobile

웹 앱

현장 앱

반복

이 섹션에서는 반복 시작 질문 유형의 지정된 XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.

다음 테이블에서는 bind::esri:parameters XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.

bind::esri:parameters

매개변수설명제출 앱
allowAdds

새 반복 레코드를 추가할 수 있습니다.

값: true | false

예:

allowAdds=true

현장 앱

allowUpdates

기존의 반복 레코드를 수정할 수 있습니다.

값: true | false

예:

allowUpdates=false

현장 앱

query

기존의 반복 레코드를 양식에 표시할 수 있습니다. 사용 가능한 레코드를 필터링하려면 추가 쿼리 매개변수를 지정합니다.

값: <none> | "SQL statement"

예:

query
query="severity='high'"

현장 앱

다음 테이블에서는 반복 시작 질문 유형의 body::esri:style XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.

body::esri:style

매개변수설명제출 앱

backgroundColor

borderColor

반복의 배경 및 경계 색상을 설정합니다. 자세한 내용은 그룹, 페이지, 반복 색상을 참고하세요.

값: <HTML color name> | <hex color code>

예:

backgroundColor=LightBlue
borderColor=#4682B4
backgroundColor=#C7FFC7 borderColor=#3C6D9E

Survey123 Mobile

현장 앱

addRecordMode

테이블 형식 모양이 적용된 반복의 경우 테이블 형식 뷰에서 레코드 추가 버튼 및 새 레코드로 복사 옵션의 모드를 지정합니다. 기본값은 row입니다. 값이 row이면 새 레코드가 테이블 형식 뷰에 추가됩니다. 값이 form이면 새 레코드가 양식 뷰에서 열립니다.

값: row | form

예:

addRecordMode=form

Survey123 Mobile

editInFormView

테이블 형식 모양이 적용된 반복의 경우 테이블 형식 뷰에서 양식 뷰에서 편집 옵션을 표시하거나 숨깁니다. 기본값은 true입니다.

비고:

반복에 오류가 있는 경우, editInFormView 매개변수가 false로 설정되어 있는 경우에도 양식 뷰에서 편집 옵션이 활성화됩니다.

값: true | false

예:

editInFormView=false

Survey123 Mobile

copyToNewRecord

테이블 형식 모양이 적용된 반복의 경우 테이블 형식 뷰에서 새 레코드로 복사 옵션을 표시하거나 숨깁니다. 이 옵션을 사용하면 사용자가 반복에 포함된 레코드를 복제할 수 있습니다. 기본값은 true입니다. addRecordMode 매개변수는 복제된 레코드가 추가되는 방식을 결정합니다.

값: true | false

예:

copyToNewRecord=true

Survey123 Mobile

editInTabularView

테이블 형식 모양이 적용된 반복의 경우 테이블 형식 뷰에서 편집을 활성화하거나 비활성화합니다. 기본값은 true입니다. 값이 false이면 테이블 형식 뷰의 모든 셀이 읽기 전용이 됩니다.

값: true | false

예:

editInTabularView=false

Survey123 Mobile

다음 테이블에서는 테이블 형식 반복에 포함된 질문의 body::esri:style XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.

body::esri:style

매개변수설명제출 앱

showInTabularView

테이블 형식 모양이 적용된 반복의 경우 테이블 형식 뷰에서 질문을 열로 표시합니다. 기본값은 false입니다.

값: true | false

예:

showInTabularView=true

Survey123 Mobile

텍스트

이 섹션에서는 텍스트 질문 유형의 지정된 XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.

다음 테이블에서는 bind::esri:parameters XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.

bind::esri:parameters

매개변수설명제출 앱
지오코드

지오코드 모양이 있는 텍스트 질문의 경우 지오코드 모양을 사용할 때 지오코딩된 결과를 반환하도록 로케이터를 설정합니다.

값: <locator item ID>

예:

geocode=36ff9e8c13e042a58cfce4ad87f55d19

웹 앱

현장 앱

다음 테이블에서는 텍스트 질문 유형의 body::esri:style XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.

body::esri:style

매개변수설명제출 앱
defaultHeight

다중 행 모양의 텍스트 질문의 경우 텍스트 상자의 처음 높이를 설정합니다. 답변 텍스트를 수용할 수 있도록 텍스트 상자의 높이가 증가합니다.

값: <number of lines>

예:

defaultHeight=5

현장 앱

indicator

지오코드 모양의 텍스트 질문의 경우, 지오코딩된 결과가 현재 기기 위치로부터의 방향과 거리를 표시하도록 허용합니다.

값: direction | distance | none

예:

indicator=none
indicator=direction
indicator=direction,distance

현장 앱

maxResults

지오코드 모양의 텍스트 질문의 경우 반환할 최대 결과 수를 지정합니다. 기본값은 6입니다.

값: <number of results>

예:

maxResults=10

웹 앱

현장 앱

인접도

지오코드 모양이 있는 텍스트 질문의 경우 지오코딩된 결과가 기기 위치의 특정 반경 내에서만 결과를 표시할지 여부를 지정합니다.

값: <distance>m | km | ft | mi | yd

예:

proximity=3km
proximity=1000ft

현장 앱

제안

지오코드 모양이 있는 텍스트 질문의 경우 제안이 채워지는 방식을 변경합니다. 기본값은 예입니다.

값: yes | no

예:

suggestions=no

현장 앱

거리 측정기

다음 테이블에서는 거리 측정기에서 값을 가져오기 위해 텍스트, 정수, 소수 질문 유형의 bind::esri:parameters XLSForm 열에서 사용할 수 있는 매개변수를 설명합니다.

bind::esri:parameters

매개변수설명제출 앱

측정

모양이 거리 측정기인 텍스트, 소수, 정수 질문의 경우, 질문에 어떤 측정을 저장할지 설정합니다. 값에 공백이 포함된 경우 값의 목록을 따옴표 안에 넣습니다.

값: height | azimuth | horizontalDistance | slopeDistance | inclination | multipleHeights

예:

measurement=height
measurement=height,azimuth,horizontalDistance
measurement="multipleHeights,Height 1,Height 2"

현장 앱