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. Nie wszystkie parametry są obsługiwane we wszystkich aplikacjach do przesyłania danych (aplikacji Survey123 Mobile, aplikacji terenowej Survey123 i aplikacji internetowej Survey123. Więcej informacji na temat obsługi w aplikacjach zawierają poniższe tabele parametrów, które są pogrupowane według typu pytania i kolumny formularza XLSForm w arkuszu ankiety, która akceptuje dany parametr.
Aby dodać wiele parametrów dla pytania do tej samej kolumny, należy rozdzielić je spacjami. Na przykład pytanie typu range (zakres) może mieć parametry startColor, endColor i color w kolumnie body::esri:style:startColor=Orange endColor=White color=#FF6347
Ogólne
W tej sekcji opisane są parametry, których można użyć w kolumnach formularza XLSForm bind::esri:parameters i body::esri:style w przypadku wielu typów pytań.
W poniższej tabeli opisany jest parametr, którego można użyć w kolumnie formularza XLSForm bind::esri:parameters dla pytań typu text (tekst), integer (liczba całkowita), decimal (wartość dziesiętna), note (uwaga), date (data), time (czas), dateTime (data i czas), select_one (wybierz jedną), select_multiple (select_multiple), geopoint (punkt geograficzny), calculate (obliczenie) oraz hidden (ukryte).
bind::esri:parameters
| Parametr | Opis | Aplikacja do przesyłania danych |
|---|---|---|
| calculationMode | Służy do kontroli, kiedy wykonać obliczenia w pytaniu. Wartości: auto | manual | always | whenEmpty Przykłady: | Aplikacja internetowa Aplikacja terenowa |
W poniższej tabeli opisany jest parametr, którego można użyć w kolumnie formularza XLSForm body::esri:style dla pytań typu text (tekst), integer (liczba całkowita), decimal (wartość dziesiętna), select_one (wybierz jedną) z wyglądem autocomplete (autouzupełnianie), select_multiple (wybierz wiele) z wyglądem autocomplete (autouzupełnianie)* oraz barcode (kod kreskowy).
body::esri:style
| Parametr | Opis | Aplikacja do przesyłania danych |
|---|---|---|
| placeholderText | Należy podać tekst, który będzie wyświetlany w obszarze wejściowym pytania, gdy pytanie jest puste. Wartości: @[hint] | @[guidance_hint] Przykłady: | Survey123 Mobile Aplikacja terenowa |
*Obsługa tylko przez aplikację Survey123 Mobile.
Dźwięk
W poniższej tabeli opisane są parametry, których można użyć w kolumnie formularza XLSForm bind::esri:parameters dla pytania typu audio (dźwięk).
bind::esri:parameters
| Parametr | Opis | Aplikacja do przesyłania danych |
|---|---|---|
| codec | 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: | Survey123 Mobile Aplikacja terenowa |
| fileName | Podaj nazwę pliku. Wartości: <expression> Przykłady: | Aplikacja internetowa |
| 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: | Survey123 Mobile Aplikacja internetowa Aplikacja terenowa |
| max-size | Podaj maksymalną wielkość pliku nagrania audio (w megabajtach). Wielkość domyślna w aplikacji terenowej wynosi 10 MB. Wartość: <megabytes> Przykład: | Survey123 Mobile Aplikacja terenowa |
Kod kreskowy
W poniższej tabeli opisane są parametry, których można użyć w kolumnie formularza XLSForm body::esri:style dla pytania typu barcode (kod kreskowy).
body::esri:style
| Parametr | Opis | Aplikacja do przesyłania danych |
|---|---|---|
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>
Typy jednowymiarowe: codabar | code128 | code39 | code93 | ean13 | ean8 | itf | upca | upce | upceanextension Typy dwuwymiarowe: aztec | datamatrix | maxicode | pdf417 | qrcode | rss14 | rssexpanded Przykłady: | Aplikacja terenowa |
Plik
W poniższej tabeli opisane są parametry, których można użyć w kolumnie formularza XLSForm bind::esri:parameters dla pytania typu file (plik).
bind::esri:parameters
| Parametr | Opis | Aplikacja do przesyłania danych |
|---|---|---|
| fileName | Podaj nazwę pliku. Wartości: <expression> Przykłady: | Aplikacja internetowa |
| max-size | Należy podać maksymalny rozmiar pliku w megabajtach. Wartość domyślna wynosi 10 MB. Wartość: <megabytes> Przykład: | Aplikacja internetowa |
Grupy
W poniższej tabeli opisane są parametry, których można użyć w kolumnie formularza XLSForm body::esri:style dla pytania typu begin group (początek grupy).
body::esri:style
| Parametr | Opis | Aplikacja do przesyłania danych |
|---|---|---|
| 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:
| Survey123 Mobile Aplikacja terenowa |
| Służy do konfigurowania stylu kompozycji siatki grupy. Wartości: dynamic-grid | fixed-grid Przykład: | Aplikacja terenowa |
Obrazy
W tej sekcji opisane są parametry, których można użyć w kolumnach formularza XLSForm dla pytania typu image (obraz).
W poniższej tabeli opisane są parametry, których można użyć w kolumnie formularza XLSForm bind::esri:parameters.
bind::esri:parameters
| Parametr | Opis | Aplikacja do przesyłania danych |
|---|---|---|
| allowAdds | Umożliwia wyłączenie dodawania nowych obrazów podczas edycji istniejących rekordów. Wartość: false Przykład: | Aplikacja terenowa |
| fileName | Podaj nazwę pliku. Wartości: <expression> Przykłady: | Aplikacja internetowa Aplikacja terenowa |
| max-size | Należy podać maksymalny rozmiar pliku w megabajtach. Wartość domyślna wynosi 10 MB. Wartość: <megabytes> Przykład: | Aplikacja internetowa |
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: | Aplikacja terenowa | |
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: | Aplikacja terenowa | |
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: | Aplikacja terenowa | |
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: | Aplikacja terenowa |
W poniższej tabeli opisane są parametry, których można użyć w kolumnie formularza XLSForm body::esri:style dla pytania typu image (obraz).
body::esri:style
| Parametr | Opis | Aplikacja do przesyłania danych |
|---|---|---|
| allowRename | Określ, czy użytkownicy mogą samodzielnie edytować nazwę pliku. Wartości: true | false Przykład: | Aplikacja terenowa |
| fileNameVisible | Zdecyduj, czy nazwa pliku ma być widoczna w ankiecie. Wartości: true | false Przykład: | Aplikacja terenowa |
| 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: | Survey123 Mobile Aplikacja terenowa |
| metoda | 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). Wartości: browse | camera | map Przykłady: | Aplikacja internetowa Aplikacja terenowa |
| 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: | Aplikacja terenowa |
| 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: | Aplikacja terenowa |
W poniższej tabeli opisany jest parametr, którego można użyć w kolumnie formularza XLSForm parameters dla pytania typu image (obraz).
parameters
| Parametr | Opis | Aplikacja do przesyłania danych |
|---|---|---|
| max-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). Wartość: <pixels> Przykłady: | Aplikacja internetowa Aplikacja terenowa |
Pytania typu map (mapa)
W poniższej tabeli opisane są parametry, których można użyć w podanych kolumnach formularza XLSForm dla pytań typu geopoint (punkt geograficzny), geotrace (ślad geograficzny) oraz geoshape (kształt geograficzny).
W poniższej tabeli opisany jest parametr, którego można użyć w kolumnie formularza XLSForm bind::esri:parameters.
bind::esri:parameters
| Parametr | Opis | Aplikacja do przesyłania danych |
|---|---|---|
Ustaw lokalizator, który ma zwracać geokodowane wyniki. Wartość: <locator item ID> Przykład: | Aplikacja internetowa Aplikacja terenowa |
W poniższej tabeli opisane są parametry, których można użyć w kolumnie formularza XLSForm body::esri:style dla pytań typu geopoint (punkt geograficzny), geotrace (ślad geograficzny) oraz geoshape (kształt geograficzny).
body::esri:style
| Parametr | Opis | Aplikacja do przesyłania danych |
|---|---|---|
| height | Służy do skonfigurowania wysokości podglądu mapy. Wartości: <lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels Przykłady: | Aplikacja terenowa |
lineColor2 fillColor3 | Służy do podania koloru linii i wypełnienia obiektu liniowego lub poligonowego. Dotyczy tylko podglądu mapy w Survey123. Więcej informacji zawiera temat Symbolizacja geometrii. Wartości: <HTML color name> | <hex color code> Przykład: | Survey123 Mobile Aplikacja terenowa |
| lineWidth2 | 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: | Survey123 Mobile Aplikacja terenowa |
| map | Służy do skonfigurowania domyślnej mapy bazowej. Wartości: <map name> | <map item ID> Przykłady: | Aplikacja internetowa Aplikacja terenowa |
mapTools | Kontroluj narzędzia map, które są dostępne dla pytań typu geopoint (punkt geograficzny), geotrace (ślad geograficzny) i geoshape (kształt geograficzny). Wartości: search | mapSwitcher | zoom | home | locate Przykłady: | Aplikacja terenowa |
| method2 | Należy podać metodę rejestrowania. Jeśli używana jest metoda Wierzchołek, można skonfigurować dodatkowe parametry. Wartości: sketch | vertex Dodatkowe wartości wierzchołka, mają zastosowanie tylko w aplikacji terenowej: streaming | beep | haptic | edit Przykłady: | Aplikacja internetowa Aplikacja terenowa |
| minCaptureZoomLevel | Podaj minimalny poziom, przy którym można rejestrować geometrię. Wartość: <integer> Przykład: | Aplikacja internetowa |
| 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: | Aplikacja terenowa |
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. Wartość: <integer> Przykład: | Aplikacja internetowa |
| 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. Wartości: feature | self2 Przykład: | Aplikacja internetowa |
| symbol1 | 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: | Aplikacja terenowa |
1 – Obsługiwane tylko przez pytanie typu geopoint (punkt geograficzny).
2 – Obsługiwane tylko przez pytania typu geoshape (kształt geograficzny) i geotrace (ślad geograficzny).
3 – Obsługiwane tylko przez pytanie typu geoshape (kształt geograficzny).
Pytania z wieloma możliwościami odpowiedzi
W poniższej tabeli opisany jest parametr, którego można użyć w kolumnie formularza XLSForm parameters dla pytań typu select_one (wybierz jedną), select_multiple (wybierz wiele) oraz rank (ranga).
parameters
| Parametr | Opis | Aplikacja do przesyłania danych |
|---|---|---|
| randomize | Losowe przedstawienie kolejności wyborów na liście wyboru. Wartości: true Przykład: | Aplikacja internetowa Aplikacja terenowa |
Zakres
W tej sekcji opisane są parametry, których można użyć w kolumnach formularza XLSForm dla pytania typu range (zakres). Łącząc wiele parametrów, należy je rozdzielić spacjami.
W poniższej tabeli opisane są parametry, których można użyć w kolumnie formularza XLSForm body::esri:style. Więcej informacji na ten temat zawiera sekcja Opcje stylu.
body::esri:style
| Parametr | Opis | Aplikacja do przesyłania danych |
|---|---|---|
startColor endColor color | Określ kolory suwaka zakresu:
Wartości: <HTML color name> | <hex color code> Przykłady: | Survey123 Mobile Aplikacja internetowa Aplikacja terenowa |
W poniższej tabeli opisane są parametry, których można użyć w kolumnie formularza XLSForm parameters dla pytania typu range (zakres). Więcej informacji znajduje się w sekcji Parametry suwaka zakresu.
parameters
| Parametr | Opis | Aplikacja do przesyłania danych |
|---|---|---|
start end step | Należy podać wartości początku, końca i etapu suwaka zakresu. Wartości: <integer> | <decimal> Przykłady: | Survey123 Mobile Aplikacja internetowa Aplikacja terenowa |
Powtórzenia
W tej sekcji opisane są parametry, których można użyć w kolumnach formularza XLSForm dla pytania typu begin repeat (rozpocznij powtórzenie).
W poniższej tabeli opisane są parametry, których można użyć w kolumnie formularza XLSForm bind::esri:parameters.
bind::esri:parameters
| Parametr | Opis | Aplikacja do przesyłania danych |
|---|---|---|
| allowAdds | Umożliwia dodanie nowych rekordów powtórzeń. Wartości: true | false Przykład: | Aplikacja terenowa |
| allowUpdates | Umożliwia zmodyfikowanie istniejących rekordów powtórzeń. Wartości: true | false Przykład: | Aplikacja terenowa |
| 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: | Aplikacja terenowa |
W poniższej tabeli opisane są parametry, których można użyć w kolumnie formularza XLSForm body::esri:style dla pytania typu begin repeat (rozpocznij powtórzenie).
body::esri:style
| Parametr | Opis | Aplikacja do przesyłania danych |
|---|---|---|
| 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:
| Survey123 Mobile Aplikacja terenowa |
W przypadku powtórzenia o wyglądzie tabelarycznym określenie trybu dla przycisku Dodaj rekord i opcji Kopiuj do nowego rekordu w widoku tabelarycznym. Wartość domyślna to row. Gdy wartością jest row, nowy rekord jest dołączany do widoku tabelarycznego. Gdy wartością jest form, nowy rekord jest otwierany w widoku formularza. Wartości: row | form Przykład: | Survey123 Mobile | |
W przypadku powtórzenia o wyglądzie tabelarycznym pokazywanie lub ukrywanie opcji Edytuj w widoku formularza w widoku tabelarycznym. Wartość domyślna to true. Notatka:Kiedy powtórzenie zawiera błędy, opcja Edytuj w widoku formularza jest włączona, nawet jeśli parametr editInFormView jest skonfigurowany na wartość false. Wartości: true | false Przykład: | Survey123 Mobile | |
W przypadku powtórzenia o wyglądzie tabelarycznym pokazywanie lub ukrywanie opcji Kopiuj do nowego rekordu w widoku tabelarycznym. Ta opcja umożliwia użytkownikom zduplikowanie rekordu w powtórzeniu. Wartość domyślna to true. Parametr addRecordMode określa sposób dodawania zduplikowanego rekordu. Wartości: true | false Przykład: | Survey123 Mobile | |
W przypadku powtórzenia o wyglądzie tabelarycznym włączanie lub wyłączanie edycji w widoku tabelarycznym. Wartość domyślna to true. Gdy wartością jest false, wszystkie komórki w widoku tabelarycznym są dostępne tylko do odczytu. Wartości: true | false Przykład: | Survey123 Mobile |
W poniższej tabeli opisany jest parametr, którego można użyć w kolumnie formularza XLSForm body::esri:style dla pytań w powtórzeniach tabelarycznych.
body::esri:style
| Parametr | Opis | Aplikacja do przesyłania danych |
|---|---|---|
W przypadku powtórzenia o wyglądzie tabelarycznym pokazywanie pytania jako kolumny w widoku tabelarycznym. Wartość domyślna to false. Wartości: true | false Przykład: | Survey123 Mobile |
Tekst
W tej sekcji opisane są parametry, których można użyć w kolumnach formularza XLSForm dla pytania typu text (tekst).
W poniższej tabeli opisane są parametry, których można użyć w kolumnie formularza XLSForm bind::esri:parameters.
bind::esri:parameters
| Parametr | Opis | Aplikacja do przesyłania danych |
|---|---|---|
| geokodowanie | 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. Wartość: <locator item ID> Przykład: | Aplikacja internetowa Aplikacja terenowa |
W poniższej tabeli opisane są parametry, których można użyć w kolumnie formularza XLSForm body::esri:style dla pytania typu terxt (tekst).
body::esri:style
| Parametr | Opis | Aplikacja do przesyłania danych |
|---|---|---|
| defaultHeight | 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: | Aplikacja terenowa |
| 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: | Aplikacja terenowa |
| 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> Przykład: | Aplikacja internetowa Aplikacja terenowa |
| 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: | Aplikacja terenowa |
| propozycje | 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: | Aplikacja terenowa |
Dalmierz
W poniższej tabeli opisany jest parametr, którego można użyć w kolumnie formularza XLSForm bind::esri:parameters dla pytań typu text (tekst), integer (liczba całkowita) oraz decimal (wartość dziesiętna) w pobrania wartości z dalmierza.
bind::esri:parameters
| Parametr | Opis | Aplikacja do przesyłania danych |
|---|---|---|
pomiar | W przypadku pytania typu text (tekst), decimal (liczba dziesiętna) lub integer (liczba całkowita) 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: | Aplikacja terenowa |