Aplikacja Survey123 obsługuje pytania typu select_one (wybierz jedną), select_multiple (wybierz wiele) i rank (ranga).
Notatka:
Pytania typu rank (ranga) są obecnie obsługiwane tylko w aplikacji terenowej i aplikacji internetowej.
Utworzenie pytania z wieloma możliwościami odpowiedzi wymaga dodania arkusza choices (możliwości wyboru) do skoroszytu programu Excel. Poniżej znajduje się przykład pytania typu select_one:
Nazwa listy w arkuszu survey (ankieta) – yes_no – musi być zgodna z nazwą listy w arkuszu choices (możliwości wyboru). Dzięki temu można mieć pewność, że w formularzu zostanie wyświetlona prawidłowa lista możliwych do wybrania odpowiedzi na określone pytanie.
Domyślnie w momencie publikowania ankiety możliwości wyboru w pytaniach typu select_one (wybierz jedną) są dodawane do warstwy obiektowej ankiety jako domeny wartości kodowych. Użytkownik może wyłączyć tworzenie domen podczas procesu publikowania. Więcej informacji zawiera temat Opcje publikowania.
Uwaga:
Podczas korzystania z listy wyboru zawierającej zduplikowane nazwy wyborów obowiązują następujące ograniczenia:
- Zduplikowane nazwy wyborów nie są obsługiwane w przypadku pytań typu select_multiple (wybierz wiele).
- Zduplikowane nazwy wyborów nie są obsługiwane w przypadku ankiet wielojęzycznych.
- Funkcja jr:choice-name() zwraca etykietę pierwszego zduplikowanego wyboru na liście.
- W przypadku otwarcia z poziomu folderu Skrzynka odbiorcza, Wersje robocze, Skrzynka nadawcza, Wysłane lub Przegląd pytania typu select_one (wybierz jedną) przywracają pierwszy zduplikowany wybór na liście.
Dodatkowe uwagi na temat modyfikowania list możliwości wyboru w istniejących ankietach zawiera sekcja Aktualizowanie ankiety.
Można także dodawać z wieloma możliwościami odpowiedzi, w przypadku których można wybierać wiele odpowiedzi, na przykład takie jak poniższe:
Domyślnie te możliwości wyboru są wyświetlane w kolejności podanej w arkuszu choices (możliwości wyboru). Możliwości wyboru można także ułożyć w kolejności losowej, wprowadzając wartość randomize=true w kolumnie parametrów.
Uwaga:
Wszystkie wartości zebrane w pytaniu typu select_multiple (wybierz wiele) lub rank (ranga) są zapisywane w postaci listy rozdzielanej przecinkami, dlatego należy unikać używania przecinków w kolumnie nazwy listy możliwości wyboru. Należy również zwrócić uwagę na to, że pytania typu select_multiple (wybierz wiele) lub rank (ranga) wysyłają do warstwy obiektowej tylko nazwę możliwości wyboru, a nie nazwę i etykietę wysyłane przez pytania typu select_one (wybierz jedną).
Wartość pytania typu rank (ranga) pozostaje pusta, dopóki kolejność możliwości wyboru nie zostanie zmodyfikowana przez użytkownika. Jeśli wartość domyślna została skonfigurowana, jest stosowana domyślna kolejność możliwości wyboru, chyba że zostanie ona zmodyfikowana przez użytkownika.
Indywidualną odpowiedź na pytanie typu select_multiple (wybierz wiele) można uzyskać za pomocą funkcji selected-at. Poniższe wyrażenie zwraca wartość parametru name (nazwa) dla pierwszej odpowiedzi na pytanie typu select_multiple (wybierz wiele):
selected-at(${species}, 0)
Aby wysłać etykietę dla odpowiedzi, można użyć funkcji jr:choice-name. Aby uzyskać wartość parametru label (etykieta) dla drugiej odpowiedzi na to samo pytanie typu select_multiple (wybierz wiele), użyj następującego wyrażenia:
jr:choice-name(selected-at(${species}, 1), '${species}')
Wygląd
Skonfigurowanie kolumny appearance (wygląd) na wartość minimal (minimalny) powoduje, że pytanie typu select one (wybierz jedną) jest wyświetlane w postaci menu rozwijanego.
Skonfigurowanie kolumny appearance (wygląd) na wartość horizontal (poziomy) powoduje, że możliwości wyboru dla pytania typu select (wybierz) są wyświetlane poziomo w kolumnach o równej szerokości.
Wygląd compact (kompaktowy) jest podobny do wyglądu horizontal (poziomy), ale do określenia szerokości kolumn jest używana inna metoda, co może spowodować, że możliwości wyboru zajmą mniej miejsca.
Notatka:
W aplikacji Survey123 Connect dla wyglądu compact (kompaktowy) można określić maksymalną liczbę kolumn, podając liczbę oddzieloną łącznikiem. Na przykład compact-3 ogranicza pytanie do maksymalnie trzech kolumn w przypadku pytań z wieloma możliwościami odpowiedzi w ankietach używanych w aplikacji terenowej lub aplikacji internetowej.
Wyglądy compact i horizontal-compact są identyczne. W aplikacji internetowej Survey123 zamiast używania kolumn te wyglądy umieszczają etykiety wyboru dla pytania typu select (wybierz) obok siebie w wierszach bez dodatkowych odstępów.
W pytaniach typu select one (wybierz jedną) skonfigurowanie kolumny appearance (wygląd) na wartość likert (skala Likerta) powoduje, że odpowiedzi są wyświetlane w postaci skali Likerta. Skala Likerta to skala ocen umożliwiająca ankietowanym określenie ich poziomu akceptacji na symetrycznej skali typu zgadzam się / nie zgadzam się.
Skonfigurowanie kolumny appearance (wygląd) na wartość autocomplete (autouzupełnianie) powoduje, że pytanie typu select (wybierz) jest wyświetlane w postaci pola tekstowego i menu rozwijanego. Wprowadzenie tekstu w polu powoduje, że w menu rozwijanym znajdą się tylko te odpowiedzi, które zawierają wpisany w polu tekst. Jest to przydatne w przypadku bardzo długich list wyboru.
Notatka:
Wygląd autocomplete (autouzupełnianie) dla pytań typu select multiple (wybierz wiele) jest obsługiwany tylko w aplikacji Survey123 Mobile. Nie jest on obsługiwany w aplikacji terenowej ani aplikacji internetowej.
Skonfigurowanie kolumny appearance (wygląd) na wartość search (wyszukiwanie) powoduje, że można wypełnić listę możliwości wyboru w pytaniach typu select (wybierz) wartościami z tabeli CSV w folderze media ankiety lub istniejącej warstwy obiektowej bądź tabeli. Więcej informacji można znaleźć w sekcji Tworzenie dynamicznej listy opcji wyboru za pomocą wyglądu search (wyszukiwanie).
Skonfigurowanie kolumny appearance (wygląd) na wartość image-map (mapa obrazu) powoduje, że pytanie typu select (wybierz) można zaprezentować w aplikacji terenowej jako obraz z dostępnymi do wyboru regionami jako opcjami przy użyciu pliku SVG. Więcej informacji można znaleźć w sekcji Praca z plikami SVG.
Tworzenie dynamicznej listy opcji wyboru za pomocą wyglądu search (wyszukiwanie)
Notatka:
W tej sekcji opisano funkcje, które są dostępne tylko w aplikacji Survey123 Connect i aplikacji terenowej Survey123. Funkcje te nie są dostępne w aplikacji Survey123 Studio ani Survey123 Mobile.
Pytania typu select one (wybierz jedną) i select multiple (wybierz wiele) obsługują wygląd search (wyszukiwanie), którego można użyć do zapełnienia listy wyboru wartościami z tabeli CSV w folderze media ankiety lub z istniejącej warstwy obiektowej albo tabeli. W przypadku korzystania z wyglądu search (wyszukiwanie) nadal trzeba umieścić pozycję w arkuszu choices (możliwości wyboru), ale zamiast wymieniać każdy z wyborów, należy odwołać się do nazwy pola w istniejącej warstwie obiektowej lub tabeli.
W poniższym przykładzie, lista wyboru o nazwie us_states jest zdefiniowana w arkuszu choices (możliwości wyboru) i używa pola STATE_NAME zarówno dla nazwy wyboru, jak i etykiety.
W poniższym przykładzie ta lista wyboru jest następnie przywoływana w arkuszu ankiety w taki sam sposób, jak inne listy wyboru, ale zawiera ona wyrażenie wyglądu search (wyszukiwanie), które odwołuje się do istniejącej warstwy obiektowej, z której należy pobrać możliwości wyboru.
Wyrażenie wyglądu search (wyszukiwanie) musi być skonstruowane w następujący sposób, ze zmiennymi oddzielonymi przecinkami:
search(tableName, searchType, searchColumn, searchText, filterColumn, filterText)Parametr tableName akceptuje albo nazwę pliku .csv w folderze media ankiety, na przykład airports, albo adres URL warstwy obiektowej lub warstwy usługi mapowej, poprzedzony nazwą dla aplikacji Survey123, aby wewnętrznie odwoływać się do tabeli. Nazwa tabeli nie musi być zgodna z nazwą warstwy hostowanej, ale ponieważ jest to sposób, w jaki aplikacja Survey123 wewnętrznie odnosi się do wyszukiwania, musi być inna niż wszystkie inne nazwy tabel i plików .csv używanych w ankiecie. Opcjonalnie można dołączyć parametry zapytania do punktu końcowego REST warstwy obiektowej lub warstw usług mapowych, aby skonfigurować zachowanie wyszukiwania. W poniższym przykładzie adres URL warstwy obiektowej jest dołączony do parametru resultRecordCount, aby zapełnić listę wyboru pierwszymi 10 wynikami zapytania, przy czym wyszukiwanie jest przechowywane wewnętrznie pod nazwą airports:
"airports?url=https://services1.arcgis.com/e7dVfn25KpfE6dDd/arcgis/rest/services/Airports2/FeatureServer/0&resultRecordCount=10"Listę wyboru można także filtrować z użyciem wyrażenia WHERE. W następującym przykładzie użycia tableName lista wyboru zostanie przefiltrowana tak, aby wyświetlane były tylko stany inne niż Alabama i Alaska:"state?url=https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/USA_States_Generalized_Boundaries/FeatureServer/0&where=STATE_NAME
NOT IN('Alabama', 'Alaska')"
Notatka:
Parametry wyszukiwania zawierające znaki specjalne muszą być zakodowane, jeśli ankieta będzie używana w aplikacji internetowej Survey123. Kodowanie zastępuje znaki specjalne (np. znak wieloznaczny w wyrażeniu) znakiem procentu (%), po którym następuje ich szesnastkowy równoważnik.
Następujące dodatkowe parametry są opcjonalne, ale można ich użyć do zawężenia wyników wyszukiwania:
| Parametr | Opis |
|---|---|
searchType | Steruje typem wyszukiwania i akceptuje różne wartości w zależności od tego, czy przeszukiwana tabela jest tabelą przestrzenną w warstwie obiektowej, czy tabelą nieprzestrzenną w tabeli CSV lub tabeli obiektów. W przypadku tabel przestrzennych akceptowane typy wyszukiwania to: intersects, contains, crosses, envelope_intersects, index_intercepts, overlaps, touches i within. Więcej informacji zawiera temat Zależności przestrzenne. W przypadku tabeli nieprzestrzennej obsługiwane typy wyszukiwania to: contains, startswith, endswith i matches. |
searchColumn | Określa kolumnę, która będzie przeszukiwana w celu znalezienia tekstu podanego w parametrze searchText. Kolumny te są pobierane z samej tabeli. Ponadto w tabeli przestrzennej w warstwie obiektowej mogą być przeszukiwane kolumny @geopoint, @geotrace i @geoshape. |
searchText | Zawiera tekst, który będzie wyszukiwany i zwracany w parametrze searchColumn. |
Dodatkowo do wyrażenia wyszukiwania można dodać następujące parametry filtrujące, aby jeszcze bardziej doprecyzować wartości na liście wyboru:
| Parametr | Opis |
|---|---|
filterColumn | Ustawia kolumnę, w której będą wyszukiwane dopasowania do tekstu podanego w parametrze filterText. Zapytanie wyszukiwania zwróci tylko te wyniki, które zawierają ten tekst. Parametry filterColumn i filterText muszą być używane razem. |
filterText | Wyszukiwany tekst w kolumnie podanej w parametrze filterColumn. Parametry filterColumn i filterText muszą być używane razem. |
Poniżej znajduje się przykładowe wyrażenie wyszukiwania, które zawiera niektóre z opcjonalnych parametrów dla wyglądu search (wyszukiwanie). Zapełnia ono listę wyboru treścią pliku .csv, używając poprzedniego pytania jako tekstu wyszukiwania.
search('csvName', 'matches', 'breed', ${DogQuestion})
Notatka:
Pytania o wyglądzie search (wyszukiwanie) są prezentowane w aplikacji internetowej Survey123 w taki sam sposób, jak pytania typu select (wybierz) o wyglądzie autocomplete (autouzupełnianie).
Podawanie innej odpowiedzi
W przypadku pytań z wieloma możliwościami odpowiedzi w ankietach może być uwzględniana możliwość wyboru odpowiedzi other (inny), jeśli pożądanej odpowiedzi nie ma na liście. Respondent może zostać następnie poproszony o określenie tej innej odpowiedzi. Można to zrobić w formularzu XLSForm, stosując metodę ręczną lub wbudowaną. Metoda wbudowana jest szybsza i łatwiejsza do skonfigurowania niż metoda ręczna, ale ma kilka ograniczeń.
Metoda ręczna
Metoda ręczna jest zalecana, ponieważ umożliwia określenie nazwy i etykiety możliwości wyboru other (inny) oraz nazwy i etykiety pytania typu text (tekst) zawierającego tę inną odpowiedź. Możliwe jest udostępnienie tłumaczeń tych nazw i etykiet. Można także zastosować ograniczenia do pytania typu text (tekst) i określić jego wygląd, jak również ustawić je jako wymagane.
Najpierw dodaj możliwość wyboru other (inny) do listy możliwości wyboru związanej z danym pytaniem w arkuszu choices (możliwości wyboru). Tak jak w przypadku każdej innej możliwości wyboru na liście określ nazwę i etykietę także dla tej. W poniższym przykładzie lista możliwości wyboru color (kolor) zawiera możliwość wyboru o nazwie other (inny).
W arkuszu survey (ankieta) dodaj pytanie typu text (tekst), w którym wprowadzana będzie odpowiedź other (inny). Dodaj wyrażenie relevant (odpowiednie), aby pytanie typu text (tekst) było odpowiednie tylko wtedy, gdy wybrana zostanie możliwość other (inny). W poniższym przykładzie pytanie other_color jest odpowiednie tylko wtedy, gdy odpowiedzią na pytanie typu select_one (wybierz jedną) jest other (inny).
W ankietach obsługujących wiele języków pytania i możliwości wyboru mogą być przetłumaczone. W poniższym przykładzie w arkuszu survey (ankieta) dostępne są tłumaczenia na języki francuski i grecki dla pytania typu select_one (wybierz jedną) i pytania typu text (tekst).
W arkuszu choices (możliwości wyboru) dostępne są także tłumaczenia, w tym dla możliwości wyboru other (inny).
Metoda wbudowana
W metodzie wbudowanej aplikacje Survey123 Studio i Survey123 Connect automatycznie tworzą możliwość wyboru other (inny) oraz pytanie, w którym wprowadzana jest odpowiedź na wybór other (inny). Aby skorzystać z tej metody, wpisz or_other po nazwie listy możliwości wyboru w kolumnie type (typ) arkusza survey (ankieta). Możliwość wyboru Other (Inny) zostanie wyświetlona na liście możliwości wyboru związanej z danym pytaniem. Jeśli jest wybrana opcja Other (Inny), wyświetlane jest pytanie Specify other (Podaj inny), w którym użytkownicy mogą wprowadzić własną odpowiedź. Aby przechować tę odpowiedź, aplikacje Survey123 Studio i Survey123 Connect automatycznie tworzą dodatkowe pole w warstwie obiektowej, używając nazwy pytania z wieloma możliwościami poprzedzającej słowo _other, na przykład: favorite_toppings_other. Zapoznaj się z następującym przykładem:
Uwaga:
Etykieta pola Specify other (Podaj inny) nie zostanie wyświetlona w językach innych niż angielski.
W przypadku tworzenia ankiety na podstawie istniejącej warstwy obiektowej pole dla pytania Specify other (Podaj inny) nie zostanie utworzone automatycznie, a ankieta nie zostanie opublikowana. Konieczne jest ręczne utworzenie w warstwie obiektowej pola dla pytania Specify other (Podaj inny). Nazwa pola musi być złożona z nazwy pytania z wieloma możliwościami, po której następuje słowo _other, na przykład: favorite_toppings_other.
Zewnętrzna lista możliwości wyboru
Listy możliwości wyboru pytań typu select_one (wybierz jedną) i select_multiple (wybierz wiele) można przechowywać w zewnętrznym pliku .csv. Podejście to sprawdza się doskonale w przypadku dużych list możliwości wyboru, ankiet z kilkoma listami możliwości wyboru oraz list zarządzanych poza aplikacją Survey123. Nie należy mylić zewnętrznych list możliwości wyboru z wyborami zewnętrznymi, w przypadku których możliwości wyboru muszą znajdować się w osobnym arkuszu.
Plik .csv musi zawierać kolumny name (nazwa) i label (etykieta).
Notatka:
Jeśli w pliku .csv brakuje nagłówka kolumny lub na końcu wierszy znajduje się przecinek, plik nie zostanie zaimportowany do ankiety.
Najlepsze wyniki można uzyskać, kodując plik .csv z użyciem kodowania znaków UTF-8. Jeśli do utworzenia pliku .csv jest używany program Microsoft Excel, należy zapisać ten plik jako CSV UTF-8.
Plik .csv może zawierać przetłumaczone kolumny etykiet, ale przetłumaczone możliwości wyboru będą wyświetlane tylko w aplikacji Survey123 Studio, Survey123 Connect, Survey123 Mobile i aplikacji terenowej, ale nie w aplikacji internetowej.
Aby dodać pytanie z zewnętrzną listą możliwości wyboru, wpisz typ pytania (select_one_from_file lub select_multiple_from_file) i nazwę pliku .csv, na przykład select_one_from_file CoverType.csv. W nazwach plików jest rozróżniana wielkość liter i nie można w nich używać spacji.
Istnieją dwa sposoby dołączenia pliku .csv: zapisanie pliku w folderze media ankiety lub połączenie z plikiem .csv hostowanym w systemie ArcGIS.
Wskazówka:
Uruchom narzędzie Przekształcanie list możliwości wyboru w pliki CSV, aby zautomatyzować migrację list możliwości wyboru z arkusza możliwości wyboru w pliki .csv.
Połączenie pliku .csv
Notatka:
W tej sekcji opisano funkcje, które są dostępne tylko w aplikacji Survey123 Connect i aplikacji terenowej Survey123. Funkcje te nie są dostępne w aplikacji Survey123 Studio ani Survey123 Mobile.
Aby połączyć plik .csv z zasobów systemu ArcGIS z ankietą, wykonaj następujące czynności:
- Sprawdź, czy plik .csv jest hostowany w usłudze ArcGIS Online lub oprogramowaniu ArcGIS Enterprise i ma takie same uprawnienia udostępniania jak ankieta.
- Przed połączeniem zasobów upewnij się, że ankieta jest opublikowana w systemie ArcGIS.
- W aplikacji Survey123 Connect otwórz ankietę i kliknij kartę Połączone zasoby. Kliknij przycisk Połącz zasoby, wybierz CSV, a następnie przejdź do pliku .csv do połączenia i go wybierz.
Aby w podglądzie formularza wyświetlane były możliwości wyboru z połączonego pliku .csv, w aplikacji Survey123 Connect na karcie Połączone zasoby kliknij przycisk pobierania 
. Spowoduje to umieszczenie kopii pliku .csv w folderze Multimedia ankiety. Połączone pliki są pobierane automatycznie z ankietą w aplikacji terenowej.
Jeśli ręcznie umieścisz plik .csv w folderze Multimedia, później zaś do systemu ArcGIS prześlesz plik .csv o takiej samej nazwie i połączysz go z ankietą, plik .csv w ankiecie zostanie zaktualizowany na podstawie połączonych zasobów (jeśli są nowsze).
Przekształcanie list możliwości wyboru w pliki CSV
Notatka:
W tej sekcji opisano funkcje, które są dostępne tylko w aplikacji Survey123 Connect i aplikacji terenowej Survey123. Funkcje te nie są dostępne w aplikacji Survey123 Studio ani Survey123 Mobile.
Uruchom narzędzie Przekształcanie list możliwości wyboru w pliki CSV w aplikacji Survey123 Connect, aby automatycznie zmigrować wskazane listy możliwości wyboru z arkusza możliwości wyboru w nowe pliki .csv w folderze media. Narzędzie modyfikuje również odpowiednie pytania w arkuszu ankiety, aby używać typów pytań select_one_from_file i select_multiple_from_file.
Aby uruchomić narzędzie, wykonaj następujące czynności:
- Skonfiguruj środowisko języka Python w aplikacji Survey123 Connect, aby móc uruchomić narzędzie. Więcej informacji na ten temat zawiera sekcja Konfigurowanie aplikacji Python.
- Otwórz formularz XLSForm ankiety. W arkuszu choices (możliwości wyboru) dodaj kolumnę o nazwie esri_tool_convert_csv. Dodaj wartość yes (tak) do co najmniej jednego wiersza dla każdej z list możliwości wyboru, które chcesz przekształcić w zewnętrzne listy możliwości wyboru. Zapisz i zamknij plik.
- W aplikacji Survey123 Connect otwórz ankietę, kliknij opcję Narzędzia i wybierz opcję Przekształcanie list możliwości wyboru w pliki CSV.
Po zakończeniu konwersji dla każdej zmigrowanej listy możliwości wyboru zapisywany jest plik .csv w folderze media. Nazwa pliku jest zgodna z oryginalną wartością nazwy listy możliwości wyboru (kolumna list_name). Arkusz możliwości wyboru jest aktualizowany tak, aby zawierał tylko pozostałe listy, które nie zostały zmigrowane. Nadal zawiera wszystkie niestandardowe nagłówki kolumn z oryginalnej wersji. W arkuszu ankiety odpowiednie pytania select_one i select_multiple zostały zmienione na pytania select_one_from_file i select_multiple_from_file, aby odnosiły się do nowych zewnętrznych list możliwości wyboru. Oryginalny arkusz możliwości wyboru jest zapisywany w arkuszu choices_backup, dzięki czemu można zweryfikować wyniki lub powrócić do niego. Kopię zapasową arkusza można zachować lub usunąć.
Narzędzie nie przekształca list możliwości wyboru używanych w pytaniach typu ranking, grupach table-list lub pytaniach z wyglądem search (wyszukiwanie). Żadne z pytań wykorzystujących te listy możliwości wyboru nie jest modyfikowane w ankiecie.
Jeśli narzędzie wykryje nieobsługiwane pytania, w folderze debug zostanie utworzony plik .xlsx z nazwami odpowiednich list możliwości wyboru. Plik ten znajduje się w następującym folderze:
C:\Users\<username>\ArcGIS\My Survey Designs\<surveyName>\debug\convertchoicelists