Запуск полевого приложения

Вы можете создать ссылки на приложения для открытия полевого приложения Survey123 из другого приложения, всплывающего окна веб-карты или по гиперссылке в электронном письме или на веб-сайте. Используйте собственную схему URL-адресов для запуска приложения из веб-браузера или используйте ссылку на приложение Survey123 для его запуска из приложения на Android или iOS. Используйте параметры URL-адреса, чтобы настроить способ открытия полевого приложения, например, чтобы загрузить конкретный опрос, задать координаты местоположения на карте по умолчанию и заполнить ответы на вопросы заранее определенными значениями или путем передачи атрибутов данных из всплывающего окна веб-карты.

Ссылка из веб-браузера в Windows

Вы можете создать ссылку для открытия мобильного приложения, которую можно встроить в другое приложение. Этот же URL также можно ввести в веб-браузер для проверки.

Примечание:

После создания ссылки можно заменить arcgis-survey123:// на https://survey123.arcgis.app в ссылке Survey123 для работы в iOS и Android.

Следующие шаги описывают создание пользовательской схемы URL и ее использование в настольном веб-браузере:

  1. Введите arcgis-survey123:// в браузере.

    Полевое приложениеSurvey123 откроется автоматически (или вам будет предложено открыть его).

    Примечание:

    Чтобы запустить и загрузить опрос с конкретного портала, включите параметр URL, к примеру, arcgis-survey123://?portalUrl=host.domain.com/webadaptor (где host, domain и webadaptor надо заменить на информацию о вашем портале).

  2. Добавьте уникальную ссылку на опрос и включите ее в URL.
    1. Определите ID опроса, который вы хотите открыть.
      Примечание:

      Это строка символов, которая используется ArcGIS Online для однозначной идентификации опроса и может быть найдена в URL-адресе вашего элемента формы в ArcGIS Online. Например, если URL опроса - https://exampleurl.maps.arcgis.com/home/item.html?id=36ff9e8c13e042a58cfce4ad87f55d19, ID вашего элемента формы будет 36ff9e8c13e042a58cfce4ad87f55d19.

    2. Включите опрос в URL-адрес, добавив ?itemID= и ID элемента формы в конец URL-адреса.
    URL должен выглядеть примерно так:
    arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19

    Если вы проверите URL, приложение для полевых работ Survey123 должно открываться вместе с опросом.

    Примечание:

    Если его на вашем устройстве еще нет, опрос будет загружен на него.

  3. Включите заранее определенные ответы на вопросы, добавив в URL-адрес ссылку на поле с помощью имени, присвоенного ему в XLSForm (не его подпись). Например, чтобы заполнить поле Фамилия, введите &field:surname= и значение.

    & выступает в качестве разделителя параметров, а field: ссылается на заполняемое имя вопроса.

    URL должен выглядеть примерно так:
    arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser

    Теперь URL можно использовать для открытия полевого приложения Survey123 и опроса, где на указанный вопрос уже будет дан заданный ответ. Вы можете заполнить несколько вопросов в одном URL-адресе опроса. Имена полей чувствительны к регистру.

  4. Задайте местоположение для вопроса Геоточка в опросе, добавив в URL координаты:
    • Для этого введите &center= и координаты.
    • Введите координаты широты и долготы в десятичных градусах, разделенные запятой.
    • Дополнительно добавьте высоту в метрах в качестве третьего значения, которое тоже должно быть отделено запятой.

    Итоговый URL-адрес должны выглядеть примерно так:

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

    Этот URL-адрес теперь открывает полевое приложение Survey123 и выбранный опрос, вводит ответ на текстовый вопрос и указывает новое используемое по умолчанию местоположение для ответа на вопрос Геоточка.

    Атрибуты поля также могут быть переданы в Survey123 из всплывающего окна веб-карты ArcGIS, обеспечив интеграцию с любыми приложениями Esri, использующими всплывающие окна в веб-картах. Эта возможность может использоваться для заполнения полей Survey123 значениями атрибутов объектов, вместо задания значений, с помощью ввода имени атрибута в фигурных скобках.

  5. Откройте веб-карту и выберите Всплывающие окна для одного из слоев. Выберите Добавить ресурс, а затем - Текст. Введите текст, который будет отображаться для ссылки, и нажмите на кнопку Ссылка, чтобы ввести значение URL-адрес ссылки.

    Задайте ссылку на URL-схему во всплывающем окне.

    В URL-адресе поле фамилии заполняется содержимым атрибута имени выбранного объекта, вместо задания значения.

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

    Этот URL заполнит поле hydrantGlobalID значениями глобального ID выбранного гидранта:

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

    Примечание:

    По умолчанию значения могут быть переданы только для вопросов типа выбрать один или выбрать несколько из всплывающего окна веб-карты, если имя и надпись соответствующего выбора идентичны. Если имена и надписи в списке выбора различаются, то для передачи желаемого значения можно использовать DomainCode или UrlEncode функции в ArcGIS Arcade выражении во всплывающем окне.

    Вопросы с повторами не могут быть заполнены.

Переход из других приложений в iOS или Android

Вы должны создать ссылку, работающую в других приложениях ArcGIS, чтобы открыть Survey123 и выполнить захват опроса. Перечисленными ниже действиями описывается процесс создания ссылки на приложение Survey123 и ее использования во всплывающем окне веб-карты. Эта ссылка вводится во всплывающее окно веб-карты в вашей организации ArcGIS. Вы также можете проверить эти ссылки в веб-браузере (выполнив действия, аналогичные описанным в предыдущем разделе) на устройстве iOS или Android.

  1. Откройте веб-карту, которая будет просматриваться на устройстве, и выберите Всплывающие окна для одного из слоев.
  2. Выберите Добавить ресурс, а затем - Текст.
  3. Введите Запустить Survey123, выделите этот текст и щелкните кнопку Ссылка, чтобы ввести URL гиперссылки. Введите https://survey123.arcgis.app и щелкните ОК.
    1. Откройте веб-карту на мобильном устройстве из браузера или приложения ArcGIS.
    2. Выберите объект и щелкните ссылку Запустить Survey123 во всплывающем меню, чтобы открыть Survey123.
  4. Чтобы включить опрос в URL-адрес, добавьте ?itemID= и ID элемента формы в конце URL-адреса.
    URL должен выглядеть примерно так:
    https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19

    Если вы проверите URL, приложение для полевых работ Survey123 должно открываться вместе с опросом.

    Примечание:

    Если его на вашем устройстве еще нет, опрос будет загружен на него.

  5. Включите заранее определенные ответы на вопросы, добавив в URL-адрес ссылку на поле с помощью имени, присвоенного ему в XLSForm (не его подпись). Например, чтобы заполнить поле Фамилия, введите &field:surname= и значение.

    & выступает в качестве разделителя параметров, а field: ссылается на заполняемое имя вопроса.

    URL должен выглядеть примерно так:
    https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser

    Теперь URL можно использовать для открытия полевого приложения Survey123 и опроса, где на указанный вопрос уже будет дан заданный ответ. Вы можете заполнить несколько вопросов в одном URL-адресе опроса. Имена полей чувствительны к регистру.

  6. Задайте местоположение для вопроса Геоточка в опросе, добавив в URL координаты:
    • Для этого введите &center= и координаты.
    • Введите координаты широты и долготы в десятичных градусах, разделенные запятой.
    • Дополнительно добавьте высоту в метрах в качестве третьего значения, которое тоже должно быть отделено запятой.

    Итоговый URL-адрес должны выглядеть примерно так:

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

    Этот URL-адрес теперь открывает полевое приложение Survey123 и выбранный опрос, вводит ответ на текстовый вопрос и указывает новое используемое по умолчанию местоположение для ответа на вопрос Геоточка.

Параметры URL для запуска полевого приложения

Следующие параметры могут использоваться для настройки способа открытия полевого приложения:

ПараметрОписаниеТип

center

Центрирует карту относительно известных значений широты, долготы и, дополнительно, высоты.

Пример:

center=37.8199,-122.4783,20

Строка

field:fieldname

Заполняет вопросы опроса значениями поля.

Пример:

field:surname=Klauser

Строка

portalUrl

URL портала, на котором размещен элемент опроса.

Пример:

portalUrl=https://myorg.arcgis.com

Строка

itemID

Открываемая форма.

Пример:

itemID=36ff9e8c13e042a58cfce4ad87f55d19

UUID

download

Автоматически загружает опрос, когда устройство находится в сети. По умолчанию – true.

Пример:

download=false

Boolean

action

Определяет порядок открытия опроса. Поддерживаются значения collect (по умолчанию), edit, view, и copy.

Пример:

action=edit

Строка

folder

Указывает папку, которая будет отображаться при открытии опроса. Поддерживаемые значения: inbox, drafts, outbox, sent и * (папка overview).

Добавьте параметр filter к URL-адресу, чтобы отфильтровать опросы в указанной папке. Укажите параметры folder=* и filter для фильтрации опросов во всех папках и отображения их в папке overview.

Примеры:

folder=inbox
folder=*&filter=lake

Строка

callback

URL, возвращаемый, когда выполняется форма действия (к примеру, отправка, перемещение в черновики, отмена или выход).

Пример:

callback=https://quickcapture.arcgis.app

URL

callback:status

Задает статус опроса при активации вызова. Поддерживаемые значения cancel, draft, submit и close. Статус close можно использовать только при action=view.

Пример:

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

Строка

filter

Фильтрует существующие опросы на устройстве, которые соответствуют строке, найденной либо в имени экземпляра, либо в заданном поле. По умолчанию фильтрует папку Входящие. Добавьте параметр folder к URL-адресу, чтобы отфильтровать опросы в указанной папке.

Когда будет задано имя экземпляра, укажите строку, представляющую либо полное имя экземпляра, либо подстроку имени экземпляра. В следующих примерах показано, как отфильтровать все записи с полным именем экземпляра Klauser или все записи в папке Черновики, содержащие слово lake в названии экземпляра.

Примеры:

filter=Klauser
filter=lake&folder=drafts

Если имя экземпляра не определено или для фильтрации по полю, которое не является частью имени экземпляра, укажите как имя поля, так и значение поля в формате filter=field:fieldname:fieldvalue. С помощью этого поля можно отфильтровать только целые значения поля. В следующих примерах показано, как отфильтровать записи, у которых тип водного объекта - River или номер станции - 5171.

Примеры:

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

Строка

update

Обновляет содержимое Входящих и пытается отправлять опросы в Исходящие. Если в URL-адрес включены update и filter обновление обновит содержимое папки перед применением фильтра (который выполняется для существующих опросов на устройстве). По умолчанию – false.

Пример:

update=false

Boolean

q:queryparameter

Запрашивает существующую запись в векторном слое. Используется для получения ресурсов, которые еще не находятся на устройстве.

Примеры:

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

Строка