Автоматизация Field Maps

Вы можете автоматизировать ArcGIS Field Maps, чтобы упростить подготовку карт и их развертывание в полевых условиях. Вы можете использовать вебхуки и скрипты для автоматизации различных задач, таких как копирование формы между картами и автоматическое создание уведомления по электронной почте при каждой проверке актива. Ниже приведены два способа автоматизации задач для Field Maps:

• Настройка вебхука в Make (прежнее название Integromat) — Дает возможность автоматически получать уведомления почти в реальном времени, когда мобильные работники создают, редактируют или удаляют объекты в поле.
• Использование ArcGIS API for Python - Использование скриптов Python и блокнотов для настройки и развертывания карт, а также для управления и анализа данных, собранных в Field Maps.

Настройка вебхука в Make

Вебхук позволяет приложению предоставлять другим приложениям информацию, управляемую событиями. Обычное применение вебхуков включает в себя отправку уведомлений по email или СМС, публикацию сообщений в социальных сетях, автоматическую запись в электронную таблицу и обновление многопользовательских баз данных. Field Maps поддерживает вебхуки через Make (прежнее название Integromat), сторонний сервис автоматизации рабочих процессов. Make имеет встроенное приложение Field Maps, которое позволяет Field Mapsинтегрироваться в рабочий процесс вебхука. Вы можете интегрировать приложение Field Maps следующими способами:

• Триггер вебхука - Наблюдение объектов запускает отслеживание объектов, которые добавляются, редактируются или удаляются в мобильном приложении Field Maps.
• Сделать вызов API - Действие Сделать вызов API позволяет выполнять запросы API к веб-сервисам ArcGIS.

Примечание:

Приложение Field Maps в Make поддерживает только размещенные сервисы объектов и в настоящее время не поддерживается ArcGIS Enterprise.

Добавить приложение Field Maps

Чтобы добавить приложение Field Maps в вебхук в Make, выполните следующие действия:

1. Перейдите на сайт https://www.make.com/ и выполните вход.

   Если у вас нет учетной записи, зарегистрируйтесь бесплатно, чтобы начать работу.

2. Щелкните Создание нового сценария.
3. Найдите и выберите ArcGIS Field Maps, затем щелкните Продолжить.

   Приложение ArcGIS Field Maps указано как избранное в вашем сценарии.

4. Щелкните кнопку модуля в центре экрана и выберите в меню ArcGIS Field Maps.

   Приложение ArcGIS Field Maps добавлено. Вы можете использовать приложение для запуска вебхука или вызова API веб-сервисов ArcGIS.

Подключение ко своей организации ArcGIS

Если вы впервые используете приложение Field Maps в Make, настройте подключение к вашей организации ArcGIS. То, как вы подключаетесь к своей организации, зависит от того, какой модуль вы используете, и от сервисов, к которым вы обращаетесь.

Подключение триггера Наблюдение объектов к вашей организации ArcGIS

Чтобы подключить триггер Наблюдение объектов к вашей организации ArcGIS, выполните следующие действия:

1. Добавьте приложение Field Maps в вебхук в Make
2. Выберите триггер Наблюдение объектов.
3. В разделе Вебхуки щелкните Добавить.
4. В разделе Подключение щелкните Добавить и имя подключения ArcGIS.

   Чтобы подключиться к ArcGIS Online, щелкните Продолжить, чтобы войти в организацию ArcGIS.

Вы можете просматривать и редактировать подключения, которые вы устанавливаете, на вкладке Подключения в Make. Чтобы подключиться к нескольким веб-сервисам в ArcGIS, вам может потребоваться создать несколько подключений. Например, если вы используете модуль Сделать вызов API для запроса к векторному слою и другой модуль Сделать вызов API для доступа к API общего доступа, вам потребуется отдельное соединение с каждым сервисом.

Примечание:

Если вы не используете подключение в течение 90 дней, срок действия токена обновления истекает, и вам необходимо повторно подключиться к своей организации ArcGIS. Если maxTokenExpirationMinutes настроен для вашей организации и составляет менее 90 дней, срок действия токена обновления истекает в зависимости от этого значения.

Подключите действие Сделать вызов API к вашей организации ArcGIS

Чтобы подключить действие Сделать вызов API к вашей организации ArcGIS, выполните следующие действия:

1. Добавьте приложение Field Maps в вебхук в Make
2. Выберите действие Сделать вызов API.
3. В разделе Подключение щелкните Добавить и укажите следующее:
   1. Имя подключения - Предоставьте имя для подключения, например ArcGIS.

      Примечание:

      Если вы получаете доступ к Sharing API, щелкните Продолжить, чтобы войти в свою организацию ArcGIS, вместо выполнения следующих шагов.

   2. Суб-домен - Укажите сервисы для подключения. Например, если вы подключаетесь к сервисам объектов, введите services.

      Примечание:

      Если вы подключаетесь к сервисам объектов, просмотрите страницу элементов вашего векторного слоя, чтобы найти суб-домен, который будет использоваться. Под URL начинается отображаемая ссылка https://<services>.arcgis.com. Используйте текст в <services> в качестве суб-домена для подключения модуля к сервисам объектов.

   3. ArcGIS Online URL - Щелкните Показать дополнительные параметры и укажите URL-адрес вашей организации ArcGIS.

      Чтобы подключиться к ArcGIS Online, щелкните Продолжить, чтобы войти в организацию ArcGIS.

Вы можете просматривать и редактировать подключения, которые вы устанавливаете, на вкладке Подключения в Make. Чтобы подключиться к нескольким веб-сервисам в ArcGIS, вам может потребоваться создать несколько подключений. Например, если вы используете модуль Сделать вызов API для запроса к векторному слою и другой модуль Сделать вызов API для доступа к API общего доступа, вам потребуется отдельное соединение с каждым сервисом.

Примечание:

Если вы не используете подключение в течение 90 дней, срок действия токена обновления истекает, и вам необходимо повторно подключиться к своей организации ArcGIS. Если maxTokenExpirationMinutes настроен для вашей организации и составляет менее 90 дней, срок действия токена обновления истекает в зависимости от этого значения.

Триггер вебхука в приложении Field Maps

Вебхуки можно настроить и активировать при создании, обновлении или удалении объекта в Field Maps или других приложениях, таких как Map Viewer. Например, после сбора новых объектов в Field Maps, вебхук может инициировать другое действие, например отправку уведомления по электронной почте. Выполните следующие действия в Make, чтобы создать вебхук, который отправляет уведомление по электронной почте каждый раз, когда объект создается, обновляется или удаляется в мобильном приложении Field Maps:

Примечание:

Пошаговое руководство см. в публикации блога Автоматизация уведомлений по электронной почте для обновлений полей и в видео Автоматические уведомления по электронной почте с помощью Make.

1. Добавьте приложение Field Maps в вебхук в Make
2. Выберите модуль триггера Наблюдение объектов.

   Этот модуль запускает сценарий каждый раз, когда объект создается, обновляется или удаляется.

   Значок сценария меняет цвет, и появляется окно, помогающее настроить модуль Field Maps.

3. Щелкните Добавить и введите имя вебхука.
   Имя должно быть уникальным для проекта или карты, которые будут использовать вебхук.
4. Если это первое использование модуля в Make, настройте подключение к организации ArcGIS.

   Примечание:

   Если вы создали подключение для модуля Сделать вызов API, вы можете повторно использовать это соединение для модуля Наблюдение объектов.

5. В разделе Векторный слой выберите редактируемый векторный слой из вашей организации ArcGIS, к которому нужно подключиться.
6. Выберите одно или несколько из следующих Инициирующих событий для включения в вебхук:
   • Объекты созданы - Триггер сценария при создании объекта.
   • Объекты обновлены - Триггер сценария при обновлении объекта.
   • Объекты удалены - Триггер сценария при удалении объекта.
7. Щелкните Сохранить.
8. Нажмите OK.

   Модуль Field Maps настроен.

9. В разделе Инструменты щелкните Управление потоком.
10. Из списка опций выберите Итератор.

    Модуль итератор автоматически подключается к модулю Field Maps. Это позволяет вебхуку перебирать массив объектов, если одновременно возвращаются несколько объектов.

11. Выберите модуль Итератор и щелкните текстовое окно Массив.
12. В ниспадающем меню ArcGIS Field Maps - Сервис Наблюдение объектов найдите и выберите один из следующих массивов:
    • Adds [] - Для создаваемых объектов
    • Updates [] - Для обновляемых объектов
    • Delete IDs [] - Для удаляемых объектов
13. Нажмите OK.
14. Щелкните кнопку Добавить другой модуль рядом с модулем итератор.
15. Найдите сервис электронной почты, которую хотите использовать, например Microsoft 365 Email, и выберите приложение.
16. Выберите действие Создать и отправить сообщение.
17. Если это ваше первое использование модуля в Make, щелкните Добавить, чтобы настроить подключение к вашей учетной записи электронной почты. Выберите тип подключения и выполните вход под вашей учетной записью.

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

18. Добавьте в электронное письмо Тему и Основное содержание.

    Вы можете использовать сопоставление, чтобы включить атрибуты из вашего слоя для форматирования текстовых окон. Если вы используете сопоставление, добавьте атрибуты слоя из модуля итератор.

19. Добавьте адрес электронной почты получателя.

    На этот адрес будет отправляться email по триггерам.

20. Нажмите OK.
21. Нажмите Сохранить, чтобы сохранить сценарий.

    Дополнительно, щелкните Запустить один раз, чтобы проверить вебхук. После щелчка по кнопке Запустить один раз откройте Field Maps и соберите, обновите или удалите объект. Убедитесь, что получатель получил электронное письмо.

22. Используйте переключатель Расписание, чтобы активировать свой сценарий. Установите расписание на Немедленно, чтобы сценарий запускался каждый раз при обновлении объекта.

Примечание:

Для поддержки Makeсм. Документацию Make.

Сделать вызов API в приложении Field Maps

Приложение Field Maps можно использовать для выполнения запросов API к веб-сервисам ArcGIS. Например, если пользователь собирает новую объект в Field Maps, вы можете использовать модуль Сделать вызов API, чтобы получить адрес электронной почты этого пользователя и отправить ему электронное письмо. Вы также можете использовать модуль для запроса векторного слоя и создания объектов, таких как назначение Workforce. Ниже приведены примеры того, как вы можете использовать приложение Field Maps для выполнения запросов API:

• Сделайте запрос к API общего доступа
• Сделайте запрос на запрос векторного слоя
• Сделайте запрос на создание объекта

Сделайте запрос к API общего доступа

API общего доступа позволяет запрашивать информацию о пользователях, группах и ресурсах в организации. Вы можете использовать его для поиска информации о пользователях, поиска на картах, просмотра ресурсов и многого другого. Вы можете использовать приложение Field Maps в вебхуке для получения информации из API общего доступа. Например, чтобы отправить электронное письмо пользователю, который только что завершил проверку, вы можете использовать приложение Field Maps для получения его адреса электронной почты. Чтобы настроить приложение Field Maps для получения информации о пользователе из API общего доступа, выполните следующие действия:

1. Добавьте приложение Field Maps в вебхук в Make
2. Выберите модуль действия Сделать вызов API.

   Значок сценария меняет цвет, и появляется окно, помогающее настроить модуль Field Maps.

3. Если это первое использование модуля в Make, настройте подключение к организации ArcGIS.

   Примечание:

   Если вы создали подключение для модуля Наблюдение объектов, вы можете повторно использовать это подключение для подключения к API общего доступа в модуле Сделать вызов API.

4. В разделе URL укажите путь к API общего доступа.

   В этом примере используйте следующий путь для доступа к информации пользователя:

   /sharing/rest/community/<username>

   Для получения дополнительной информации см. Введение в API общего доступа.

5. В разделе Метод выберите Get.
6. В разделе Строка запроса щелкните Добавить элемент.
7. Предоставьте следующие данные:
   1. Ключ - f
   2. Значение - json
8. Нажмите OK.
9. Нажмите Сохранить, чтобы сохранить сценарий.

При запуске модуль Field Maps будет получать информацию о пользователе из API общего доступа.

Примечание:

Для поддержки Makeсм. Документацию Make.

Сделайте запрос на запрос векторного слоя

Вы можете сделать запрос API для запроса векторного слоя. Например, вы хотите, чтобы краткая информация в конце дня была отправлена вам по электронной почте. Вы можете настроить приложение Field Maps так, чтобы оно запрашивало статистику дневных проверок и отправляло ее по электронной почте. Чтобы настроить приложение Field Maps для запроса векторного слоя, выполните следующие действия:

1. Добавьте приложение Field Maps в вебхук в Make
2. Выберите модуль действия Сделать вызов API.

   Значок сценария меняет цвет, и появляется окно, помогающее настроить модуль Field Maps.

3. Если это первое использование модуля в Make, настройте подключение к организации ArcGIS.
4. В разделе URL укажите путь к сервису объектов, который вы хотите запросить:

   /<org-id>/arcgis/rest/services/<layer-name>/FeatureServer/<layer-id>/query

   Для получения дополнительной информации см. Запрос (Векторный слой/Сервис объектов).
5. В разделе Метод выберите Get.
6. Добавьте элементы Строка запроса.
   1. В разделе Строка запроса щелкните Добавить элемент и введите следующие данные:

      1. Ключ - f
      2. Значение - json

   2. Щёлкните Добавить.
   3. Щелкните Добавить элемент и введите следующие данные:

      1. Ключ - where
      2. Значение - 1=1

   4. Щёлкните Добавить.
   5. Щелкните Добавить элемент и введите следующие данные:

      1. Ключ - outFields
      2. Значение - *

   6. Щёлкните Добавить.
7. Нажмите OK.
8. Нажмите Сохранить, чтобы сохранить сценарий.

При запуске модуль Field Maps будет запрашивать векторный слой на основе заданных вами параметров.

Примечание:

Для поддержки Makeсм. Документацию Make.

Сделайте запрос на создание объекта

Вы можете сделать запрос API на создание объекта. Например, если проверка пожарного гидранта завершена в Field Maps, это может инициировать создание объекта назначения в ArcGIS Workforce. Чтобы настроить приложение Field Maps для добавления объекта, выполните следующие действия:

1. Добавьте приложение Field Maps в вебхук в Make
2. Выберите модуль действия Сделать вызов API.

   Значок сценария меняет цвет, и появляется окно, помогающее настроить модуль Field Maps.

3. Если это первое использование модуля в Make, настройте подключение к организации ArcGIS.
4. В разделе URL укажите путь к сервису объектов, в который вы хотите добавить объекты:

   /<org-id>/arcgis/rest/services/<layer-name>/FeatureServer/<layer-id>/applyEdits

   Для получения дополнительной информации см. Применение изменений (Векторный слой/Сервис объектов).
5. В разделе Метод выберите Post.
6. В разделе Заголовки щелкните Редактировать.
7. Измените Значение на application/x-www-form-urlencoded.
8. Щелкните Сохранить.
9. В разделе Основа введите f=json&adds=[<json-object>].

   Значение для <json-object> должно быть строкой JSON, представляющей объект. Точная спецификация для использования зависит от вашего слоя. Более подробно см. Feature object.

10. Нажмите OK.
11. Нажмите Сохранить, чтобы сохранить сценарий.

При запуске модуль Field Maps добавит объект к слою.

Примечание:

Для поддержки Makeсм. Документацию Make.

Использование ArcGIS API for Python

Используйте ArcGIS API for Python для автоматизации и создания скриптов задач для Field Maps. Вы можете использовать модуль Формы для создания и редактирования форм, используемых для сбора данных, и вы можете получить доступ к репозиторию скриптов Field Maps на GitHub, например, скриптов и блокнотов. Скрипты и блокноты позволяют автоматизировать такие задачи, как копирование форм между картами и загрузка вложений из векторного слоя.

Примечание:

Чтобы использовать модуль Формы, вы должны использовать ArcGIS API for Python версии 1.9.0 или новее.