Aplikację ArcGIS Survey123 można integrować z innymi aplikacjami za pomocą łączy uruchamiających aplikację określonego komponentu. Można na przykład utworzyć łącza do aplikacji uruchamiające i otwierające aplikację Survey123 Mobile 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.
Wskazówka:
Aplikacja Survey123 Mobile otwiera łącza dla trzech aplikacji: Survey123 Mobile, aplikacji terenowej Survey123 i aplikacji QuickCapture. Jeśli dowolne z tych łączy jest uruchamiane z poziomu aplikacji Survey123 Mobile (za pomocą opcji Użyj łącza, Zeskanuj kod QR lub łącza znajdującego się w obrębie ankiety lub projektu QuickCapture), powoduje to jego otwarcie wewnątrz aplikacji Survey123 Mobile. Więcej informacji można znaleźć w sekcji Otwieranie zasobów.
Wzorce adresów URL podane w tabeli ułatwiają tworzenie łączy dostępu z poziomu przeglądarki internetowej lub innej aplikacji. Dołączone przykłady pokazują sposób otwierania określonej ankiety przy użyciu tych wzorców adresów URL:
| Co uruchomić | Gdzie umieścić łącze | Wzorzec adresu URL |
|---|---|---|
| Survey123 Mobile | Android iOS | Łącze do aplikacji Survey1231: Przykład: |
Windows Android iOS2 | Niestandardowy schemat adresu URL3: Przykład: | |
Aplikacja internetowa | przeglądarka internetowa | Formularz ankiety wg identyfikatora: Przykład: |
Aplikacja terenowa | Android iOS | Łącze do aplikacji Survey1231: Przykład: |
Windows Android iOS2 | Niestandardowy schemat adresu URL3: Przykład: | |
| Survey123 Studio | Windows | Niestandardowy schemat adresu URL3: Przykład: |
Survey123 Connect | Windows | Niestandardowy schemat adresu URL3: Przykład: |
Inna aplikacja | Formularz ankiety | Łącze w aplikacji Survey123: zależnie od aplikacji |
1 – Łą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ć.
2 – Na urządzeniach z systemem iOS niestandardowe schematy adresów URL są zatwierdzone tylko dla wybranej grupy aplikacji.
3 – Łączy niestandardowych schematów 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-mobile://?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-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:color_1=red&field:color_2=blueWięcej przykładowych adresów URL i ich obsługiwanych parametrów znajduje się w tematach Uruchamianie aplikacji Survey123 Mobile, Funkcje obiektowe | ArcGIS Arcade | Esri Developer, 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 Survey123 Mobile lub aplikacji terenowej zalecane jest, aby aplikacja była już zainstalowana na urządzeniu. Więcej informacji można znaleźć w temacie Instalacja aplikacji ArcGIS 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-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https://quickcapture.arcgis.app?itemID=867895a71a1840399476fc717e76bb43Poniżej przedstawiono ten sam adres URL z zakodowanymi parametrami:
https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https%3A%2F%2Fquickcapture.arcgis.app%3FitemID=867895a71a1840399476fc717e76bb43Nie 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.