Вы можете создать ссылки для открытия Survey123 Mobile из другого приложения, всплывающего окна веб-карты или по гиперссылке в электронном письме или на веб-сайте. Используйте собственную схему URL-адресов для запуска приложения из веб-браузера или используйте ссылку на приложение Survey123 для его запуска из приложения на Android или iOS. Используйте параметры URL-адреса, чтобы настроить способ открытия Survey123 Mobile, например, чтобы загрузить конкретный опрос, задать координаты местоположения на карте по умолчанию и заполнить ответы на вопросы заранее определенными значениями или путем передачи атрибутов данных из всплывающего окна веб-карты.
Ссылка из веб-браузера в Windows
Вы можете создать ссылку для открытия Survey123 Mobile, которую можно встроить в другое приложение. Этот же URL также можно ввести в веб-браузер для проверки.
Примечание:
После создания ссылки можно заменить arcgis-survey123-mobile:// на https://survey123-mobile.arcgis.app в ссылке Survey123 для работы в iOS и Android.
Выполните следующие действия для создания пользовательской схемы URL и ее использования в настольном веб-браузере:
- Введите arcgis-survey123-mobile:// в свой браузер.
Откроется Survey123 Mobile (или вам будет предложено открыть его).
Примечание:
Чтобы запустить и загрузить опрос с конкретного портала, включите параметр URL портала, к примеру, arcgis-survey123-mobile://?portalUrl=host.domain.com/webadaptor (в котором host, domain и webadaptor надо заменить на информацию о вашем портале).
- Добавьте уникальную ссылку на опрос и добавьте ее к URL, выполнив следующие действия:
- Определите ID опроса, который вы хотите открыть.
Примечание:
Это строка символов, которая используется ArcGIS Online для однозначной идентификации опроса и может быть найдена в URL-адресе вашего элемента формы в ArcGIS Online. Например, если URL опроса - https://exampleurl.maps.arcgis.com/home/item.html?id=36ff9e8c13e042a58cfce4ad87f55d19, ID вашего элемента формы будет 36ff9e8c13e042a58cfce4ad87f55d19.
- Включите опрос в URL-адрес, добавив ?itemID= и ID элемента формы в конец URL-адреса.
URL должен выглядеть примерно так:arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19Если вы тестируете URL, он должен открыть Survey123 Mobile вместе с опросом.
Примечание:
Если его на вашем устройстве еще нет, опрос будет загружен на него.
- Определите ID опроса, который вы хотите открыть.
- Включите заранее определенные ответы на вопросы, добавив в URL-адрес ссылку на поле с помощью имени, присвоенного ему в XLSForm (не его подпись).
Например, чтобы заполнить поле Surname, введите &field:surname= и значение.
& выступает в качестве разделителя параметров, а field: ссылается на заполняемое имя вопроса.
URL должен выглядеть примерно так:arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=KlauserТеперь URL можно использовать для открытия Survey123 Mobile и опроса, где на указанный вопрос уже будет дан заданный ответ. Вы можете заполнить несколько вопросов в одном URL-адресе опроса. Имена полей чувствительны к регистру.
- Задайте местоположение для вопроса Геоточка в опросе, добавив в URL координаты следующим образом:
- Для этого введите ¢er= и координаты.
- Введите координаты широты и долготы в десятичных градусах, разделенные запятой.
- Дополнительно добавьте высоту в метрах в качестве третьего значения, которое тоже должно быть отделено запятой.
Итоговый URL-адрес должны выглядеть примерно так:
arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser¢er=37.8199,-122.4783,20Этот URL-адрес теперь открывает Survey123 Mobile и выбранный опрос, вводит ответ на текстовый вопрос и указывает новое используемое по умолчанию местоположение для ответа на вопрос Геоточка.
Атрибуты поля также могут быть переданы в Survey123 Mobile из всплывающего окна веб-карты ArcGIS, обеспечив интеграцию с любыми приложениями Esri, использующими всплывающие окна в веб-картах. Эта возможность может использоваться для заполнения полей Survey123 Mobile значениями атрибутов объектов, вместо задания значений, с помощью ввода имени атрибута в фигурных скобках.
- Откройте веб-карту, выберите Всплывающие окна для одного из слоев, выберите Добавить ресурс, выберите Текст, задайте текст для отображения ссылки и нажмите на кнопку Ссылка, чтобы ввести значение URL-адрес ссылки.
Переход из других приложений в iOS или Android
Вы должны создать ссылку, работающую в других приложениях ArcGIS, чтобы открыть Survey123 Mobile и выполнить захват опроса. Перечисленными ниже действиями описывается процесс создания ссылки на приложение Survey123 и ее использования во всплывающем окне веб-карты. Эта ссылка вводится во всплывающее окно веб-карты в вашей организации ArcGIS. Вы также можете проверить эти ссылки в веб-браузере (выполнив действия, аналогичные описанным в предыдущем разделе) на устройстве iOS или Android.
- Откройте веб-карту, которая будет просматриваться на устройстве, и выберите Всплывающие окна для одного из слоев.
- Выберите Добавить ресурс, а затем — Текст.
- Введите Запустить Survey123, выделите этот текст, нажмите на кнопку Ссылка, чтобы ввести URL-адрес ссылки, введите https://survey123-mobile.arcgis.app, нажмите OK и выполните следующие действия
- Откройте веб-карту на мобильном устройстве из браузера или приложения ArcGIS.
- Выберите объект и щелкните ссылку Запустить Survey123 во всплывающем меню, чтобы открыть Survey123.
- Чтобы включить опрос в URL-адрес, добавьте ?itemID= и ID элемента формы в конце URL-адреса. URL должен выглядеть примерно так:
https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19Если вы тестируете URL, он должен открыть Survey123 Mobile вместе с опросом.
Примечание:
Если его на вашем устройстве еще нет, опрос будет загружен на него.
- Включите заранее определенные ответы на вопросы, добавив в URL-адрес ссылку на поле с помощью имени, присвоенного ему в XLSForm (не его подпись).
Например, чтобы заполнить поле Surname, введите &field:surname= и значение.
& выступает в качестве разделителя параметров, а field: ссылается на заполняемое имя вопроса.
URL должен выглядеть примерно так:https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=KlauserТеперь URL можно использовать для открытия Survey123 Mobile и опроса, где на указанный вопрос уже будет дан заданный ответ. Вы можете заполнить несколько вопросов в одном URL-адресе опроса. Имена полей чувствительны к регистру.
- Задайте местоположение для вопроса Геоточка в опросе, добавив в URL координаты следующим образом:
- Для этого введите ¢er= и координаты.
- Введите координаты широты и долготы в десятичных градусах, разделенные запятой.
- Дополнительно добавьте высоту в метрах в качестве третьего значения, которое тоже должно быть отделено запятой.
Итоговый URL-адрес должны выглядеть примерно так:
https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser¢er=37.8199,-122.4783,20Этот полный URL-адрес теперь открывает Survey123 Mobile и выбранный опрос, вводит ответ на текстовый вопрос и указывает новое используемое по умолчанию местоположение для ответа на вопрос Геоточка.
Параметры URL для запуска Survey123 Mobile
Следующие параметры могут использоваться для настройки способа открытия Survey123 Mobile:
| Параметр | Описание | Тип |
|---|---|---|
center | Центрирует карту относительно известных значений широты, долготы и, дополнительно, высоты. Пример: | Строка |
field:fieldname | Заполняет вопросы опроса значениями поля. Пример: | Строка |
portalUrl | URL портала, на котором размещен элемент опроса. Пример: | Строка |
itemID | Открываемая форма. Пример: | UUID |
download | Автоматически загружает опрос, когда устройство находится в сети. По умолчанию – true. Пример: | Boolean |
callback | URL, возвращаемый, когда выполняется форма действия (к примеру, отправка, перемещение в черновики, отмена или выход). Пример: | URL |
callback:status | Пример: | Строка |