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 |
|---|---|---|
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: | Całkowite |
| 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 wyrażoną w pikselach. Wpływa to także na inne elementy sterujące w ankiecie, takie jak pola tekstowe. Przykład: | Całkowite |
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