Aplikacja ArcGIS Survey123 obsługuje wiele specyfikacji XLSForm. Niniejszy przewodnik zawiera podsumowanie obiektów XLSForm, których można używać w aplikacji Survey123. Ankiety można tworzyć w aplikacji Survey123 Connect lub witrynie Survey123 — niektóre obiekty są dostępne tylko w aplikacji lub tylko w witrynie, a inne są dostępne zarówno w aplikacji, jak i w witrynie.
Typy pytań
Poniższa tabela zawiera opis typów pytań, które są dostępne w aplikacji Survey123 Connect, aplikacji terenowej Survey123, w kreatorze internetowym Survey123 i aplikacji internetowej Survey123. W przypadku niektórych pytań występują różnice w zachowaniu i implementacji na różnych platformach. Różnice są podane w uwagach po tabeli.
| Typ pytania Survey123 Connect | Typ pytania w kreatorze internetowym Survey123 | Opis | Obsługiwane w aplikacji terenowej Survey123 | Obsługiwane w aplikacji internetowej Survey123 |
|---|---|---|---|---|
| audio⁴ | Dźwięk⁴ ⁶ | Nagrywa klip dźwiękowy w aplikacji terenowej. Nagrywa klip dźwiękowy lub akceptuje przesłany plik dźwiękowy w aplikacji internetowej. | Tak | Tak |
| barcode | Skanuje kod kreskowy lub kod QR. | Tak | Tak | |
| begin group | Rozpoczyna grupę pytań. | Tak | Tak | |
| begin repeat | Brak | Rozpoczyna zestaw pytań powtarzalnych. | Tak | Tak |
| oblicz | Brak | Wykonuje obliczenia na wartościach w formularzu. Pole calculate (oblicz) zawiera wynik obliczeń. | Tak | Tak |
| decimal¹ | Dane wejściowe w postaci dziesiętnej. | Tak | Tak | |
| data | Dane wejściowe w postaci daty. | Tak | Tak | |
| dateTime | Dane wejściowe w postaci daty i czasu. | Tak | Tak | |
| deviceid | Brak | Identyfikator UUID reprezentujący konkretne urządzenie, na którym wypełniono ankietę. | Tak | Nie |
| email² | Brak | Po zalogowaniu się na koncie instytucji to pytanie zostanie automatycznie wypełnione adresem e-mail konta. | Tak | Tak |
| end | Brak | Data i czas ukończenia ankiety. | Tak | Tak |
| end group | Kończy grupę pytań. | Tak | Tak | |
| end repeat | Brak | Kończy zestaw pytań powtarzalnych. | Tak | Tak |
| plik | Akceptuje plik na urządzeniu. | Tak | Tak | |
| geopoint³ | Zbiera określone współrzędne GPS. Wartością domyślną jest lokalizacja bieżąca. | Tak | Tak | |
| geoshape³ | Rejestruje poligon na mapie. | Tak | Tak | |
| geotrace³ | Rejestruje linię na mapie. | Tak | Tak | |
| ukryte | Brak | W warstwie obiektowej tworzy pole, które nie jest wyświetlane na formularzu. Użyj kolumn bind::esri:fieldType i bind::esri:fieldLength, aby określić schemat danych dla tego pola. | Tak | Tak |
| integer¹ | Dane wejściowe w postaci liczby całkowitej. | Tak | Tak | |
| obraz | Akceptuje obraz z plików na urządzeniu lub bezpośrednio zrobione zdjęcie. | Tak | Tak | |
| notatka | Wyświetla tekst na ekranie. Notatka może także zawierać ukryte obliczenia. | Tak | Tak | |
| zakres | Suwak⁶ | Dane wejściowe w podanym zakresie liczbowym. | Tak | Tak |
| rank list_name | Pytanie typu ranking; porządkuje listę możliwości wyboru. Zastąp list_name nazwą listy wyboru. | Tak | Tak | |
| select_one list_name | Menu rozwijane⁵ ⁶, Skala Likerta⁵ ⁶, Ocena⁶, Wybór pojedynczy⁶, Siatka typu Wybór pojedynczy⁶ | Pytanie z wieloma możliwościami odpowiedzi, można wybrać tylko jedną odpowiedź. Zastąp list_name nazwą listy wyboru. | Tak | Tak |
| select_one_from_file file_name.csv | Brak | Pytanie z wieloma możliwościami odpowiedzi, można wybrać tylko jedną odpowiedź. Zastąp file_name.csv nazwą pliku znajdującego się w folderze multimediów ankiety, który zawiera listę możliwości wyboru. | Tak | Tak |
| select_multiple list_name | Pytanie z wieloma możliwościami odpowiedzi, można wybrać wiele odpowiedzi. Zastąp list_name nazwą listy wyboru. | Tak | Tak | |
| select_multiple_from_file file_name.csv | Brak | Pytanie z wieloma możliwościami odpowiedzi, można wybrać wiele odpowiedzi. Zastąp file_name.csv nazwą pliku znajdującego się w folderze multimediów ankiety, który zawiera listę możliwości wyboru. | Tak | Tak |
| start | Brak | Data i czas rozpoczęcia ankiety. | Tak | Tak |
| tekst | Adres⁶, Adres e-mail⁶, Tekst wielowierszowy⁵ ⁶, Tekst jednowierszowy⁶, Witryna⁶ | Odpowiedź tekstowa. Do adresu e-mail i witryny jest stosowane wyrażenie regularne. Do adresu stosowany jest wygląd geocode (geokodowanie). | Tak | Tak |
| time | Dane wejściowe w postaci czasu. | Tak | Tak | |
| username | Brak | Po zalogowaniu się na koncie instytucji to pytanie zostanie automatycznie wypełnione nazwą użytkownika konta. | Tak | Tak |
¹Kreator internetowy łączy pytania typu integer (liczba całkowita) i decimal (wartość dziesiętna) w jeden typ pytania o nazwie Number (liczba). Pole wyboru we właściwościach pytania umożliwia projektantowi ankiety zdefiniowanie, jakie dane wejściowe są wymagane.
²Typy pytań email (adres e-mail) udostępnione w aplikacji Survey123 Connect i w kreatorze internetowym Survey123 są różnie zaimplementowane. Implementacja w aplikacji Survey123 Connect jest zapełniana automatycznie adresem e-mail konta instytucji, do którego jest zalogowany użytkownik. Implementacja w kreatorze internetowym Survey123 jest natomiast polem tekstowym, które przyjmuje tylko formatowanie dopasowane do adresu e-mail.
³Pytania typu geopoint (punkt geograficzny), geotrace (ślad geograficzny) i geoshape (kształt geograficzny) zostały połączone w jeden typ pytania o nazwie map (mapa). Pole wyboru we właściwościach pytania umożliwia projektantowi ankiety zdefiniowanie, jakie dane wejściowe są wymagane. Dodatkowy typ pytania o nazwie address (adres) pozwala na przesyłanie punktów geokodowanych.
⁴Pytania typu audio nie pozwalają na przesyłanie w aplikacji terenowej Survey123 tak jak w aplikacji internetowej. Aby pozwolić na przesyłanie dźwięku w aplikacji terenowej, użyj pytania typu file (plik).
⁵Kilka wyglądów dostępnych w aplikacji Survey123 Connect jest natomiast dostępnych jako oddzielne typy pytań w kreatorze internetowym Survey123. Dotyczy to typów: Tekst wielowierszowy, Menu rozwijane poziome i Skala Likerta.
⁶Dla każdego pytania kreator internetowy udostępnia możliwość zapisania odpowiedzi w pamięci podręcznej. W aplikacji internetowej po przesłaniu rekordu ankiety odpowiedź na pytanie zostanie zapisana w pamięci podręcznej przeglądarki i wstępnie wczytana do następnego przesłania w ramach tej ankiety na danym urządzeniu. Zapisywanie odpowiedzi w pamięci podręcznej może być skonfigurowane dla wszystkich typów pytań z wyjątkiem typów Dźwięk, Obraz, Przesłanie pliku i Podpis.
Wartości domyślne
Większość typów pytań umożliwia zdefiniowanie domyślnej odpowiedzi, która będzie użyta automatycznie podczas wczytywania ankiety. Służy to do tego samego celu co kolumna default (wartość domyślna) w specyfikacji XLSForm.
Weryfikacja danych
(wymagane) Zaznaczenie opcji To jest pytanie wymagane na panelu konfiguracji i powoduje, że pytanie musi zawierać wartość, aby można było ukończyć wypełnianie formularza.
Dla większości pytań dostępna jest funkcjonalność umożliwiająca ustawienie długości minimalnej i maksymalnej. Uniemożliwia to przesłanie ankiety, jeśli odpowiedź na pytanie nie mieści się w zdefiniowanych limitach. Ta funkcja pełni tę samą rolę co kolumna constraint (ograniczenie), czy też kolumna bind::esri:fieldLength w specyfikacji XLSForm w aplikacji Survey123.
Znaki specjalne
Nazwy pytań i nazwy wyborów nie mogą zawierać znaków specjalnych, takich jak spacje, przecinki, myślniki, nawiasy (także kwadratowe) ani znaków, takich jak $, % oraz #. Istotne jest, aby nazwy wyborów w pytaniach Wybór wielokrotny nie zawierały spacji ani przecinków.