Integracja z innymi aplikacjami

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ć łączeWzorzec adresu URL

Aplikacja internetowa

przeglądarka internetowa

Formularz ankiety wg identyfikatora:

https://survey123.arcgis.com/share/ID

Aplikacja terenowa

Android i iOS

Łącze do aplikacji Survey123:

https://survey123.arcgis.app

Windows, Android, wybrana grupa aplikacji w systemie iOS

Niestandardowy schemat adresów URL:

arcgis-survey123://

Survey123 Connect

Windows

Niestandardowy schemat adresów URL:

arcgis-survey123connect://

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.