Uruchom aplikację internetową

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&center=37.8199,-122.4783

Aplikacja 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

ParametrOpisTyp

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:

isOrgSignIn=false

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:

center=37.8199,-122.4783,20

Ciąg znakowy

field:fieldname

Powoduje wypełnienie pytań ankiety wartościami pól.

Przykład:

 field:surname=Klauser

Ciąg znakowy

portalUrl

Określa adres URL portalu, w którym hostowany jest element ankiety.

Przykład:

portalUrl=https://myorg.arcgis.com

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:

open=web

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:

hide=header,description,footer,theme

Ciąg znakowy

locale

Powoduje przełączenie języka ankiety. Działa tylko wtedy, gdy ankieta obejmuje wiele języków.

Przykład:

locale=zh-cn

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:

mode=edit&globalId=1d392670-33e2-456d-8435-7fad3abd8bb9

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:

globalId=1d392670-33e2-456d-8435-7fad3abd8bb9

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:

recalculate=field:question1,field:question2

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:

version=latest

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:

token=E60M4Gsc-h4Q8plqQ...

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:

autoReload=3

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:

encodeUrlParams=true

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:

width=1000

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