W ankietach można umieszczać pytania typu text (tekst), integer (liczba całkowita) i decimal (wartość dziesiętna), aby użytkownicy wpisywali odpowiedzi w postaci tekst i liczb.
Pytania typu text (tekst) pozwalają na wpisywanie w ankiecie odpowiedzi w postaci dowolnego tekstu. Domyślnie w formularzu wyświetlane jest jednowierszowe wejściowe pole tekstowe. Jeśli tekst przekroczy wielkość pola tekstowego, jego długość pozostaje niezmieniona i pole przewijane jest poziomo bez dzielenia wierszy. To rozwiązanie jest idealne w przypadku krótkich odpowiedzi. Aby wymusić dostosowanie tekstowych danych wejściowych do określonego formatu, można zastosować maskę wejściową. Można również zastosować wyrażenie regularne w polu tekstowym, aby automatycznie odrzucać odpowiedzi, które nie mają określonego formatu, na przykład nie stanowią adresu e-mail lub adresu URL witryny.
Pytania typu integer (liczba całkowita) i decimal (wartość dziesiętna) zmuszają użytkownika do wprowadzania odpowiednich wartości liczbowych. W kolumnie constraint (ograniczenie) można dla tych typów pytań określić wartości minimalną i maksymalną, aby uniemożliwić użytkownikom przesyłanie ankiety, jeśli odpowiedź nie mieści się w podanym zakresie.
Można zmienić zachowanie tych typów pytań i sposób ich prezentowania poprzez skonfigurowanie wyglądu. Informacje na temat tego, które aplikacje do przesyłania danych obsługują konkretny wygląd, zawiera sekcja Wygląd.
Wygląd tekstu
Notatka:
W aplikacji Survey123 Mobile w przypadku pytań typu text (tekst) obsługiwany jest tylko wygląd multiline (wielowierszowe).
W aplikacji internetowej Survey123 nie są obsługiwane wyglądy predictivetext (przewidywany tekst) i nopredictivetext (bez przewidywanego tekstu).
Skonfigurowanie w kolumnie appearance (wygląd) wartości multiline (wielowierszowe) powoduje, że tekst pytania jest wyświetlany w postaci wielowierszowego pola tekstowego. To większe pole tekstowe jest idealne w przypadku długich odpowiedzi. Wpisywany tekst jest przenoszony do nowego wiersza i akceptowane są znaki powrotu karetki.
Notatka:
W formularzach używanych w aplikacji terenowej Survey123 można skonfigurować domyślną wysokość wielowierszowego pola tekstowego, ustawiając parametr defaultHeight w kolumnie body::esri:style. Na przykład wpisanie defaultHeight=5 w kolumnie body:esri:style powoduje wyświetlenie pięciu wierszy w wielowierszowym polu tekstowym po otwarciu ankiety. Jeśli ta wartość nie będzie skonfigurowana, po otwarciu ankiety w wielowierszowym polu tekstowym zostaną wyświetlone trzy wiersze.
Po skonfigurowaniu wyglądu predictivetext (przewidywany tekst) lub nopredictivetext (bez przewidywanego tekstu) w pytaniach typu text (tekst) wymuszane jest odpowiednio włączenie lub wyłączenie przewidywanego tekstu na urządzeniach przenośnych. Domyślnie w systemie Android funkcja przewidywania tekstu dla pytań typu text (tekst) jest wyłączona, co może dezaktywować funkcję rozpoznawania mowy przy niektórych klawiaturach. Zastosuj do pytań typu text (tekst) wygląd predictivetext, aby włączyć rozpoznawanie mowy dla tego pytania. Przewidywanie tekstu jest domyślnie włączone w systemie iOS.
Skonfigurowanie wyglądu na geocode (geokodowanie) powoduje, że pytanie typu text (tekst) jest używane do wyszukiwania i przesyłania geokodowanego adresu.
Wyglądy są również dostępne na potrzeby pobierania identyfikatora znacznika InfraMarker i pobierania wartości z dalmierza.
Wyszukiwanie i przesyłanie geokodowanego adresu
Notatka:
W tej sekcji opisano funkcje, które są dostępne tylko w aplikacji terenowej Survey123. Funkcje te nie są dostępne w aplikacji Survey123 Mobile.
Skonfigurowanie kolumny appearance (wygląd) na wartość geocode (geokodowanie) powoduje, że pytanie typu text (tekst) jest używane do wyszukiwania i przesyłania geokodowanego adresu. Gdy użytkownicy rozpoczynają wpisywanie adresu, pojawia się seria opcji autouzupełniania sugerujących lokalizacje na podstawie domyślnie dostępnych lokalizatorów instytucji. Jeśli użytkownik nie jest zalogowany, używana jest usługa ArcGIS World Geocoder. Wygląd geocode (geokodowanie) wymaga połączenia z Internetem i nie będzie działać w środowisku w trybie offline.
Ostatecznie wybrany adres zostanie wysłany do warstwy obiektowej jako ciąg znakowy: jednak pełne dane geokodowane są tymczasowo przechowywane jako obiekt JSON przed wysłaniem, co pozwala na wydzielenie poszczególnych właściwości do innych pól.
Aby wydzielić konkretne właściwości z obiektu JSON, użyj funkcji pulldata("@json") w kolumnie calculation (obliczenia) innego pytania.
pulldata("@json", ${address}, "location.x")
pulldata("@json", ${address}, "searchCandidate")
Cały obiekt JSON może być zwrócony w pojedynczym polu tekstowym przez niedefiniowanie poszczególnych właściwości.
pulldata("@json", ${address})
Więcej informacji na temat funkcji pulldata("@json") zawiera sekcja Pobieranie wartości z formatu JSON.
Notatka:
Geokodowanie przy użyciu aplikacji ArcGIS World Geocoding Service spowoduje zużycie kredytów. Więcej informacji można znaleźć w temacie Informacje o kredytach.Aby skonfigurować konkretny lokalizator do zwracania wyników, należy podać identyfikator elementu lokalizatora w kolumnie bind::esri:parameters, na przykład geocode=36ff9e8c13e042a58cfce4ad87f55d19 Home. Lokalizator używany w ankiecie ArcGIS Online musi być elementem w usłudze ArcGIS Online. Lokalizator używany w ankiecie ArcGIS Enterprise musi być elementem w tym samym portalu co ankieta.
Dostępne właściwości będą się różnić w zależności od użytego lokalizatora. Wyjątkiem jest właściwość searchText, która jest dostępna niezależnie od użytego lokalizatora i zwraca albo dokładny ciąg znakowy użyty do wyszukania adresu, albo opcję wybraną z listy wyników.
Można dodatkowo kontrolować sposób prezentacji pytania o wyglądzie geocode (geokodowanie), konfigurując jeden z poniższych parametrów w kolumnie body::esri:style:
Notatka:
Parametry indicator, proximity, maxResults i suggestions nie są obsługiwane w aplikacji internetowej Survey123.
- indicator — umożliwia wyświetlanie w geokodowanych wynikach kierunku i odległości od bieżącej lokalizacji urządzenia. Ten parametr można skonfigurować na wartość distance, direction, obie te wartości rozdzielone przecinkiem lub na wartość none. Domyślnie parametr ten jest ustawiony na pokazywanie tylko odległości.
- proximity — kontroluje, czy wyniki geokodowane będą pokazywać tylko wyniki w określonym promieniu od lokalizacji urządzenia. W tym parametrze akceptowana jest liczba, po której następuje dowolna z następujących jednostek standardowych: m (metry), km (kilometry), ft (stopy), mi (mile) lub yd (jardy). Jeśli nie zostanie podana jednostka, domyślnie będą to metry. Jeśli zostanie ustawiona wartość 0, bliskość nie będzie brana pod uwagę w wynikach wyszukiwania. Domyślnie parametr ten jest ustawiony na wartość on, co pozwala na sortowanie sugestii według bliskości bez odfiltrowywania lokalizacji ze względu na odległość.
- maxResults — kontroluje maksymalną liczbę zwracanych wyników. Na przykład maxResults=10 zwróci maksymalnie 10 możliwych wyników. Domyślnie parametr ten jest ustawiany tak, że wyświetlanych jest maksymalnie 6 wyników.
- suggestions — działa jako interfejs dla operacji suggest w interfejsie ArcGIS REST API. Gdy ten parametr jest ustawiony na wartość yes, rozwijana lista potencjalnych lokalizacji jest zapełniana przez operację suggest. Gdy ten parametr jest ustawiony na wartość no lub gdy usługa geokodowania nie obsługuje operacji suggest, lista potencjalnych lokalizacji jest zapełniana przez operację findAddressCandidates. Domyślnie ten parametr ma ustawioną wartość yes.
Pobieranie identyfikatora znacznika InfraMarker
Notatka:
W tej sekcji opisano funkcje, które są dostępne tylko w aplikacji terenowej Survey123. Funkcje te nie są dostępne w aplikacji Survey123 Mobile.
Korzystając z opisanych poniżej wyglądów, można odczytywać dane z formularza lub zapisywać dane do znacznika RFID InfraMarker.
Konfigurując kolumnę appearance (wygląd) pytania typu text (tekst) na wartość inframarker, można zdefiniować informacje, jakie mają zostać zapisane w znaczniku. Mogą one obejmować wartości assetOwner, assetName, latitude i longitude. Wartości mogą też być obliczane na podstawie innych pytań ankiety. Następujące wyrażenie w kolumnie calculation (obliczenie) zapisuje na przykład odpowiedzi z pytań asset_name, asset_owner, lat i long do znacznika:
concat("assetName=", ${asset_name}, "&assetOwner=", ${asset_owner}, "&latitude=", ${lat}, "&longitude=", ${long})
Ustawiając wygląd innego pytania tekstowego w tej samej ankiecie na getinframarkerid, można pobrać unikatowy, 24-znakowy identyfikator znacznika InfraMarker i zachować go w ankiecie.
Więcej informacji zawiera dokumentacja aplikacji InfraMarker.
Pobieranie wartości z dalmierza
Notatka:
W tej sekcji opisano funkcje, które są dostępne tylko w aplikacji terenowej Survey123. Funkcje te nie są dostępne w aplikacji Survey123 Mobile.
Po skonfigurowaniu kolumny appearance (wygląd) na wartość rangefinder (dalmierz) pytanie typu text (tekst) może akceptować albo pełny obiekt JSON, albo określoną wartość zwracaną z dalmierza. Jeśli akceptowane są pełne obiekty JSON, w tym pytaniu należy skonfigurować właściwość bind::esri:fieldLength na wartość 1000, aby zapewnić, że cała wartość się zmieści.
Po skonfigurowaniu wyglądu rangefinder (dalmierz) pytanie typu integer (liczba całkowita) lub decimal (liczba dziesiętna) może zaakceptować określoną wartość, która jest zwracana z dalmierza. Zdecyduj, który pomiar ma zostać zapisany, używając jednej z następujących wartości w kolumnie bind::esri:parameters: height, azimuth, horizontalDistance, slopeDistance lub inclination. Na przykład measurement=height zapisze tylko zwróconą przez dalmierz wartość wysokości.
Wygląd integer (liczba całkowita)
Notatka:
W aplikacji Survey123 Mobile w przypadku pytań typu integer (tliczba całkowita) obsługiwany jest tylko wygląd spinner (pokrętło).
W aplikacji internetowej Survey123 nie są obsługiwane żadne z tych wyglądów całkowitoliczbowych.
Skonfigurowanie kolumny appearance (wygląd) na wartość spinner (pokrętło) powoduje, że pytanie typu integer (liczba całkowita) jest wyświetlane z przyciskami służącymi do zwiększania lub zmniejszania wartości o jeden. Trzymanie wybranego przycisku powoduje wielokrotne zwiększanie/zmniejszanie wartości do chwili zwolnienia przycisku.
Skonfigurowanie kolumny appearance (wygląd) na numbers (liczby) powoduje, że wyróżnione pytanie typu integer (liczba całkowita) jest wyświetlane razem z niestandardową klawiaturą numeryczną umożliwiającą wprowadzenie wartości. Na klawiaturze znajduje się także przycisk służący do przypisywania do wartości dodatniego lub ujemnego znaku.
Skonfigurowanie kolumny appearance (wygląd) na calculator (kalkulator) powoduje, że wyróżnione pytanie typu integer (liczba całkowita) jest wyświetlane razem z niestandardową klawiaturą kalkulatora umożliwiającą wprowadzenie i zmodyfikowanie wartości.
Skonfigurowanie kolumny appearance (wygląd) na distress (skala niepokoju) powoduje, że pytanie typu integer (liczba całkowita) jest wyświetlane w postaci skali niepokoju. Skala niepokoju jest 10-punktową skalą używaną do pomiaru odczuć, takich jak niepokój, ból i zadowolenie.
Wygląd decimal (wartość dziesiętna)
Notatka:
W aplikacji Survey123 Mobile w przypadku pytań typu decimal (wartość dziesiętna) obsługiwany jest tylko wygląd spinner (pokrętło).
W aplikacji internetowej Survey123 nie są obsługiwane żadne z tych wyglądów w postaci wartości dziesiętnych.
Skonfigurowanie kolumny appearance (wygląd) na wartość spinner (pokrętło) powoduje, że pytanie typu decimal (wartość dziesiętna) jest wyświetlane z przyciskami służącymi do zwiększania lub zmniejszania ostatniej cyfry o jeden. Trzymanie wybranego przycisku powoduje wielokrotne zwiększanie/zmniejszanie wartości do chwili zwolnienia przycisku.
Gdy w celu zdefiniowania liczby miejsc dziesiętnych w pytaniu używana jest wartość domyślna, pokrętło dostosowuje się do tej wartości. Poniżej znajdują się przykłady tego, jak pokrętło obsługuje różne wartości dziesiętne:
- 1,0 zwiększa się do 1,1; 1,2; 1,3; 1,4
- 3,07 zwiększa się do 3,08; 3,09; 3,10; 3,11
- 2,000000 zwiększa się do 2,000001; 2,000002; 2,000003
Skonfigurowanie kolumny appearance (wygląd) na numbers (liczby) powoduje, że pytanie typu decimal (wartość dziesiętna) jest wyświetlane razem z niestandardową klawiaturą numeryczną umożliwiającą wprowadzenie wartości. Na klawiaturze znajduje się także przycisk służący do przypisywania do wartości dodatniego lub ujemnego znaku.
Skonfigurowanie kolumny appearance (wygląd) na calculator (kalkulator) powoduje, że wyróżnione pytanie typu decimal (wartość dziesiętna) jest wyświetlane razem z niestandardową klawiaturą kalkulatora umożliwiającą wprowadzenie i zmodyfikowanie wartości.
Skonfigurowanie kolumny appearance (wygląd) na thousands-sep (separator tysięcy) powoduje, że odpowiedź na pytanie typu decimal (wartość dziesiętna) jest wyświetlana z separatorami tysięcy. Nie dotyczy to wartości przesłanej w odpowiedzi na ankietę, a jedynie wartości wyświetlanej w aplikacji. Separatory są konfigurowane zgodnie z ustawieniami regionalnymi urządzenia i stosowane tylko podczas otwierania ankiety w folderach Wersje robocze, Skrzynka nadawcza, Skrzynka odbiorcza lub Wysłane albo gdy odpowiedź jest wypełniana przez wartość domyślną lub obliczenie. Separatory tysięcy nie są wyświetlane podczas ręcznego wprowadzania wartości.
