Aplikacja internetowa Survey123 może przyjmować parametry w tym samym formacie co aplikacja terenowa. Warto pamiętać, że identyfikator elementu dla ankiety jest w jej przypadku fragmentem ścieżki adresu URL, a nie parametrem adresu URL, tak jak w przypadku innych łączy używanych do otwierania ankiet. Dodając parametry do tego adresu URL, należy oddzielić znakiem zapytania identyfikator elementu ankiety zawarty w ścieżce od pierwszego parametru, a następnie rozdzielić kolejne parametry znakami &. Następujący przykładowy adres URL przekazuje parametry nazwiska i współrzędnych do ankiety w aplikacji internetowej Survey123:
https://survey123.arcgis.com/share/36ff9e8c13e042a58cfce4ad87f55d19?field:surname=Klauser¢er=37.8199,-122.4783Aplikacja internetowa Survey123 obsługuje również szereg parametrów, których nie obsługuje aplikacja terenowa Survey123. Te parametry są związane z prezentacją ankiety w przeglądarce. W poniższej tabeli podano parametry adresów URL i przykłady dostosowywania sposobu otwierania aplikacji.
Notatka:
Jeśli wartość parametru zawiera spacje, znaki plus (+) lub inne znaki specjalne, należy je zakodować przy użyciu znaku procentu. Więcej informacji zawiera temat Kodowanie w adresie URL.
Parametry adresu URL uruchamiania aplikacji internetowej
| Parametr | Opis | Typ |
|---|---|---|
signIn | W przypadku ankiet publicznych powoduje wyświetlenie przycisku logowania lub wymaga od użytkowników, aby się zalogowali. Domyślnie aplikacja internetowa nie udostępnia użytkownikom metody logowania się do ankiet publicznych, ale ankiety publiczne mogą zawierać funkcje działające tylko wtedy, gdy użytkownicy są zalogowani. Przykładem jest użycie obliczenia do wyodrębnienia adresu e-mail zalogowanego użytkownika. Prawidłowe wartości to show, która powoduje wyświetlenie przycisku logowania na pasku nawigacyjnym u góry aplikacji internetowej, oraz require, która wymaga od użytkowników zalogowania się, przekierowując ich do strony logowania. Przykład: | Ciąg znakowy |
isOrgSignIn | Używa specyficznej dla instytucji strony logowania. Domyślnie aplikacja Survey123 używa strony logowania specyficznej dla instytucji, ale w przypadku udostępniania ankiet więcej niż jednej instytucji preferowane może być użycie strony logowania usługi ArcGIS Online. Ustaw ten parametr jako false, aby używać strony logowania usługi ArcGIS Online. Przykład: | Wartość logiczna |
center | Powoduje wyśrodkowanie mapy w punkcie o znanej szerokości i długości geograficznej, a opcjonalnie także wysokości. Przykład: | Ciąg znakowy |
field:fieldname | Powoduje wypełnienie pytań ankiety wartościami pól. Przykład: | Ciąg znakowy |
portalUrl | Określa adres URL portalu, w którym hostowany jest element ankiety. Przykład: | Ciąg znakowy |
| open | Określa aplikację służącą do otwierania ankiety. Prawidłowe wartości to: web — powoduje otwarcie ankiety w aplikacji internetowej (domyślna), native — powoduje otwarcie ankiety w aplikacji terenowej, jeśli jest ona zainstalowana oraz menu — powoduje otwarcie strony internetowej w celu określenia aplikacji, w której zostanie otwarta ankieta. Przykład: | Ciąg znakowy |
| hide |
Ukrywa elementy ankiety w aplikacji internetowej. Ten parametr akceptuje wiele wartości rozdzielanych przecinkami. Prawidłowe wartości to navbar (pasek u góry ankiety zawierający opcje logowania, wylogowania i zmiany języka), header, description, footer, submit, theme i leaveDialog (komunikat ostrzeżenia wyświetlany, gdy użytkownik opuszcza lub zamyka stronę). Można też użyć parametru field:fieldName w celu ukrycia pytania, grupy, strony lub powtórzenia, podając konkretną nazwę zamiast wartości fieldName. Nie można ukrywać poszczególnych pytań w powtórzeniach. Przykład: | Ciąg znakowy |
| locale | Powoduje przełączenie języka ankiety. Działa tylko wtedy, gdy ankieta obejmuje wiele języków. Przykład: | Ciąg znakowy |
| mode | Konfiguruje tryb aplikacji internetowej. Prawidłowe wartości to: edit, która konfiguruje ankietę do edycji istniejącego wpisu, a nie tworzenia nowego, view, która otwiera istniejący wpis w trybie tylko do odczytu i copy, która tworzy ankietę wypełnianą zawartością podanego wpisu. Gdy używany jest ten parametr, należy także podać parametr globalId. Przykład: | Ciąg znakowy |
| globalId | Określa rekord ankiety wczytywany do formularza. Prawidłowymi wartościami są identyfikatory globalne istniejących rekordów ankiety. W nazwie tego parametru rozróżniana jest wielkość liter. Przykład: | Ciąg znakowy |
recalculate | Można używać tylko z opcją mode=edit. Wymusza przeliczenie podanych pytań po wczytaniu ankiety bez użycia przycisku Przelicz. Przykład: | Ciąg znakowy |
| version | Konfiguruje wersję aplikacji internetowej, która ma zostać użyta. Jedyną prawidłową wartością jest latest. Powoduje ona, że najnowsza wersja aplikacji internetowej będzie używana nawet wtedy, gdy w ankiecie zablokowano wersję tej aplikacji. Przykład: | Ciąg znakowy |
| token | Przekazuje prawidłowy token dla ankiety. Dzięki temu parametrowi respondenci mogą odpowiadać na ankietę, która wymaga dostępu do konta ArcGIS, bez konieczności logowania się. Przykład: | Ciąg znakowy |
autoReload | Ponownie wczytuje ankietę po przesłaniu. Podaj czas opóźnienia (w sekundach), który musi upłynąć przed ponownym wczytaniem ankiety. Poprzednia nazwa to autoRefresh. Parametr autoRefresh jest obsługiwany w celu zapewnienia kompatybilności wstecznej. Przykład: | Liczba całkowita |
| encodeUrlParams | Powoduje zasłonięcie parametrów adresu URL. Wynikowy adres URL będzie w zamian zawierać parametr code reprezentujący wszystkie zakodowane parametry, parametry dołączone poza tym parametrem code zostaną zignorowane. Przykład: | Wartość logiczna |
width | Konfiguruje szerokość ankiety w pikselach lub jako ułamek szerokości ekranu. Wartość większa niż 1 konfiguruje szerokość w pikselach. Jeśli wartość piksela jest mniejsza niż szerokość ekranu, używana jest szerokość ekranu. Wartość z zakresu od 0 do 1 powoduje skonfigurowanie szerokości formularza w postaci ułamka szerokości ekranu. Wpływa to także na inne elementy sterujące w ankiecie, takie jak pola tekstowe i może poprawić sposób wyświetlania przez aplikację internetową siatek stałych oraz dynamicznych. Przykłady: | Ciąg znakowy |
Notatka:
Parametr field:fieldname obsługuje pytania typu geopoint (punkt geograficzny), geotrace (ślad geograficzny) i geoshape (kształt geograficzny) w aplikacji internetowej. W pytaniach typu geopoint (punkt geograficzny) podaj szerokość geograficzną, długość geograficzną i wysokość (opcjonalnie), rozdzielając te wartości spacjami. W pytaniach typu geotrace (ślad geograficzny) i geoshape (kształt geograficzny) podaj szerokość geograficzną i długość geograficzną dla każdego wierzchołka, rozdzielając te wartości spacjami (każda para współrzędnych powinna być rozdzielona średnikiem). Ten przykład ilustruje pytanie typu geoshape (kształt geograficzny):
field:geoshape=-37.842156723211474 144.95942945338243;-37.83554486071995 144.9726235713864;-37.85681405373047 144.98240735651922;-37.85954045531896 144.97715349053766