맨 위로 이동

XLSForm 매개변수

본 항목

  1. 일반
  2. 오디오
  3. 바코드
  4. 파일
  5. 그룹
  6. 이미지
  7. 맵 질문
  8. 선다형 질문
  9. 범위
  10. 반복
  11. 텍스트
  12. 거리 측정기

XLSForm의 질문 유형 중 일부에는 현장조사에서 질문의 스타일 또는 동작을 제어할 수 있는 추가 매개변수가 있습니다. 이러한 매개변수는 어떤 경우에는 질문 유형이 지원하는 모양을 보완합니다. 아래 테이블은 XLSForm에 사용할 수 있는 매개변수의 오버뷰 및 각 매개변수를 허용하는 현장조사 워크시트의 열을 제공합니다. 모든 매개변수가 ArcGIS Survey123 현장 앱 및 웹 앱 모두에서 지원되는 것은 아닙니다. 현장 앱 및 웹 앱 지원에 대한 자세한 내용은 각 매개변수에 대한 설명서 항목을 참조하세요.

매개변수를 공백으로 구분하여 동일한 열에 질문에 대한 여러 매개변수를 추가할 수 있습니다. 예를 들어, 지오쉐이프 질문은 다음과 같이 body::esri:style 열에 map, method, lineColor, fillColor 매개변수를 포함할 수 있습니다.

map="Imagery Hybrid" method=vertex lineColor=#DC143C fillColor=LightYellow

일반

다음 테이블에는 다양한 질문 유형과 함께 사용할 수 있는 XLSForm 매개변수가 포함되어 있습니다. 지원하는 질문 유형의 목록은 각 매개변수의 설명을 참조하세요. 이러한 매개변수는 현장 앱에서만 지원됩니다.

XLSForm 열매개변수설명
bind::esri:parameterscalculationMode

질문의 계산이 계산되는 시기를 제어합니다.

질문 유형: text | decimal | integer | note | date | time | dateTime | select_one | select_multiple | geopoint | calculate | hidden

값: auto | manual | always | whenEmpty

예:

calculationMode=manual
calculationMode=always
body::esri:styleplaceholderText

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

질문 유형: text | integer | decimal | select_one(자동 완성 모양 포함) | barcode

값: @[hint] | @[guidance_hint]

예:

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

오디오

다음 테이블에는 오디오 질문 유형과 함께 사용할 수 있는 XLSForm 매개변수가 포함되어 있습니다. 이러한 매개변수는 설명에 달리 명시되지 않은 한 현장 앱에서만 지원됩니다.

XLSForm 열매개변수설명
bind::esri:parameterscodec

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

값: <codec name>

예:

codec=amr-nb,aac
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
max-size

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

값: <megabytes>

예:

max-size=5

바코드

다음 테이블에는 바코드 질문 유형과 함께 사용할 수 있는 XLSForm 매개변수가 포함되어 있습니다. 이러한 매개변수는 현장 앱에서만 지원됩니다.

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

파일

다음 테이블에는 파일 질문 유형과 함께 사용할 수 있는 XLSForm 매개변수가 포함되어 있습니다.

XLSForm 열매개변수설명
bind::esri:parametersfileName

파일 이름을 지정합니다.

값: <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

그룹

다음 테이블에는 그룹 시작 질문 유형과 함께 사용할 수 있는 XLSForm 매개변수가 포함되어 있습니다. 이러한 매개변수는 현장 앱에서만 지원됩니다.

XLSForm 열매개변수설명
body::esri:style

backgroundColor

borderColor

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

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

예:

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

layout

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

값: dynamic-grid | fixed-grid

예:

layout=fixed-grid

이미지

다음 테이블에는 이미지 질문 유형과 함께 사용할 수 있는 XLSForm 매개변수가 포함되어 있습니다. 이러한 매개변수는 설명에 달리 명시되지 않은 한 현장 앱에서만 지원됩니다.

XLSForm 열매개변수설명
bind::esri:parametersallowAdds

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

값: 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:styleallowRename

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

값: true | false

예:

allowRename=false
fileNameVisible

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

값: true | false

예:

fileNameVisible=true
footerText

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

값: <none> | @[hint]

예:

footerText
footerText=@[hint]
method

이미지 질문에 대한 캡처 방법을 지정합니다. 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
parametersmax-pixels

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

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

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

이 매개변수는 웹 앱에서도 지원됩니다.

값: <pixels>

예:

max-pixels=1500
max-pixels=400

맵 질문

다음 테이블에는 지오포인트, 지오추적, 지오쉐이프 질문 유형과 함께 사용할 수 있는 XLSForm 매개변수가 포함되어 있습니다. 이러한 매개변수는 설명에 달리 명시되지 않은 한 현장 앱에서만 지원됩니다.

XLSForm 열매개변수설명
body::esri:styleheight

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

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

예:

previewHeight=6lines
previewHeight=250pixels

lineColor²

fillColor³

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

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

예:

lineColor=Black 
fillColor=#9EFFF5
lineWidth²

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

값: <pixels>

예:

lineWidth=3
map

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

이 매개변수는 웹 앱에서도 지원됩니다.

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

예:

map="World Topography"
map=de26a3cf4cc9451298ea173c4b324736

mapTools

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

이 매개변수는 현장 앱에서만 지원됩니다.

값: search | mapSwitcher | zoom | home | locate

예:

mapTools=zoom
mapTools=search,locate

method²

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

이 매개변수는 웹 앱에서도 지원됩니다.

값: 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 | self²

예:

snapMode=feature
snapMode=self
snapMode=self,feature
symbol¹

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

값: <file name>.png

등록정보: x | y | scale

예:

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

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

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

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

선다형 질문

다음 테이블에는 단답형, 선다형, 순위 질문 유형과 함께 사용할 수 있는 XLSForm 매개변수가 포함되어 있습니다. 이 매개변수는 필드 앱과 웹 앱에서 지원됩니다.

XLSForm 열매개변수설명
parametersrandomize

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

값: true

예:

randomize=true

범위

다음 테이블에는 범위 질문 유형과 함께 사용할 수 있는 XLSForm 매개변수가 포함되어 있습니다. 이러한 매개변수는 현장 앱과 웹 앱에서 지원됩니다.

XLSForm 열매개변수설명

body::esri:style

startColor

endColor

color

범위의 시작과 끝에서 슬라이더의 색상을 지정합니다. color 매개변수를 사용하여 슬라이더의 시작 및 선택한 값 간의 공간을 채우는 데 사용되는 색상을 지정합니다. 매개변수는 공백으로 구분해야 합니다. 자세한 내용은 스타일 옵션을 참고하세요.

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

예:

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

매개변수

start

end

step

범위 슬라이더의 시작, 끝, 단계 값을 지정합니다. 매개변수는 공백으로 구분해야 합니다. 자세한 내용은 범위 매개변수를 참고하세요.

값: <integer> | <decimal>

예:

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

반복

다음 테이블에는 반복 시작 질문 유형과 함께 사용할 수 있는 XLSForm 매개변수가 포함되어 있습니다. 이러한 매개변수는 현장 앱에서만 지원됩니다.

XLSForm 열매개변수설명
bind::esri:parametersallowAdds

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

값: true | false

예:

allowAdds=true
allowUpdates

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

값: true | false

예:

allowUpdates=false
query

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

값: <none> | "SQL statement"

예:

query
query="severity='high'"
body::esri:style

backgroundColor

borderColor

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

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

예:

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

텍스트

다음 테이블에는 텍스트 질문 유형과 함께 사용할 수 있는 XLSForm 매개변수가 포함되어 있습니다. 이러한 매개변수는 설명에 달리 명시되지 않은 한 현장 앱에서만 지원됩니다.

XLSForm 열매개변수설명
bind::esri:parametersgeocode

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

이 매개변수는 웹 앱에서도 지원됩니다.

값: <locator item ID>

예:

geocode=36ff9e8c13e042a58cfce4ad87f55d19

측정

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

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

예:

measurement=height
measurement=height,azimuth,horizontalDistance
measurement="multipleHeights,Height 1,Height 2"
body::esri:styledefaultHeight

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

값: <number of lines>

예:

defaultHeight=5
indicator

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

값: direction | distance | none

예:

indicator=none
indicator=direction
indicator=direction,distance
maxResults

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

값: <number of results>

이 매개변수는 웹 앱에서도 지원됩니다.

예:

maxResults=10
proximity

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

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

예:

proximity=3km
proximity=1000ft
suggestions

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

값: yes | no

예:

suggestions=no

거리 측정기

다음 테이블에는 텍스트, 소수, 정수 질문 유형과 함께 사용하여 거리 측정기의 값을 가져올 수 있는 XLSForm 매개변수가 포함되어 있습니다. 이러한 매개변수는 설명에 달리 명시되지 않은 한 현장 앱에서만 지원됩니다.

XLSForm 열매개변수설명
bind::esri:parameters

측정

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

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

예:

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

이 항목에 대한 피드백을 제공하시겠습니까?

본 항목
  1. 일반
  2. 오디오
  3. 바코드
  4. 파일
  5. 그룹
  6. 이미지
  7. 맵 질문
  8. 선다형 질문
  9. 범위
  10. 반복
  11. 텍스트
  12. 거리 측정기