Uruchamianie aplikacji terenowej

Można utworzyć łącza do aplikacji otwierające aplikację terenową Survey123 z poziomu innej aplikacji, okna podręcznego mapy internetowej lub prostego hiperłącza podanego w wiadomości e-mail czy witrynie internetowej. Używając niestandardowego schematu adresu URL, można uruchomić aplikację z poziomu przeglądarki internetowej. Łącze do aplikacji Survey123 pozwala uruchomić ją z poziomu innej aplikacji w systemie Android lub iOS. Parametry adresu URL umożliwiają dostosowanie sposobu otwierania aplikacji terenowej — na przykład wczytanie określonej ankiety, ustawienie współrzędnych domyślnej lokalizacji na mapie, a także wstępne wprowadzenie odpowiedzi na pytania przez podanie wartości lub przekazanie atrybutów danych z okna podręcznego mapy internetowej.

Łącze w przeglądarce internetowej w systemie Windows

Możliwe jest utworzenie łącza pozwalającego na otwarcie aplikacji terenowej, którą można osadzić w innej aplikacji. To samo łącze można również wprowadzić w przeglądarce internetowej w celu jego przetestowania.

Notatka:

Po utworzeniu łącza można zastąpić ciąg znakowy arcgis-survey123:// adresem https://survey123.arcgis.app jako łączem do aplikacji Survey123 używanej w systemie iOS lub Android.

Poniżej opisano etapy tworzenia niestandardowego schematu adresów URL i użycia go w przeglądarce internetowej dla komputerów stacjonarnych:

  1. Wpisz na pasku adresu przeglądarki arcgis-survey123://.

    Aplikacja terenowa Survey123 zostanie otwarta (lub zostanie wyświetlona prośba o jej otwarcie).

    Notatka:

    Aby uruchomić i pobrać ankietę z określonego portalu, dołącz parametr adresu URL portalu, na przykład arcgis-survey123://?portalUrl=host.domain.com/webadaptor (gdzie host, domain i webadaptor należy zastąpić informacjami o danym portalu).

  2. Można dodać unikalne odwołanie do ankiety i umieścić je w adresie URL:
    1. Określ identyfikator elementu ankiety, która ma zostać otwarta.
      Notatka:

      Jest to ciąg znakowy używany przez usługę ArcGIS Online do jednoznacznej identyfikacji ankiety (można go znaleźć w adresie URL elementu formularza w usłudze ArcGIS Online). Jeśli na przykład adresem URL ankiety jest https://exampleurl.maps.arcgis.com/home/item.html?id=36ff9e8c13e042a58cfce4ad87f55d19, identyfikator elementu formularza to 36ff9e8c13e042a58cfce4ad87f55d19.

    2. Dołącz ankietę do adresu URL, używając instrukcji ?itemID= z identyfikatorem elementu formularza na końcu adresu URL.
    Adres URL powinien być podobny do następującego:
    arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19

    Podczas testowania ten adres URL powinien otworzyć aplikację terenową Survey123 i spowodować natychmiastowe przejście do ankiety.

    Notatka:

    Jeśli ankiety nie ma jeszcze na urządzeniu, zostanie na nie pobrana.

  3. Aby dodać wstępnie zdefiniowane odpowiedzi na pytania, dodaj w adresie URL odniesienie do pola, używając jego nazwy z obiektu XLSForm (nie jego etykiety). Aby na przykład wypełnić pole Surname (Nazwisko), wpisz &field:Surname= oraz konkretną wartość.

    Symbol & jest separatorem parametrów, a ciąg znakowy field: odnosi się do nazwy pytania, które należy wypełnić.

    Adres URL powinien być podobny do następującego:
    arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser

    Teraz można użyć tego adresu URL do otwarcia aplikacji terenowej Survey123 i ankiety, jak również wypełnienia danego pytania zdefiniowaną odpowiedzią. W jednym adresie URL ankiety można wypełnić wiele pytań. W nazwach pól rozróżniane są małe i wielkie litery.

  4. Aby zdefiniować lokalizację konkretnego punktu geograficznego w ankiecie, dodaj jego współrzędne w adresie URL:
    • Wpisz ciąg znakowy &center=, a następnie współrzędne.
    • Wpisz współrzędne w postaci szerokości i długości geograficznej w stopniach dziesiętnych, rozdzielając je pojedynczym przecinkiem.
    • Opcjonalnie dodaj wysokość w metrach dziesiętnych jako trzecią wartość, także oddzielając ją pojedynczym przecinkiem.

    Ostateczny adres URL powinien być podobny do następującego:

    arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser&center=37.8199,-122.4783,20

    Taki adres URL spowoduje otwarcie aplikacji terenowej Survey123 i wybranej ankiety oraz wypełnienie pytania tekstowego i określenie nowej lokalizacji domyślnej w pytaniu typu geopoint (punkt geograficzny).

    Atrybuty pól można przekazywać do aplikacji Survey123 z okna podręcznego mapy internetowej ArcGIS, co zapewnia integrację z dowolną aplikacją firmy Esri używającą okien podręcznych na mapach internetowych. Tej funkcji można użyć do wypełnienia pola w aplikacji Survey123 wartością atrybutu obiektu, zamiast ustawiania wartości przez podanie nazwy atrybutu ujętej w nawiasy klamrowe.

  5. Otwórz mapę internetową i wybierz opcję Okna podręczne dla jednej z warstw. Wybierz Dodaj zasoby i wybierz opcję Tekst. Podaj tekst wyświetlany dla łącza i kliknij przycisk Łącze, aby wprowadzić wartość Adres URL łącza.

    Skonfiguruj łącze do schematu adresów URL w oknie podręcznym.

    Ten adres URL powoduje wypełnienie pola nazwiska zawartością atrybutu name (nazwa) wybranego obiektu zamiast ustawiania wartości:

    arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname={name}

    Ten adres URL powoduje wypełnienie pola hydrantGlobalID globalnym identyfikatorem wybranego hydrantu:

    arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:hydrantGlobalID={globalid}

    Notatka:

    Domyślnie z okna podręcznego na mapie internetowej można przekazywać tylko wartości do pytań typu select one (wybierz jedną) lub select multiple (wybierz wiele), jeśli nazwa i etykieta odpowiedniej możliwości wyboru są takie same. Jeśli nazwy i etykiety na liście możliwości wyboru różnią się, odpowiednią wartość można przesłać, używając funkcji DomainCode lub UrlEncode w wyrażeniu ArcGIS Arcade w oknie podręcznym.

    Nie można wypełniać pytań w powtórzeniach.

Tworzenie łącza w innej aplikacji w systemie iOS lub Android

Można utworzyć łącze pozwalające na otwarcie aplikacji Survey123 i zarejestrowanie ankiety. Takiego łącza można używać w aplikacjach ArcGIS. Poniżej opisano procedurę tworzenia łącza do aplikacji Survey123 i używania go w oknie podręcznym mapy internetowej. To łącze wprowadza się w oknie podręcznym mapy internetowej w instytucji ArcGIS. Łącze można przetestować w przeglądarce internetowej (w podobny sposób jak w poprzedniej sekcji) na urządzeniu z systemem iOS lub Android.

  1. Otwórz mapę internetową, która będzie wyświetlana na urządzeniu i dla jednej z warstw wybierz opcję Okna podręczne.
  2. Wybierz opcję Dodaj zasoby, a następnie opcję Tekst.
  3. Wpisz Uruchom aplikację Survey123, wyróżnij ten tekst i kliknij przycisk Łącze, aby wprowadzić adres URL łącza. Wpisz https://survey123.arcgis.app i kliknij przycisk OK.
    1. Otwórz mapę internetową na urządzeniu przenośnym z poziomu przeglądarki lub aplikacji ArcGIS.
    2. Wybierz obiekt i kliknij łącze Uruchom aplikację Survey123 w oknie podręcznym, aby otworzyć aplikację Survey123.
  4. Aby dołączyć ankietę do adresu URL, użyj instrukcji ?itemID= z identyfikatorem elementu formularza na końcu adresu URL.
    Adres URL powinien być podobny do następującego:
    https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19

    Podczas testowania ten adres URL powinien otworzyć aplikację terenową Survey123 i spowodować natychmiastowe przejście do ankiety.

    Notatka:

    Jeśli ankiety nie ma jeszcze na urządzeniu, zostanie na nie pobrana.

  5. Aby dodać wstępnie zdefiniowane odpowiedzi na pytania, dodaj w adresie URL odniesienie do pola, używając jego nazwy z obiektu XLSForm (nie jego etykiety). Aby na przykład wypełnić pole Surname (Nazwisko), wpisz &field:Surname= oraz konkretną wartość.

    Symbol & jest separatorem parametrów, a ciąg znakowy field: odnosi się do nazwy pytania, które należy wypełnić.

    Adres URL powinien być podobny do następującego:
    https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser

    Teraz można użyć tego adresu URL do otwarcia aplikacji terenowej Survey123 i ankiety, jak również można wypełnić dane pytanie zdefiniowaną odpowiedzią. W jednym adresie URL ankiety można wypełnić wiele pytań. W nazwach pól rozróżniane są małe i wielkie litery.

  6. Aby zdefiniować lokalizację konkretnego punktu geograficznego w ankiecie, dodaj jego współrzędne w adresie URL:
    • Wpisz ciąg znakowy &center=, a następnie współrzędne.
    • Wpisz współrzędne w postaci szerokości i długości geograficznej w stopniach dziesiętnych, rozdzielając je pojedynczym przecinkiem.
    • Opcjonalnie dodaj wysokość w metrach dziesiętnych jako trzecią wartość, także oddzielając ją pojedynczym przecinkiem.

    Ostateczny adres URL powinien być podobny do następującego:

    https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser&center=37.8199,-122.4783,20

    Taki pełny adres URL powoduje otwarcie aplikacji terenowej Survey123 i wybranej ankiety oraz wypełnienie pytania tekstowego i określenie nowej lokalizacji domyślnej w pytaniu typu geopoint (punkt geograficzny).

Parametry adresu URL uruchamiania aplikacji terenowej

Następujące parametry umożliwiają dostosowanie sposobu otwierania aplikacji terenowej:

ParametrOpisTyp

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

Adres URL portalu, w którym hostowany jest element ankiety.

Przykład:

portalUrl=https://myorg.arcgis.com

Ciąg znakowy

itemID

Formularz do otwarcia.

Przykład:

itemID=36ff9e8c13e042a58cfce4ad87f55d19

UUID

download

Powoduje automatyczne pobranie ankiety, gdy urządzenie jest w trybie online. Wartość domyślna to true.

Przykład:

download=false

Wartość logiczna

action

Określa sposób otwierania ankiety. Obsługiwane wartości to collect (domyślna), edit, view i copy.

Przykład:

action=edit

Ciąg znakowy

folder

Określa folder, który ma być wyświetlany, gdy ankieta zostanie otwarta. Obsługiwane wartości to: inbox, drafts, outbox, sent i * (folder przeglądu).

Dodaj parametr filter do adresu URL, aby przefiltrować ankiety w określonym folderze. Określ folder=* i parametr filter, aby przefiltrować ankiety we wszystkich folderach i wyświetlić je w folderze przeglądu.

Przykłady:

folder=inbox
folder=*&filter=lake

Ciąg znakowy

callback

Adres URL, pod który należy wrócić po wykonaniu działania w formularzu (takiego jak przesłanie, przeniesienie do wersji roboczych, anulowanie lub zakończenie).

Przykład:

callback=https://quickcapture.arcgis.app

Adres URL

callback:status

Określa status ankiety po aktywowaniu wywołania zwrotnego. Obsługiwane wartości statusu to cancel, draft, submit i close. Statusu close można używać tylko z opcją action=view.

Przykład:

callback:draft=https://quickcapture.arcgis.app

Ciąg znakowy

filter

Powoduje przefiltrowanie istniejących ankiet na urządzeniu, które są zgodne z ciągiem znakowym znajdującym się w polu Nazwa instancji albo innym podanym. Domyślnie filtrowana jest skrzynka odbiorcza. Dodaj parametr folder do adresu URL, aby przefiltrować ankiety w określonym folderze.

Jeśli nazwa instancji została zdefiniowana, należy podać ciąg znakowy, który reprezentuje pełną nazwę instancji albo podciąg nazwy instancji. Poniższe przykłady pokazują, jak należy filtrować wszystkie rekordy z pełną nazwą instancji Klauser lub wszystkie rekordy w folderze Wersje robocze zawierające słowo lake w nazwie instancji.

Przykłady:

filter=Klauser
filter=lake&folder=drafts

Jeśli nie zdefiniowano nazwy instancji lub aby przefiltrować według pola, które nie jest częścią nazwy instancji, należy podać zarówno nazwę pola, jak i wartość pola w formacie filter=field:fieldname:fieldvalue. Przy użyciu pola można filtrować tylko całe wartości pól. Poniższe przykłady pokazują, jak należy filtrować rekordy, w których typem akwenu jest River (rzeka) lub dla których numerem stacji jest 5171.

Przykłady:

filter=field:waterbodytype:River
filter=field:ws_stationnumber:5171

Ciąg znakowy

update

Powoduje odświeżenie folderu Skrzynka odbiorcza i podjęcie próby wysłania ankiet do opcji Skrzynka nadawcza. Jeśli w adresie URL uwzględnione są parametry update oraz filter, aktualizacja powoduje odświeżenie zasobów folderu przed zastosowaniem filtru (co jest wykonywane na istniejących ankietach na urządzeniu). Wartość domyślna to false.

Przykład:

update=false

Wartość logiczna

q:queryparameter

Powoduje wysłanie do warstwy obiektowej zapytania dotyczącego istniejącego rekordu. Umożliwia to pobieranie zasobów, których nie ma jeszcze na urządzeniu.

Przykłady:

q:where=ws_stationnumber=5171
q:where=waterbodytype='Lake'
q:globalId=1d392670-33e2-456d-8435-7fad3abd8bb9

Ciąg znakowy