Интеграция с другими приложениями

ArcGIS Survey123 можно интегрировать с другими приложениями, используя ссылки на веб-приложение Survey123, полевое приложение Survey123 Connect .или другое приложение. Например, можно создать ссылки на приложения для запуска и открытия полевого приложения Survey123 из другого приложения Esri, всплывающего окна веб-карты или по обычной гиперссылке в электронном письме или на веб-сайте. Можно использовать URL-адрес, чтобы автоматически загружать и открывать опрос для его редактирования в Survey123 Connect. Вы также можете ссылаться на другие приложения из Survey123, например ArcGIS QuickCapture и ArcGIS Field Maps.

Используйте шаблоны URL-адресов в таблице для создания ссылок для доступа из веб-браузера или другого приложения.

Что запускатьОткуда ссылкаШаблон URL для использования

Веб-приложение

Веб-браузер

Форма опроса по ID:

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

Полевое приложение

Android и iOS

Ссылка на приложение Survey123:

https://survey123.arcgis.app

Windows, Android, группа приложений для выбора на iOS

Пользовательская схема URL:

arcgis-survey123://

Survey123 Connect

Windows

Пользовательская схема URL:

arcgis-survey123connect://

Другое приложение

Форма опроса

Ссылка из Survey123: зависит от приложения

В следующих примерах показывается, как открывать конкретный опрос, используя эти шаблоны 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

Ссылки на приложение Survey123 соответствуют требованиям, установленным App Store и Google Play, позволяют ссылаться на большее количество приложений и поддерживают сокращенные ссылки, которыми легче делиться.

Пользовательские ссылки схем URL нельзя сделать короче, и их может быть трудно открыть на Android. Лучше всего формировать ссылки на пользовательские схемы URL-адресов в виде гиперссылок, показанных ниже:

<a href="arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19">Open survey</a>

Параметры URL

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

Параметры URL начинаются с символа ? и разделяются символом &. В следующем примере показана пользовательская схема URL-адреса, в которой первый параметр (itemID) начинается с символа ?, а все последующие параметры поля (color_1 и color_2) разделены символом &.

arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:color_1=red&field:color_2=blue

Дополнительные примеры URL-адресов и поддерживаемых параметров URL-адресов см. в разделах Запуск веб-приложения, Запуск полевого приложения, Запуск Survey123 Connect и Запуск другого приложения из Survey123.

Примечание:

Прежде чем использовать ссылку, содержащую параметры, для запуска опроса в полевом приложении, рекомендуется, чтобы это приложение было уже установлено на устройстве. Подробнее см. раздел Установка полевого приложения Survey123.

Кодировка URL

Хотя не кодированные параметры URL в некоторых средах работают, рекомендуется выполнять кодирование параметров URL. Кодирование заменяет некорректный символ на символ %, за которым следует его шестнадцатеричный эквивалент.

Например, это ссылка Survey123, использующая вызов для возврата к конкретной веб-карте в QuickCapture с незакодированными параметрами:

https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https://quickcapture.arcgis.app?itemID=867895a71a1840399476fc717e76bb43

Далее показан тот же URL с кодированными параметрами:

https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https%3A%2F%2Fquickcapture.arcgis.app%3FitemID=867895a71a1840399476fc717e76bb43

Знак равенства, который задает разрыв между ключом и его значением, не должен кодироваться.

Подсказка:

Один способ создания кодированных параметров - использование ArcGIS Arcade. Функция UrlEncode позволяет вам задавать набор пар «ключ/значение», отображающих каждый из параметров, и обеспечить подходящее кодирование URL.

Автор опроса также может скрыть параметры URL-адреса, чтобы конфиденциальные данные не были видны в URL-адресе. Для этого при создании URL-адреса, который будет использоваться в веб-приложении, включите параметр encodeUrlParams=true. Более подробно см. раздел Параметры URL для открытия веб-приложения.