ArcGIS Survey123 можно интегрировать с другими приложениями, используя ссылки на веб-приложение Survey123, полевое приложение Survey123 Connect .или другое приложение. Например, можно создать ссылки на приложения для запуска и открытия полевого приложения Survey123 из другого приложения Esri, всплывающего окна веб-карты или по обычной гиперссылке в электронном письме или на веб-сайте. Можно использовать URL-адрес, чтобы автоматически загружать и открывать опрос для его редактирования в Survey123 Connect. Вы также можете ссылаться на другие приложения из Survey123, например ArcGIS QuickCapture и ArcGIS Field Maps.
Используйте шаблоны URL-адресов в таблице для создания ссылок для доступа из веб-браузера или другого приложения.
Что запускать | Откуда ссылка | Шаблон URL для использования |
---|---|---|
Веб-приложение | Веб-браузер | Форма опроса по ID:
|
Полевое приложение | Android и iOS | Ссылка на приложение Survey123:
|
Windows, Android, группа приложений для выбора на iOS | Пользовательская схема URL:
| |
Survey123 Connect | Windows | Пользовательская схема URL:
|
Другое приложение | Форма опроса | Ссылка из 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 для открытия веб-приложения.