Aplikację ArcGIS Survey123 można integrować z innymi aplikacjami za pomocą łączy otwierających aplikację internetową lub terenową Survey123, aplikację Survey123 Connect lub inną aplikację. Można na przykład utworzyć łącza do aplikacji uruchamiające i otwierające aplikację terenową Survey123 z poziomu innej aplikacji firmy Esri, podręcznej mapy internetowej lub prostego hiperłącza podanego w wiadomości e-mail czy witrynie internetowej. Adres URL może powodować automatyczne pobranie i otwarcie ankiety do edycji w aplikacji Survey123 Connect. Można też używać łączy do innych aplikacji z poziomu aplikacji Survey123, na przykład obsługując aplikacje ArcGIS QuickCapture czy ArcGIS Field Maps.
Wzorce adresów URL podane w tabeli ułatwiają tworzenie łączy dostępu z poziomu przeglądarki internetowej lub innej aplikacji.
Co uruchomić | Gdzie umieścić łącze | Wzorzec adresu URL |
---|---|---|
Aplikacja internetowa | przeglądarka internetowa | Formularz ankiety wg identyfikatora:
|
Aplikacja terenowa | Android i iOS | Łącze do aplikacji Survey123:
|
Windows, Android, wybrana grupa aplikacji w systemie iOS | Niestandardowy schemat adresów URL:
| |
Survey123 Connect | Windows | Niestandardowy schemat adresów URL:
|
Inna aplikacja | Formularz ankiety | Łącze w aplikacji Survey123: zależnie od aplikacji |
Poniżej podano przykładowe sposoby otwierania określonej ankiety przy użyciu tych wzorców adresów URL:
- https://survey123.arcgis.com/share/36ff9e8c13e042a58cfce4ad87f55d19
- https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19
- arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19
- arcgis-survey123connect://?portalUrl=https://www.arcgis.com&itemID=36ff9e8c13e042a58cfce4ad87f55d19
Łącza do aplikacji Survey123 są zgodne z wymaganiami sklepów App Store oraz Google Play, co umożliwia łączenie z większą liczbą aplikacji i zapewnia obsługę skróconych łączy, które łatwiej jest udostępniać.
Łączy schematu niestandardowych adresów URL nie można skracać i może być trudno otworzyć je w systemie Android. Należy rozważyć przedstawianie łączy schematu niestandardowych adresów URL w postaci hiperłączy podobnych do następujących:
<a href="arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19">Open survey</a>
Parametry URL
Na końcu łączy można dodawać parametry adresów URL, aby dostosowywać sposób otwierania aplikacji. Można na przykład ustawić lokalizację domyślną określonego punktu geograficznego lub wprowadzić informacje w pytaniu tekstowym.
Parametry adresu URL zaczynają się od znaku ? i są oddzielane znakiem &. Poniższy przykład przedstawia schemat niestandardowych adresów URL, w którym pierwszy parametr (itemID) zaczyna się od znaku ?, a każde z kolejnych pól parametrów (color_1 i color_2) jest oddzielone znakiem &.
arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:color_1=red&field:color_2=blue
Więcej przykładowych adresów URL i ich obsługiwanych parametrów znajduje się w tematach Uruchamianie aplikacji internetowej, Uruchamianie aplikacji terenowej, Uruchamianie aplikacji Survey123 Connect i Uruchamianie innych aplikacji z poziomu aplikacji Survey123.
Notatka:
Przed użyciem łącza zawierającego parametry do uruchomienia ankiety w aplikacji terenowej zalecane jest, aby aplikacja była już zainstalowana na urządzeniu. Więcej informacji zawiera temat Instalowanie aplikacji terenowej Survey123.
Kodowanie w adresie URL
Mimo że niezakodowane parametry adresu URL działają w niektórych środowiskach, zaleca się kodowanie parametrów adresu URL. Kodowanie zastępuje nieprawidłowe znaki ich odpowiednikami szesnastkowymi poprzedzonymi znakiem procentu (%).
Na przykład poniżej przedstawiono łącze do aplikacji Survey123 z niezakodowanymi parametrami określającymi wywołanie zwrotne powodujące powrót do konkretnego projektu w aplikacji QuickCapture:
https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https://quickcapture.arcgis.app?itemID=867895a71a1840399476fc717e76bb43
Poniżej przedstawiono ten sam adres URL z zakodowanymi parametrami:
https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https%3A%2F%2Fquickcapture.arcgis.app%3FitemID=867895a71a1840399476fc717e76bb43
Nie należy kodować znaku równości określającego przerwę między kluczem a jego wartością.
Wskazówka:
Jednym ze sposobów tworzenia parametrów zakodowanych jest użycie języka ArcGIS Arcade. Funkcja UrlEncode umożliwia zdefiniowanie zbioru par klucz-wartość reprezentujących poszczególne parametry oraz wygenerowanie adresu URL z odpowiednim kodowaniem.
Autor ankiety może także ukryć parametry adresu URL, dzięki czemu dane poufne nie będą widoczne w adresie URL. W takim przypadku, tworząc adres URL do użycia w aplikacji internetowej, należy dołączyć parametr encodeUrlParams=true. Więcej informacji zawiera temat Parametry adresu URL do otwierania aplikacji internetowej.