W kreatorze internetowym ArcGIS Survey123 można tworzyć ankiety na potrzeby aplikacji internetowych i terenowych przy użyciu interfejsu obsługiwanego metodą przeciągania i upuszczania. Kreator internetowy Survey123 udostępnia szeroką gamę typów pytań, które można skonfigurować na wiele sposobów. Kreator internetowy działa w oparciu o specyfikację XLSForm. W przypadku bardziej zaawansowanych funkcji specyfikacji XLSForm można kontynuować projektowanie w aplikacji Survey123 Connect. Więcej informacji można znaleźć na stronie Podstawy specyfikacji XLSForm.
Elementy ankiety
Opcje na karcie Dodaj w kreatorze internetowym Survey123 umożliwiają sterowanie widocznością następujących elementów:
- Nagłówek ankiety — nagłówek jest wyświetlany u góry formularza i może być tekstem lub obrazem. Jako nagłówek obrazu podaj adres URL obrazu hostowanego online lub prześlij plik obrazu.
- Opis ankiety — opis jest wyświetlany poniżej nagłówka i może zawierać sformatowany tekst, łącza i obrazy.
- Stopka ankiety — stopka jest wyświetlana poniżej przycisku Prześlij jako hiperłącze. Podaj tekst i adres URL hiperłącza.
- CAPTCHA — zabezpieczenie CAPTCHA to test wyświetlany na końcu formularza, który użytkownicy muszą rozwiązać przed wprowadzaniem odpowiedzi. Użytkownicy rozwiązują zadanie CAPTCHA, wpisując znaki pokazane na obrazie. Można zmodyfikować tekst wyświetlany nad zabezpieczeniem CAPTCHA, klikając go w podglądzie formularza. Zabezpieczenia CAPTCHA mogą być włączone podczas korzystania z witryny https://survey123.arcgis.com/ i są obsługiwane w aplikacji internetowej Survey123. Zabezpieczenia CAPTCHA nie mogą być konfigurowane, gdy witryna internetowa Survey123 jest zainstalowana w infrastrukturze użytkownika i nie są obsługiwane w aplikacji terenowej Survey123.
Kliknij element w podglądzie formularza, aby dostosować go na karcie Edytuj.
Typy pytań
Poniższa tabela zawiera listę typów pytań, które można dodawać do ankiety za pomocą kreatora internetowego Survey123, a także informacje na temat sposobu ich implementacji w specyfikacji XLSForm.
Uwaga:
Gdy ankieta utworzona z użyciem kreatora internetowego Survey123 zostaje ponownie opublikowana z poziomu aplikacji Survey123 Connect, nie ma możliwości modyfikowania części tej ankiety, które są zarządzane przez formularz XLSForm w kreatorze internetowym. Nie można na przykład edytować tytułu ani pytań ankiety. W kreatorze internetowym można nadal edytować motywy, elementy webhook i opcje udostępniania.
| Pytanie w kreatorze internetowym Survey123 | Opis | Implementacja specyfikacji XLSForm |
|---|---|---|
Tekst jednowierszowy | Jednowierszowe wejściowe pole tekstowe. | Pytanie typu text (tekst) |
Tekst wielowierszowy | Wielowierszowe wejściowe pole tekstowe. | Pytanie typu text (tekst), wygląd multiline (wielowierszowe) |
Liczba | Dane wejściowe w postaci liczbowej, można podać liczbę całkowitą lub dziesiętna. | Pytanie typu integer (liczba całkowita) lub decimal (liczba dziesiętna) |
Data | Dane wejściowe w postaci daty. | Pytanie typu date (data) |
Czas | Dane wejściowe w postaci czasu. | Pytanie typu time (czas) |
Data i czas | Dane wejściowe w postaci daty i czasu. | Pytanie typu DateTime (data i czas) |
Adres e-mail | Ograniczone pole tekstowe, odrzuca wszystkie dane wejściowe o formacie innym niż adres e-mail. | Pytanie typu text (tekst) z ograniczeniem określonym za pomocą wyrażenia regularnego. |
Witryna | Ograniczone pole tekstowe, odrzuca wszystkie dane wejściowe o formacie innym niż adres URL witryny internetowej. | Pytanie typu text (tekst) z ograniczeniem określonym za pomocą wyrażenia regularnego. |
Wybór pojedynczy¹ | Pytanie z wieloma możliwościami odpowiedzi, można wybrać tylko jedną odpowiedź. | Pytanie typu select_one (wybierz jedną) |
Wybór wielokrotny¹ | Pytanie z wieloma możliwościami odpowiedzi, można wybrać wiele odpowiedzi. | Pytanie typu select_multiple (wybierz wiele) |
Siatka typu Wybór pojedynczy¹ | Seria pytań z wieloma możliwościami odpowiedzi (zestawy odpowiedzi są identyczne dla każdego pytania), można wybrać tylko jedną odpowiedź. | Wiele pytań typu select_one (wybierz jedną) korzystających z tej samej listy odpowiedzi, grupa o wyglądzie table-list (lista tabelaryczna) |
Menu rozwijane poziome¹ | Pytanie z wieloma możliwościami odpowiedzi wyświetlanymi w postaci listy rozwijanej, można wybrać tylko jedną odpowiedź. | Pytania typu select_one (wybierz jedną), wygląd minimal (minimalny) lub autocomplete (autouzupełnianie) |
Skala Likerta¹ | Pytanie z wieloma możliwościami odpowiedzi, należy wybrać jedną odpowiedź z użyciem symetrycznej skali typu zgadzam się / nie zgadzam się. | Pytanie typu select_one (wybierz jedną), wygląd likert (skala Likerta) |
Ocena¹ | Pytanie z wieloma możliwościami odpowiedzi, należy wybrać jedną liczbę z ciągu. | Pytanie typu select_one (wybierz jedną) |
Ranking¹ | Lista odpowiedzi, które można uporządkować. | Pytanie typu rank (ranga) |
Mapa | Rejestruje punkt, linię lub poligon na mapie. | Pytanie typu geopoint (punkt geograficzny), geotrace (ślad geograficzny) lub geoshape (kształt geograficzny) |
Adres | Pole tekstowe używane do wyszukiwania adresu. Notatka:Geokodowanie adresów przy użyciu aplikacji ArcGIS World Geocoding Service spowoduje zużycie kredytów. Więcej informacji można znaleźć w temacie Informacje o kredytach. | Pytanie typu text (tekst), wygląd geocode (geokodowanie) |
Obraz | Możliwość zrobienia jednego lub większej liczby zdjęć za pomocą aparatu lub przesłania plików obrazów z urządzenia. | Pytanie typu image (obraz), potencjalnie z wyglądem multiline (wielowierszowy) |
Przesłanie pliku | Akceptuje plik na urządzeniu. | Pytanie typu file (plik). |
Dźwięk | Zarejestruj lub prześlij plik dźwiękowy. | Pytanie typu audio (dźwięk) |
Podpis | Akceptuje dane wejściowe w postaci rysunku, przeznaczone do wprowadzania podpisu. | Pytanie typu image (obraz), wygląd signature (podpis) |
Notatka | Wyświetla tekst na ekranie. | Pytanie typu note (uwaga) |
Strona | Prezentuje pytania w postaci osobnej strony. | Pytania typu begin group (początek grupy) i end group (koniec grupy), styl pages (strony) |
Grupa | Umożliwia rozmieszczenie pytań w postaci grupy. | Pytania typu begin group (początek grupy) i end group (koniec grupy) |
¹ Nazwy wyborów mogą mieć co najwyżej 31 znaków. Dodatkowe znaki zostaną obcięte.
Opcje pytań
Dodając pytanie do ankiety, można określić dodatkowe opcje, które zmieniają wygląd pytania lub jego zachowanie podczas wypełniania ankiety i wysyłania przez użytkownika. Opcje te są odzwierciedlone w specyfikacji XLSForm.
Poniżej opisane są opcje dostępne dla wielu typów pytań. Jednak nie wszystkie z tych opcji są dostępne dla każdego typu pytania. Informacje na temat opcji, które są dostępne tylko dla konkretnych typów pytań, można znaleźć w sekcji Wskazówki.
Opcje ogólne i dotyczące wyglądu
| Opcja | Pytania, w których można zastosować | Opis | Odpowiednik w specyfikacji XLSForm |
|---|---|---|---|
Wartość domyślna | Wszystkie z wyjątkiem Obraz, Przesłanie pliku, Dźwięk, Uwaga, Strona i Grupa | Wartość domyślna będzie widoczna po otwarciu ankiety, ale można ją zmodyfikować. | Podaj wartość w kolumnie default (domyślna). |
Obliczenia | Tekst jednowierszowy, Tekst wielowierszowy, Liczba, Mapa, Data oraz Data i czas | Pole jest wstępnie wypełniane wynikiem wyrażenia, potencjalnie może uwzględniać odpowiedzi na inne pytania. Przycisk Edytuj umożliwia tworzenie obliczeń liczbowych uwzględniających pola daty i czasu, konkatenacje ciągów znakowych oraz dane wyodrębnione z innych części ankiety. Więcej informacji można znaleźć w temacie Obliczenia. | Podaj wyrażenie w kolumnie calculation (obliczenie). |
Pokaż możliwości wyboru w losowej kolejności | Wybór pojedynczy, Wybór wielokrotny, Menu rozwijane poziome i Ranking | Możliwe odpowiedzi na to pytanie będą wyświetlane w kolejności losowej. | Skonfiguruj w kolumnie parameters (parametry) wartość randomize. |
Zezwalaj na inne | Wybór pojedynczy, Wybór wielokrotny i Menu rozwijane poziome | Dostępna będzie dodatkowa możliwość Other (Inne), której wybór spowoduje wyświetlenie dodatkowego pola tekstowego. | Dodaj parametr or_other do typu pytania. |
Wartość maksymalna | Ocena i Skala Likerta | Konfiguruje maksymalną liczbę możliwych odpowiedzi na pytanie. | Liczba odpowiedzi na liście odpowiedzi na pytanie typu select_one (wybierz jedną). |
Lokalizator | Adres i Mapa | Konfiguruje usługę lokalizatora używaną w pytaniu. Jeśli nie zostanie skonfigurowana, używana jest domyślna dla instytucji. | Skonfiguruj kolumnę appearance (wygląd) pytania typu text (tekst) na geocode i skonfiguruj parametr geocode na identyfikator elementu usługi lokalizatora w kolumnie bind::esri:parameters. |
Pionowo, Poziomo i Poziomo (compact) | Wybór pojedynczy i Wybór wielokrotny | Określa, czy odpowiedzi na pytanie będą wyświetlane pionowo, poziomu lub poziomo w taki sposób, że każda odpowiedź zajmie tylko tyle miejsca, ile jest wymagane na jej etykietę. | Skonfiguruj w kolumnie appearance (wygląd) pytania wartość pustą, horizontal lub horizontal-compact. |
Opcje weryfikacji
| Opcja | Pytania, w których można zastosować | Opis | Odpowiednik w specyfikacji XLSForm |
|---|---|---|---|
To pytanie jest wymagane | Wszystkie z wyjątkiem Uwaga, Strona i Grupa | Aby możliwe było wysłanie ankiety, konieczne jest podanie odpowiedzi na to pytanie. | Skonfiguruj w kolumnie required (wymagane) tego pytania wartość true. |
Ogranicz do następującego zakresu | Pytania z danymi wejściowymi w postaci daty i czasu | Odpowiedzi są ograniczone do konkretnego zakresu zdefiniowanego dla pytania. | Można używać wyrażeń znajdujących się w kolumnie constraint (ograniczenie). |
Skonfiguruj minimalną i maksymalną liczbę znaków | Pytania z danymi wejściowymi w postaci tekstu | Użytkownik musi udzielić odpowiedzi zawierającej co najmniej minimalną liczbę znaków i nie więcej niż maksymalną liczbę znaków. | Można używać wyrażeń znajdujących się w kolumnie constraint (ograniczenie). |
Podaj liczbę plików | Obraz i Przesyłanie pliku | Użytkownik musi przesłać podaną liczbę obrazów lub plików. | Skonfiguruj w kolumnie appearance (wygląd) tego pytania wartość multiline I użyj wyrażenia count-selected w kolumnie constraint (ograniczenie). |
Skonfiguruj minimalną i maksymalną liczbę plików | Obraz i Przesyłanie pliku | Użytkownik musi przesłać co najmniej minimalną liczbę obrazów lub plików i nie więcej niż maksymalną liczbę obrazów lub plików. | Skonfiguruj w kolumnie appearance (wygląd) tego pytania wartość multiline I użyj wyrażenia count-selected w kolumnie constraint (ograniczenie). |
Limit wielkości pojedynczego pliku | Obraz i Przesyłanie pliku | Umożliwia skonfigurowanie maksymalnej wielkości pliku w megabajtach. Ta wartość dotyczy pojedynczego pliku przesyłanego w odpowiedzi na to pytanie. To ustawienie nie jest obsługiwane w aplikacji terenowej Survey123. | Podaj wartość właściwości max-size w kolumnie bind::esri:parameters. |
Inne opcje
- Zapisz odpowiedź w pamięci podręcznej — po przesłaniu ankiety ta odpowiedź będzie automatycznie wypełniana następnym razem, gdy użytkownik otworzy ankietę. Ta opcja nie ma odpowiednika w specyfikacji XLSForm, ale aplikacja terenowa Survey123 udostępnia opcję konfigurowania i stosowania odpowiedzi ulubionych, która działa podobnie.
- Tylko do odczytu — użytkownik nie może udzielić odpowiedzi na to pytanie. To pytanie może zawierać tylko wartości domyślne lub wyniki obliczeń. W specyfikacji XLSForm osiąga się to przez skonfigurowanie w kolumnie readonly (tylko do odczytu) tego pytania wartości yes.
- Ukryj na ankiecie — użytkownik nie widzi tego pytania, ale mogą być w nim zapisywane odpowiedzi wypełnione wartościami domyślnymi lub obliczeniami. Ta opcja jest dostępna tylko dla pytań, które obsługują wartości domyślne lub obliczenia. W specyfikacji XLSForm osiąga się to przez skonfigurowanie w kolumnie appearance (wygląd) tego pytania wartości hidden.
- Nie przesyłaj odpowiedzi — temu pytaniu nie odpowiada żadne pole w warstwie obiektowej, a odpowiedź na to pytanie nie jest przesyłana. W specyfikacji XLSForm osiąga się to przez skonfigurowanie w kolumnie bind::esri:fieldType tego pytania wartości null.
Etykiety dynamiczne
W uwagach, etykietach, wskazówkach i ekranie podziękowania zawartych w ankiecie może zostać wyświetlona zawartość innego pytania przez odwołanie się do nazwy pytania w tekście zgodnym z formatem ${field_name}. Może to być przydatne do wyświetlenia zawartości pól, które w innych okolicznościach nie muszą być widoczne, jak np. obliczenia wykonane na podstawie poprzednich odpowiedzi lub nazwisko osoby ankietowanej w poprzednim pytaniu w etykiecie następnego pytania.
Podczas edycji etykiety kliknij przycisk wstawienia wartości pytania 
, aby wyświetlić listę pytań, do których można się odwołać.
Nie można wykonywać obliczeń w etykietach i wskazówkach. Aby wynik obliczenia mógł zostać wyświetlony, obliczenie powinno być zawarte w pytaniu.
Uwaga:
Etykiety dynamiczne nie są obsługiwane na listach możliwości wyboru.
Obliczenia
Odpowiedź na pytanie można obliczyć przy użyciu innych pytań w ankiecie lub właściwości ankiety. Aby utworzyć lub edytować obliczenie dla pytania, kliknij przycisk Edytuj znajdujący się obok opcji Obliczenia.
Obliczenia są obsługiwane przez następujące typy pytań:
- Tekst jednowierszowy
- Tekst wielowierszowy
- Liczba
- Data
- Data i czas
- Mapa
Lokalizacji z pytania typu mapa można na przykład użyć do zapełnienia jednowierszowego pytania tekstowego. Podobnie lokalizację używaną w pytaniu typu mapa można pobrać z metadanych EXIF zdjęcia przesłanego w odpowiedzi na pytania typu image (obraz) W poniższym przykładzie pytanie typu map (mapa) o nazwie Lokalizacja jest wypełniane wartością Lokalizacja z danych EXIF z pytania Zdjęcie.
Jeśli jako Źródło zostanie skonfigurowana Warstwa, można wysłać zapytanie do warstwy obiektowej ArcGIS lub tabeli i użyć wyniku zapytania jako odpowiedzi na pytanie. Można wykonać zapytanie atrybutowe lub zapytanie przestrzenne. W poniższym przykładzie pytanie typu text (tekst) o nazwie Kraj jest wypełniane wartością Nazwa kraju z warstwy obiektowej Kraje świata. W ankiecie użytkownicy podają lokalizację w pytaniu typu map (mapa) o nazwie Lokalizacja i z warstwy obiektowej jest zwracany kraj, do którego należy dana lokalizacja.
Jeśli do utworzenia ciągu znakowego są używane obliczenia, zapytania, do których się one odnoszą, muszą mieć operator joins umieszczony przed nimi i za nimi, chyba że znajdują się na początku lub na końcu obliczenia. Poza tymi pytaniami można dowolnie wprowadzać tekst.
Uwaga:
Wyrażenie matematyczne z pustymi wartościami nie zostanie wyliczone i pytanie zawierające to wyrażenie pozostanie puste. Rozważ przypisanie wartości domyślnej równej 0 do pytań typu number (liczba), które zawierają wyrażenie.
Właściwości urządzenia i użytkownika
Poniższa tabela zawiera właściwości urządzenia i użytkownika, do których można odnosić się w obliczeniach:
| Właściwość | Opis |
|---|---|
Nazwa użytkownika | Nazwa aktualnie zalogowanego użytkownika konta instytucji ArcGIS. |
Imię i nazwisko użytkownika | Imię i nazwisko aktualnie zalogowanego użytkownika. |
Imię użytkownika | Imię aktualnie zalogowanego użytkownika. |
Nazwisko użytkownika | Nazwisko aktualnie zalogowanego użytkownika. |
Adres e-mail użytkownika | Adres e-mail aktualnie zalogowanego użytkownika konta instytucji ArcGIS. |
| Język | Język używany w bieżącej ankiecie. |
| Przesunięcie UTC | Przesunięcie w godzinach względem czasu UTC dla lokalnej strefy czasowej. |
Agent użytkownika | Ciąg znakowy agenta użytkownika urządzenia użytkownika. |
Reguły widoczności
Widoczność pytania można ustawić tak, aby pytanie było zawsze widoczne (opcja zaznaczona), zawsze niewidoczne (opcja niezaznaczona) lub aby widoczność była ustawiona przez regułę.
Kliknij opcję Ustaw regułę, aby utworzyć regułę widoczności i wybrać inne pytanie w ankiecie, na które udzielona odpowiedź będzie kontrolować widoczność wybranego pytania. Gdy reguła widoczności nie jest spełniona, autor może wybrać, czy odpowiedzi są przesyłane. Wybranie opcji nieprzesyłania odpowiedzi jest równoznaczne z użyciem kolumny relevant (odpowiednie) w specyfikacji XLSForm. Wybranie opcji przesyłania odpowiedzi jest równoznaczne z użyciem kolumny bind::esri:visible w specyfikacji XLSForm.
Przycisk Skopiuj regułę widoczności umożliwia autorowi zastosowanie tej samej reguły widoczności do wielu pytań. Gdy widoczność pytania jest kontrolowana przez regułę widoczności, opcja Widoczne jest wyświetlana jako stan nieokreślony (opcja częściowo zaznaczona).
Notatka:
W przypadku pytań typu Image (Obraz), File upload (Przesłanie pliku), Audio (Dźwięk) i Signature (Podpis) nie można przesyłać odpowiedzi, gdy pytanie nie jest widoczne.