Wróć do początku

Parametry XLSForm

W tym temacie

  1. Ogólne
  2. Dźwięk
  3. Kod kreskowy
  4. Plik
  5. Grupy
  6. Obrazy
  7. Pytania typu map (mapa)
  8. Pytania z wieloma możliwościami odpowiedzi
  9. Zakres
  10. Powtórzenia
  11. Tekst
  12. Dalmierz

Niektóre typy pytań w formularzu XLSForm zawierają dodatkowe parametry pozwalające sterować stylem lub zachowaniem pytań w ankiecie. W niektórych przypadkach te parametry uzupełniają wyglądy obsługiwane przez typ pytania. W następującej tabeli znajduje się przegląd parametrów, których można użyć w formularzu XLSForm, oraz kolumn w arkuszu ankiety, które przyjmują poszczególne parametry. Nie wszystkie parametry są obsługiwane zarówno w aplikacji terenowej, jak i w aplikacji internetowej ArcGIS Survey123. Więcej o obsłudze w aplikacji terenowej i w aplikacji internetowej zawierają tematy w dokumentacji poszczególnych parametrów.

Aby dodać wiele parametrów dla pytania do tej samej kolumny, należy rozdzielić je spacjami. Na przykład pytanie typu geoshape (kształt geograficzny) może mieć parametry map, method, lineColor i fillColor w kolumnie body::esri:style:

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

Ogólne

Poniższa tabela zawiera parametry formularza XLSForm, których można użyć z różnymi typami pytań. Listę typów pytań obsługujących poszczególne parametry zawiera opis tych parametrów. Te parametry są obsługiwane tylko w aplikacji terenowej.

Kolumna formularza XLSFormParametrOpis
bind::esri:parameterscalculationMode

Służy do kontroli, kiedy wykonać obliczenia w pytaniu.

Typy pytań: text | decimal | integer | note | date | time | dateTime | select_one | select_multiple | geopoint | calculate | hidden

Wartości: auto | manual | always | whenEmpty

Przykłady:

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

Należy podać tekst, który będzie wyświetlany w obszarze wejściowym pytania, gdy pytanie jest puste.

Typy pytań: text | integer | decimal | select_one (z wyglądem autocomplete) | barcode

Wartości: @[hint] | @[guidance_hint]

Przykłady:

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

Dźwięk

Poniższa tabela zawiera parametry formularza XLSForm, których można użyć z typem pytania audio: O ile nie podano inaczej w opisie, te parametry są obsługiwane tylko w aplikacji terenowej.

Kolumna formularza XLSFormParametrOpis
bind::esri:parameterscodec

Podaj preferowany kodek do nagrania audio. Można podać wiele kodeków, rozdzielając je przecinkami. Zostanie użyty pierwszy kodek zgodny z urządzeniem.

Wartość: <codec name>

Przykład:

codec=amr-nb,aac
fileName

Podaj nazwę pliku.

Wartości: <expression>

Ten parametr jest obsługiwany tylko w aplikacji internetowej.

Przykłady:

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

Należy podać maksymalny czas trwania nagrania audio (w sekundach). Domyślny czas trwania w aplikacji internetowej wynosi 600 (10 minut).

Wartość: <seconds>

Przykład:

max-duration=45
max-size

Podaj maksymalną wielkość pliku nagrania audio (w megabajtach). Wielkość domyślna w aplikacji terenowej wynosi 10 MB.

Wartość: <megabytes>

Przykład:

max-size=5

Kod kreskowy

Poniższa tabela zawiera parametry formularza XLSForm, których można użyć z typem pytania barcode (kod kreskowy). Te parametry są obsługiwane tylko w aplikacji terenowej.

Kolumna formularza XLSFormParametrOpis
body::esri:style

barcodeType

Podaj typy kodów kreskowych, które mogą skanować użytkownicy. Można podać wiele typów, rozdzielając je przecinkami. Gdy parametr barcodeType nie jest podany, skanowane mogą być wszystkie obsługiwane typy kodów kreskowych z wyjątkiem aztec, code39, datamatrix, maxicode i pdf417.

Wartości: all | 1d | 2d | <barcode types>

  • all — wszystkie obsługiwane typy z wyjątkiem code39 i pdf417.
  • 1d — wszystkie typy jednowymiarowe z wyjątkiem code39.
  • 2d — wszystkie typy dwuwymiarowe z wyjątkiem pdf417.

Typy jednowymiarowe: codabar | code128 | code39 | code93 | ean13 | ean8 | itf | upca | upce | upceanextension

Typy dwuwymiarowe: aztec | datamatrix | maxicode | pdf417 | qrcode | rss14 | rssexpanded

Przykłady:

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

Plik

Poniższa tabela zawiera parametry formularza XLSForm, których można użyć z typem pytania file.

Kolumna formularza XLSFormParametrOpis
bind::esri:parametersfileName

Podaj nazwę pliku.

Wartości: <expression>

Ten parametr jest obsługiwany tylko w aplikacji internetowej.

Przykłady:

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

Należy podać maksymalny rozmiar pliku w megabajtach. Wartość domyślna wynosi 10 MB.

Wartość: <megabytes>

Ten parametr jest obsługiwany w aplikacji internetowej i aplikacji terenowej.

Przykład:

max-size=5

Grupy

Poniższa tabela zawiera parametry formularza XLSForm, których można użyć z typem pytania begin group. Te parametry są obsługiwane tylko w aplikacji terenowej.

Kolumna formularza XLSFormParametrOpis
body::esri:style

backgroundColor

borderColor

Służy do skonfigurowania koloru tła i ramki grupy lub strony. Więcej na ten temat zawiera sekcja Kolory grup, stron i powtórzeń.

Wartości: <HTML color name> | <hex color code>

Przykłady:

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

layout

Służy do konfigurowania stylu kompozycji siatki grupy.

Wartości: dynamic-grid | fixed-grid

Przykład:

layout=fixed-grid

Obrazy

Poniższa tabela zawiera parametry formularza XLSForm, których można użyć z typem pytania image. O ile nie podano inaczej w opisie, te parametry są obsługiwane tylko w aplikacji terenowej.

Kolumna formularza XLSFormParametrOpis
bind::esri:parametersallowAdds

Umożliwia wyłączenie dodawania nowych obrazów podczas edycji istniejących rekordów.

Wartość: false

Przykład:

allowAdds=false
fileName

Podaj nazwę pliku.

Wartości: <expression>

Ten parametr jest również obsługiwany w aplikacji internetowej.

Przykłady:

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

Należy podać maksymalny rozmiar pliku w megabajtach. Wartość domyślna wynosi 10 MB.

Wartość: <megabytes>

Ten parametr jest również obsługiwany w aplikacji internetowej.

Przykład:

max-size=5

smartAnnotation

W przypadku pytania typu image (obraz) z widokiem annotate (notatka) automatycznie generuje grafikę notatki etykiet i ramki ograniczające wokół wykrytych obiektów. Dołącz te właściwości, aby zdefiniować styl i formatowanie notatki.

Właściwość wymagana: <model_name>

Właściwości opcjonalne: minScore | cameraPreview | label | class | boundingBoxes | outlineWidth | fontSize | font | bold | italic

Przykłady:

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

smartAttributes

Przeprowadź wykrywanie obiektów lub klasyfikację obrazów i użyj wyników EXIF w swojej ankiecie.

Właściwość wymagana: <model_name>

Właściwości opcjonalne: minScore | cameraPreview | label | class

Przykłady:

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

redaction

Automatycznie generuj lub ręcznie dodawaj ramki ograniczające i stosuj efekty redagowania na obszarze docelowym.

Właściwość wymagana: <model_name> | @faces | @manual

Właściwości opcjonalne: minScore | cameraPreview | label | class | effect | symbol | fillColor | scale

Przykłady:

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

Służy do podania pozycji znaku wodnego obrazu. Należy dodać właściwości, aby zdefiniować zawartość i formatowanie. Więcej informacji na ten temat zawiera sekcja Znaki wodne.

Właściwości: text | color | outlineColor | outlineWidth | haloColor | size | font | bold | italic | margin | image | imageSize

Przykłady:

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

Określ, czy użytkownicy mogą samodzielnie edytować nazwę pliku.

Wartości: true | false

Przykład:

allowRename=false
fileNameVisible

Zdecyduj, czy nazwa pliku ma być widoczna w ankiecie.

Wartości: true | false

Przykład:

fileNameVisible=true
footerText

W przypadku pytań typu image (obraz) z wyglądem signature (podpis) należy podać tekst, który będzie wyświetlany na dole okna podręcznego podpisu. Jeśli nie zostanie podana żadna wartość, pod podpisem będzie pojawiać się wskazówka dotycząca pytania. Można ją przekształcić w podpowiedź do pytania za pomocą parametru footerText=@[hint].

Wartości: <none> | @[hint]

Przykłady:

footerText
footerText=@[hint]
method

Należy podać metodę rejestrowania dla pytań typu image (obraz). Wartość map jest obsługiwana tylko dla pytań typu image (obraz) z wyglądem annotate (notatka).

Ten parametr jest również obsługiwany w aplikacji internetowej.

Wartości: browse | camera | map

Przykłady:

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

W przypadku pytań typu image (obraz) z wyglądem draw (rysunek) lub annotate (notatka) należy podać niestandardową paletę narzędzi rysowania.

Wartość: <palette name>

Przykład:

palette=SiteLayout
previewHeight

Służy do skonfigurowania wysokości podglądu obrazu po wybraniu obrazu. Aby uzyskać podgląd obrazu o maksymalnej wielkości bez zbędnego pustego miejsca, należy użyć parametru previewHeight=0.

Wartości: <lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels

Przykłady:

previewHeight=3lines
previewHeight=120pixels
parametersmax-pixels

W przypadku pytania typu image (obraz) służy do skonfigurowania rozmiaru najdłuższego boku obrazu z zachowaniem pierwotnego współczynnika proporcji.

W przypadku pytań typu image (obraz) z wyglądem signature (podpis) służy do skonfigurowania maksymalnej szerokości okna podręcznego podpisu.

W przypadku pytania typu image (obraz) z wyglądem draw (rysunek) należy skonfigurować płótno na kwadratowy obraz (1:1).

Ten parametr jest również obsługiwany w aplikacji internetowej.

Wartość: <pixels>

Przykłady:

max-pixels=1500
max-pixels=400

Pytania typu map (mapa)

Poniższa tabela zawiera parametry formularza XLSForm, których można użyć z typami pytań: geopoint, geotrace oraz geoshape. O ile nie podano inaczej w opisie, te parametry są obsługiwane tylko w aplikacji terenowej.

Kolumna formularza XLSFormParametrOpis
body::esri:styleheight

Służy do skonfigurowania wysokości podglądu mapy.

Wartości: <lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels

Przykłady:

previewHeight=6lines
previewHeight=250pixels

lineColor²

fillColor³

Służy do podania koloru linii i wypełnienia obiektu liniowego lub poligonowego. Dotyczy tylko podglądu mapy w Survey123. Więcej informacji na ten temat zawiera sekcja Opcje stylu.

Wartości: <HTML color name> | <hex color code>

Przykład:

lineColor=Black 
fillColor=#9EFFF5
lineWidth²

Służy do podania szerokości linii w pikselach dla obiektu liniowego lub poligonowego. Dotyczy tylko podglądu mapy w Survey123.

Wartość: <pixels>

Przykłady:

lineWidth=3
map

Służy do skonfigurowania domyślnej mapy bazowej.

Ten parametr jest również obsługiwany w aplikacji internetowej.

Wartości: <map name> | <map item ID>

Przykłady:

map="World Topography"
map=de26a3cf4cc9451298ea173c4b324736

mapTools

Kontroluj narzędzia map, które są dostępne dla pytań typu geopoint (punkt geograficzny), geotrace (ślad geograficzny) i geoshape (kształt geograficzny).

Ten parametr jest obsługiwany tylko w aplikacji terenowej.

Wartości: search | mapSwitcher | zoom | home | locate

Przykłady:

mapTools=zoom
mapTools=search,locate

method²

Należy podać metodę rejestrowania. Jeśli używana jest metoda Wierzchołek, można skonfigurować dodatkowe parametry.

Ten parametr jest również obsługiwany w aplikacji internetowej.

Wartości: sketch | vertex

Dodatkowe wartości wierzchołka, mają zastosowanie tylko w aplikacji terenowej: streaming | beep | haptic | edit

Przykłady:

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

Podaj minimalny poziom, przy którym można rejestrować geometrię.

Ten parametr jest obsługiwany tylko w aplikacji internetowej.

Wartość: <integer>

Przykład:

minCaptureZoomLevel=17

overlay

Służy do wyświetlania lokalizacji punktów z pierwszego pytania typu geopoint (punkt geograficzny) w powtórzeniu w dowolnym innym pytaniu typu geopoint, geoshape (kształt geograficzny) lub geotrace (ślad geograficzny) w ankiecie. Należy dodać właściwości, aby zdefiniować zawartość i styl.

Wartość: <repeat name>

Właściwości: view | preview | icon | iconColor | iconOutlineColor | iconSize | label | labelColor | labelOutlineColor | fontSize

Przykłady:

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

precision

Podaj liczbę miejsc dziesiętnych, które będą zarówno rejestrowane w pytaniach typu map (mapa), jak i wyświetlane na panelu indywidualnej odpowiedzi w ankiecie. Jeśli ten parametr nie zostanie skonfigurowany, w pytaniu typu map (mapa) będą rejestrowane wszystkie dostępne miejsca dziesiętne, ale na panelu indywidualnej odpowiedzi będzie wyświetlane tylko sześć miejsc dziesiętnych.

Ten parametr jest obsługiwany tylko w aplikacji internetowej.

Wartość: <integer>

Przykład:

precision=4

snapMode

Określ sposób działania dociągania. Punkty mogą być dociągane do innych obiektów, a linie i poligony mogą być dociągane do innych obiektów lub do siebie. Dostępne tylko w przypadku ustawienia method=vertex.

Ten parametr jest obsługiwany tylko w aplikacji internetowej.

Wartości: feature | self²

Przykład:

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

Należy podać plik .png, który będzie używany jako znacznik punktu na mapie. Należy dodać właściwości, aby zdefiniować pozycję i skalę.

Wartość: <file name>.png

Właściwości: x | y | scale

Przykład:

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

¹Obsługiwane tylko przez typ pytania geopoint (punkt geograficzny).

²Obsługiwane tylko przez typy pytań geoshape (kształt geograficzny) i geotrace (ślad geograficzny).

³Obsługiwane tylko przez typ pytania geoshape (kształt geograficzny).

Pytania z wieloma możliwościami odpowiedzi

Poniższa tabela zawiera parametry formularza XLSForm, których można użyć z typami pytań select_one, select_multiple oraz rank. Ten parametr jest obsługiwany w aplikacji internetowej i aplikacji terenowej.

Kolumna formularza XLSFormParametrOpis
parametersrandomize

Losowe przedstawienie kolejności wyborów na liście wyboru.

Wartości: true

Przykład:

randomize=true

Zakres

Poniższa tabela zawiera parametry formularza XLSForm, których można użyć z typem pytania range. Te parametry są obsługiwane w aplikacji internetowej i aplikacji terenowej.

Kolumna formularza XLSFormParametrOpis

body::esri:style

startColor

endColor

color

Należy podać kolor suwaka na początku i końcu zakresu. Za pomocą parametru color można podać kolor używany do wypełnienia miejsca między początkiem suwaka a wybraną wartością. Parametry muszą być rozdzielone spacją. Więcej informacji na ten temat zawiera sekcja Opcje stylu.

Wartości: <HTML color name> | <hex color code>

Przykłady:

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

parameters

start

end

step

Należy podać wartości początku, końca i etapu suwaka zakresu. Parametry muszą być rozdzielone spacją. Więcej informacji znajduje się w temacie Parametry zakresu.

Wartości: <integer> | <decimal>

Przykłady:

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

Powtórzenia

Poniższa tabela zawiera parametry formularza XLSForm, których można użyć z typem pytania begin repeat. Te parametry są obsługiwane tylko w aplikacji terenowej.

Kolumna formularza XLSFormParametrOpis
bind::esri:parametersallowAdds

Umożliwia dodanie nowych rekordów powtórzeń.

Wartości: true | false

Przykład:

allowAdds=true
allowUpdates

Umożliwia zmodyfikowanie istniejących rekordów powtórzeń.

Wartości: true | false

Przykład:

allowUpdates=false
query

Umożliwia wyświetlenie w formularzu istniejących rekordów powtórzeń. Należy podać dodatkowe parametry zapytania, aby filtrować dostępne rekordy.

Wartości: <none> | "SQL statement"

Przykłady:

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

backgroundColor

borderColor

Służy do skonfigurowania koloru tła i ramki powtórzenia. Więcej na ten temat zawiera sekcja Kolory grup, stron i powtórzeń.

Wartości: <HTML color name> | <hex color code>

Przykłady:

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

Tekst

Poniższa tabela zawiera parametry formularza XLSForm, których można użyć z typem pytania text. O ile nie podano inaczej w opisie, te parametry są obsługiwane tylko w aplikacji terenowej.

Kolumna formularza XLSFormParametrOpis
bind::esri:parametersgeocode

W przypadku pytań typu text (tekstowe) z wyglądem geocode (geokodowanie) należy skonfigurować lokalizator tak, aby zwrócił geokodowane wyniki, gdy jest używany wygląd geocode.

Ten parametr jest również obsługiwany w aplikacji internetowej.

Wartość: <locator item ID>

Przykład:

geocode=36ff9e8c13e042a58cfce4ad87f55d19

pomiar

W przypadku pytania typu text (tekst) z wyglądem rangefinder (dalmierz) ustaw pomiary, które zostaną zapisane w pytaniu. Jeśli wartości zawierają spacje, ujmij listę wartości w cudzysłów.

Wartości: height | azimuth | horizontalDistance | slopeDistance | inclination | multipleHeights

Przykłady:

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

W przypadku pytań typu text (tekst) z wyglądem multiline (wielowierszowy) ustaw początkową wysokość pola tekstowego. Wysokość pola tekstowego będzie zwiększana, aby dostosować się do tekstu odpowiedzi.

Wartość: <number of lines>

Przykład:

defaultHeight=5
indicator

W przypadku pytań typu text (tekstowe) z wyglądem geocode (geokodowanie) umożliwia wyświetlanie w geokodowanych wynikach kierunku i odległości od bieżącej lokalizacji urządzenia.

Wartości: direction | distance | none

Przykłady:

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

W przypadku pytań typu text (tekstowe) z wyglądem geocode (geokodowanie) należy podać maksymalną liczbę zwracanych wyników. Domyślna wartość to 6.

Wartość: <number of results>

Ten parametr jest również obsługiwany w aplikacji internetowej.

Przykład:

maxResults=10
proximity

W przypadku pytań typu text (tekstowe) z wyglądem geocode (geokodowanie) należy podać, czy wyniki geokodowane będą pokazywać tylko wyniki w określonym promieniu od lokalizacji urządzenia.

Wartości: <distance>m | km | ft | mi | yd

Przykłady:

proximity=3km
proximity=1000ft
suggestions

W przypadku pytania typu text (tekst) z wyglądem geocode (geokodowanie) można zmienić sposób wypełniania sugestii. Wartość domyślna to tak.

Wartości: yes | no

Przykład:

suggestions=no

Dalmierz

Poniższa tabela zawiera parametr XLSForm, którego można użyć z pytaniami typu text (tekst), decimal (liczba dziesiętna) i integer (liczba całkowita) w celu pobrania wartości z dalmierza. O ile nie podano inaczej w opisie, te parametry są obsługiwane tylko w aplikacji terenowej.

Kolumna formularza XLSFormParametrOpis
bind::esri:parameters

pomiar

W przypadku pytania typu text (tekst) z wyglądem rangefinder (dalmierz) ustaw pomiary, które zostaną zapisane w pytaniu. Jeśli wartości zawierają spacje, ujmij listę wartości w cudzysłów.

Wartości: height | azimuth | horizontalDistance | slopeDistance | inclination | multipleHeights

Przykłady:

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

Opinia na ten temat?

W tym temacie
  1. Ogólne
  2. Dźwięk
  3. Kod kreskowy
  4. Plik
  5. Grupy
  6. Obrazy
  7. Pytania typu map (mapa)
  8. Pytania z wieloma możliwościami odpowiedzi
  9. Zakres
  10. Powtórzenia
  11. Tekst
  12. Dalmierz