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 | |
| date (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 | |
| image | Akceptuje obraz z plików na urządzeniu lub bezpośrednio zrobione zdjęcie. | Tak | Tak | |
| note | 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 |
| text | 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 |
| czas | 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
Zaznaczenie opcji To jest pytanie wymagane na karcie Edytuj 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.