ArcGIS Survey123 можно интегрировать с другими приложениями, используя ссылки для запуска специфического компонента приложения. Например, можно создать ссылки на приложения для запуска и открытия Survey123 Mobile из другого приложения Esri, всплывающего окна веб-карты или по обычной гиперссылке в электронном письме или на веб-сайте. Можно использовать URL-адрес, чтобы автоматически загружать и открывать опрос для его редактирования в Survey123 Connect.
Вы также можете ссылаться на другие приложения из Survey123, например ArcGIS QuickCapture и ArcGIS Field Maps.
Подсказка:
Survey123 Mobile открывает ссылки для трех приложений: Survey123 Mobile, полевого приложения Survey123 и QuickCapture. При запуске любой из этих ссылок из Survey123 Mobile (из разделов Использовать ссылку, Сканировать QR-код» или из ссылки внутри опроса или проекта QuickCapture) они откроются внутри Survey123 Mobile. Дополнительные сведения см. в разделе Открытие ресурсов.
Используйте шаблоны URL-адресов в таблице для создания ссылок для доступа из веб-браузера или другого приложения. В следующих примерах показывается, как открывать конкретный опрос, используя эти шаблоны URL-адресов.
| Что запускать | Откуда ссылка | Шаблон URL для использования |
|---|---|---|
| Survey123 Mobile | Android iOS | приложение Survey123 ссылка1: Пример: |
Windows Android iOS2 | Схема пользовательского URL3: Пример: | |
Веб-приложение | Веб-браузер | Форма опроса по ID: Пример: |
Полевое приложение | Android iOS | Приложение Survey123 ссылка1: Пример: |
Windows Android iOS2 | Схема пользовательского URL3: Пример: | |
| Survey123 Studio | Windows | Схема пользовательского URL3: Пример: |
Survey123 Connect | Windows | Схема пользовательского URL3: Пример: |
Другое приложение | Форма опроса | Ссылка из Survey123: зависит от приложения |
1 — ссылки на приложение Survey123 соответствуют требованиям, установленным App Store и Google Play, позволяют ссылаться на большее количество приложений и поддерживают сокращенные ссылки, которыми легче делиться.
2 — на устройствах iOS пользовательские схемы URL одобрены только для выбранной группы приложений.
3 — ссылки на пользовательские схемы URL нельзя сделать короче, и их может быть трудно открыть в Android. Лучше всего формировать ссылки на пользовательские схемы URL-адресов в виде гиперссылок, показанных ниже:<a href="arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19">Open survey</a>
Параметры URL
Вы можете добавить параметры URL-адреса в конец ссылок, чтобы дополнительно настроить способ открытия приложения. Например, вы можете задать местоположение по умолчанию для вопроса типа Геоточка или заполнить текстовый вопрос.
Параметры URL начинаются с символа ? и разделяются символом &. В следующем примере показана пользовательская схема URL-адреса, в которой первый параметр (itemID) начинается с символа ?, а все последующие параметры поля (color_1 и color_2) разделены символом &.
arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:color_1=red&field:color_2=blueДополнительные примеры URL-адресов и поддерживаемых параметров URL-адресов см. в разделах Запуск Survey123 Mobile, Функции | ArcGIS Arcade | Esri Developer Запуск веб-приложения, Запуск полевого приложения, Запуск Survey123 Connect и Запуск другого приложения из Survey123.
Примечание:
Прежде чем использовать ссылку, содержащую параметры, для запуска опроса в Survey123 Mobile или в полевом приложении, рекомендуется, чтобы это приложение было уже установлено на устройстве. Подробнее см. раздел Установка ArcGIS Survey123.
Кодировка URL
Хотя не кодированные параметры URL в некоторых средах работают, рекомендуется выполнять кодирование параметров URL. Кодирование заменяет некорректный символ на символ %, за которым следует его шестнадцатеричный эквивалент.
Например, это ссылка Survey123, использующая вызов для возврата к конкретной веб-карте в QuickCapture с незакодированными параметрами:
https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https://quickcapture.arcgis.app?itemID=867895a71a1840399476fc717e76bb43Далее показан тот же URL с кодированными параметрами:
https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https%3A%2F%2Fquickcapture.arcgis.app%3FitemID=867895a71a1840399476fc717e76bb43Знак равенства, который задает разрыв между ключом и его значением, не должен кодироваться.
Подсказка:
Один способ создания кодированных параметров - использование ArcGIS Arcade. Функция UrlEncode позволяет вам задавать набор пар «ключ/значение», отображающих каждый из параметров, и обеспечить подходящее кодирование URL.
Автор опроса также может скрыть параметры URL-адреса, чтобы конфиденциальные данные не были видны в URL-адресе. Для этого при создании URL-адреса, который будет использоваться в веб-приложении, включите параметр encodeUrlParams=true. Более подробно см. раздел Параметры URL для открытия веб-приложения.