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

ArcGIS QuickCapture может быть интегрирован с другими приложениями с помощью QuickCapture или пользовательской схемы URL. Оба метода поддерживают одни и те же параметры, но методы различаются в зависимости от платформы.

Ссылки QuickCapture начинаются с https://quickcapture.arcgis.app и работают только в iOS и Android. Ссылки QuickCapture соответствуют требованиям, установленным App Store и Google Play, позволяют ссылаться на большее количество приложений и поддерживают сокращенные ссылки, которыми легче делиться. К приложениям ArcGIS, которые могут быть открыты по ссылке QuickCapture, относятся ArcGIS Survey123, ArcGIS Field Maps, ArcGIS Workforce и ArcGIS Navigator.

Ссылки пользовательских схем URL-адресов начинаются с arcgis-quickcapture:// и работают в Windows, Android и с выбранной группой приложений на iOS. К приложениям ArcGIS, которые могут открываться с помощью URL-схемы из QuickCapture, относятся ArcGIS Survey123 и ArcGIS Collector на Windows. Пользовательские ссылки схем URL нельзя сделать короче, и их может быть трудно открыть на Android. Лучше всего формировать ссылки на пользовательские схемы URL-адресов в виде гиперссылок, показанных ниже:

<a href="arcgis-quickcapture://?itemID=36ff9e8c13e042a58cfce4ad87f55d19">Open project</a>

Ссылки QuickCapture являются предпочтительным методом связывания приложений, а пользовательские схемы URL лучше подходят для публикации проектов.

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

Параметры для мобильного приложения

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


Параметр	Описание	Пример	Тип
action	Определяет, как открывается проект. Поддерживаются значения press (чтобы нажать определенную кнопку) и field (для заполнения поля при нажатии кнопки). Кнопки идентифицируются по GUID, который отображается в нижней части вкладки Оформление этих кнопок в дизайнере QuickCapture.	Чтобы захватить точечный объект или начать или остановить захват линейного или полигонального объекта: action=press:0c59c9d9-9b51-46b3-bb81-21149e6fddb4 Чтобы захватить объект и заполнить поле диаметра этого объекта значением 20: action=press:0c59c9d9-9b51-46b3-bb81-21149e6fddb4&field:diameter=20	String
callback	Указывает URL-адрес, который будет возвращаться при нажатии кнопки.	callback=https://survey123.arcgis.app	URL
center	Центрирует карту относительно известных значений широты, долготы и, дополнительно, высоты.	center=37.8199,-122.4783,20	String
externalBrowserSignIn	Задает использование внешнего браузера для входа	externalBrowserSignIn=true	Boolean
itemID	Задает проект, который нужно открыть.	itemID=aabda4a5e36d42c2bcf1c479fe01e5e3	UUID
portalUrl	Задает URL портала, на котором размещен элемент проекта QuickCapture.	portalUrl=https://myorg.arcgis.com	String
userInput	Задает id и значение, которым нужно заполнить переменную пользовательского ввода в проекте.	userInput:001=Alice	String

Ссылки на QuickCapture из настольного веб-браузера

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

Примечание:

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

Введите arcgis-quickcapture:// в браузере.
Мобильное приложение QuickCapture откроется автоматически (или вам будет предложено открыть его).
Примечание:
Чтобы запустить и загрузить проект с конкретного портала, включите параметр URL, к примеру, arcgis-quickcapture://?portalUrl=host.domain.com/webadaptor (где host, domain и webadaptor замените в соответствии с вашим порталом). Чтобы использовать для входа внешний браузер, включите параметр externalBrowserSignIn и задайте его как true, например, arcgis-quickcapture://?portalUrl=host.domain.com/webadaptor&externalBrowserSignIn=true.

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

Чтобы включить проект в создаваемый URL-адрес, добавьте ?itemID= и ID элемента проекта в URL-адрес.
URL должен выглядеть примерно так:
arcgis-quickcapture://?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3
Если вы проверите URL, должно сразу открываться мобильное приложение QuickCapture вместе с вашим проектом.
Примечание:
Если его еще нет на вашем устройстве, проект будет скачан.

При необходимости можно включить заранее заданную входную переменную пользователя проекта.

Чтобы заполнить входную переменную пользователя проекта, напечатайте &userInput, а также ID пользовательского ввода и значение, разделенные знаком равенства (=).

Примечание:
Амперсанд (&) выступает как разделитель параметров.
Каждый пользовательский ввод проекта имеет уникальный идентификатор. Чтобы увидеть идентификатор, переключитесь в представление JSON вашего проекта и выполните поиск userInputs. Каждый пользовательский ввод проекта представлен как массив свойств; первым является идентификатор.
URL должен выглядеть примерно так:
arcgis-quickcapture://?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001=Alice
Этот URL-адрес откроет мобильное приложение QuickCapture и ваш проект, а входное значение пользователя проекта Alice будет использоваться в любом поле, которое было настроено для его принятия. В проект можно добавить до трех значений пользовательского ввода проекта. URL-адрес, содержащий более одного значения пользовательского ввода проекта, должен выглядеть примерно так:
arcgis-quickcapture://?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001=Alice&userInput:002=Zone5

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

Выберите Настройка всплывающих окон для имеющегося слоя веб-карты. В ниспадающем меню отображения выберите отображение пользовательского атрибута, затем щелкните Настроить и вставьте ссылку на проект.
Чтобы заполнить переменную пользовательского ввода проекта значением поля observer для объекта, из которого была запущена ссылка, введите &userInput:001={observer}; амперсанд (&) выступает как разделитель параметров, а фигурные скобки ({}) обозначают имя поля.
URL должен выглядеть примерно так:
arcgis-quickcapture://?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001={observer}.

Переход к QuickCapture из других приложений

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

Выберите Настройка всплывающих окон для имеющегося слоя веб-карты для просмотра на устройстве.
В ниспадающем меню отображения выберите отображение пользовательского атрибута, затем щелкните Настроить и вставьте ссылку на проект.
Введите https://quickcapture.arcgis.app в качестве параметра URL, введите Запустить QuickCapture в поле Текст ссылки и нажмите OK.
1. Откройте свою веб-карту на мобильном устройстве из браузера или приложения ArcGIS.
2. Выберите объект и щелкните ссылку Запустить QuickCapture во всплывающем меню для запуска QuickCapture.
Чтобы включить проект в создаваемый URL-адрес, добавьте ?itemID= и ID элемента проекта в URL-адрес.
URL должен выглядеть примерно так:
```
https://quickcapture.arcgis.app/?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3
```
Если вы проверите URL, должно сразу открываться мобильное приложение QuickCapture вместе с вашим проектом.
Примечание:
Если его еще нет на вашем устройстве, проект будет скачан.

При необходимости можно включить заранее заданную входную переменную пользователя проекта.

Чтобы заполнить переменную пользовательского ввода в проекте, напечатайте &userInput:id= и значение, которое хотите ввести; амперсанд (&) выступает как разделитель параметров.
URL должен выглядеть примерно так:
https://quickcapture.arcgis.app/?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001=Alice
Этот URL-адрес откроет мобильное приложение QuickCapture и ваш проект, а входное значение пользователя проекта Area7 будет использоваться в любом поле, которое было настроено для его принятия.

Содержание полей также может быть передано во входную переменную пользователя проекта из приложения ArcGIS.

Чтобы заполнить переменную пользовательского ввода проекта значением поля workArea для объекта, из которого была запущена ссылка, введите &userInput:001={observer}; амперсанд (&) выступает как разделитель параметров, а фигурные скобки ({}) обозначают имя поля.
URL должен выглядеть примерно так:
https://quickcapture.arcgis.app/?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001={observer}

Ссылка на другое приложение из QuickCapture

Проект QuickCapture может быть настроен на открытие других приложений по кнопке, которая открывает URL, что обеспечивает мобильных сотрудников гибкой и бесшовной средой для работы с QuickCapture и другими приложениями.

Чтобы создать ссылку на другое приложение из QuickCapture, необходимо настроить проект, добавив кнопку ссылки и настроив для нее URL. В конструкторе можно настроить кнопку для открытия указанного URL, например, пользовательского URL или ссылки на приложении, которая открывает другое приложение Esri. В случае использования полевого приложения ArcGIS Survey123, можно дополнительно найти и выбрать форму опроса и заранее задать значения для вопросов.

Настройка кнопки ссылки

Чтобы настроить кнопку, которая запускает URL на панели управления, выполните следующие шаги:

Щелкните кнопку и перейдите на вкладку Ссылка.
Щелкните URL.
Введите https://www.arcgis.com/apps/dashboards/747e7365d1894db4bbadf100f65cf991 в качестве URL-адреса.

Это приведет к созданию кнопки ссылки, которая запускает QuickCapture BioBlitz Dashboard из мобильного приложения. В текстовом редакторе можно ввести любой URL на основе HTTPS, или пользовательскую схему URL для другого приложения, имеющего разрешенный QuickCapture.

Примечание:

Ссылки также можно создавать для запуска приложений для общения, таких как электронная почта, СМС и телефон. Это дает возможность пользователям быстро обратиться за помощью непосредственно из самого проекта. Ниже приведены примеры ссылок на приложения для общения:

Email—mailto:sample@esri.com?subject=Fix%20the%20pipe&body=We%20really%20need%20to%20fix%20the%20pipe
SMS - sms:0291920995 (На Android может быть также включено и тело сообщения: sms:0291920995?body=We%20really%20need%20to%20fix%20the%20pipe)
Телефон—tel:0291920995

Настройка кнопки ArcGIS Survey123

Чтобы настроить кнопку, которая запускает полевое приложение ArcGIS Survey123, выполните следующие шаги:

Щелкните кнопку и перейдите на вкладку Ссылка.
Щелкните Полевое приложение Survey123.
Выберите опрос для связывания с кнопкой.
Это задает параметр itemID в ссылке Survey123.
Щелкните Добавить, чтобы добавить вопрос к опросу и связать фиксированное значение, переменную устройства или пользовательский ввод проекта с вопросом.
Это задает значение указанного параметра field:fieldname в ссылке Survey123. Повторите этот шаг, чтобы добавить все остальные вопросы. Чтобы удалить настроенный вопрос из опроса, щелкните кнопку удаления. Это позволяет убрать заданный параметр field:fieldname из ссылки Survey123.
Дополнительно включите Передать местоположение в Survey123, чтобы добавить параметр center со значениями широты и долготы в ссылку Survey123.
Если в опрос включен вопрос типа геоточка, то карта будет центрирована относительно местоположения, переданного в него из QuickCapture.
Дополнительно, включите опцию Вернуться в QuickCapture, чтобы перенаправить пользователя в QuickCapture после отправки опроса.
Это добавляет параметр callback:submit в ссылку Survey123.

Конструктор создаст ссылку Survey123 автоматически.

Ваш URL должны выглядеть примерно так. Этот пример включает фиксированное значение для condition, переменную устройства для capturetime, и пользовательский ввод для username.

arcgis-survey123://?itemID=2a41c332e24644ee895bbbd9b929773f&field:condition=damaged&field:capturetime=${captureTime}&field:username=${userInput:001}

Или, можно создать ссылку Survey123 вручную, с опцией URL. В текстовом редакторе создайте ссылку URL вручную, или используйте панель инструментов, чтобы добавить готовое значение для параметров URL. Вы можете выбрать фиксированное значение, переменную устройства или переменную пользовательского ввода проекта для добавления к URL. Эти переменные обозначаются в URL фигурными скобками ({}), а актуальное значение в скобках будет автоматически заполнено в мобильном приложении при нажатии кнопки.

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

Дополнительные сведения о параметрах, поддерживаемых в Survey123, см. в разделе Интеграция Survey123 с другими приложениями.

Примечание:

При назначении переменных для вопросов в опросе, необходимо учитывать соответствие типов полей.

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

arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback:submit=https%3A%2F%2Fquickcapture.arcgis.app%253FitemID%99c18758066b42e1a0f4027603070b34

Отзыв по этому разделу?