Развертывание Workforce

Вы можете помочь мобильным пользователям и диспетчерам начать работу с ArcGIS Workforce следующими способами:

Откройте мобильное приложение Workforce по ссылке

Мобильные пользователи могут указать URL портала в Workforce, либо вы можете отправить им URL, который будет перенаправлять их на соответствующий URL портала. Чтобы ваши мобильные сотрудники могли легко получить доступ на нужный портал, отправьте ссылку через электронную почту, текстовое сообщение, веб-страницу, QR-код или другое приложение. При касании Workforce откроет тот URL портала, который должен использовать данный мобильный работник.

Структура ссылки

Ссылки на мобильное приложение Workforce имеют следующий формат: https://workforce.arcgis.app?parameter=value. Пары параметр - значение заменяются значениями, которые вы хотите использовать для развертывания приложения. Например, ссылка https://workforce.arcgis.app?portalURL=https://myportal.mycompany.com/arcgis использует параметр portalURL, который направляет мобильных пользователей непосредственно на экран входа в вашу организацию и предлагает ввести данные учетной записи.

Параметры

Следующие параметры поддерживаются ссылками Workforce. Если параметры не будут переданы, то при касании этой ссылки откроется Workforce (или будет выведено соответствующее предложение скачать приложение).

ПараметрЗначенияПримечания

portalURL

URL портала вашей организации

  • Если значение указано, и мобильный сотрудник вышел из системы или подключен к другому порталу (в том числе ArcGIS Online), ему предлагается выйти из системы, а затем появляется экран входа в организацию с полями для ввода учетных данных.
  • Укажите тот же URL-адрес, который вы вводите в браузере, когда хотите получить доступ к порталу, например, https://myportal.mycompany.com/arcgis.

mapID

ID элемента загружаемой карты, которая откроется в Workforce

  • ID элемента присутствует в URL страницы элемента для Карты сотрудника. Например, если URL страницы элемента Карта сотрудника https://www.arcgis.com/home/item.html?id=fc60dfd46b234fbeaa74e76e6b17fb7b, ID элемента карты - fc60dfd46b234fbeaa74e76e6b17fb7b.

assignmentID

Значение GlobalID назначения, которое нужно открыть в Workforce

  • Необходимо значение mapID.
  • Значение GlobalID назначения находится на вкладке Данные на странице элемента слоя Назначения. В таблице щелкните меню Опции и щелкните Показать/Скрыть столбцы. Выберите GlobalID, чтобы отобразить это значение для каждого назначения.

assignmentStatus

Статус, присваиваемый назначению при открытии в Workforce

  • Необходимы значения mapID и assignmentID.
  • Поддерживаются следующие целочисленные значения:
    • 1 (Назначено)
    • 2 (Выполняется)
    • 3 (Завершено)
    • 4 (Отклонено)
    • 5 (Приостановлено)

Ниже приведены примеры использования этих параметров для задания определенного поведения с помощью ссылки в Workforce.

Подключение к определенному порталу

Укажите URL портала, к которому должны быть подключены полевые работники.

Ниже приведен пример:

https://workforce.arcgis.app?portalURL=https://myportal.mycompany.com/arcgis

Загрузка и открытие карты

Загрузите и откройте карту с использованием параметра mapID. Если на устройство мобильного сотрудника загружена карта, загрузка выполняться не будет, а указанная карта будет открыта в Workforce.

Ниже приведены примеры:

  • Откройте карту как зарегистрированный в данный момент мобильный работник или, если он не вошел, предоставьте ему возможность войти в:
    https://workforce.arcgis.app?mapID=3ac4145c1ac44aea86e9ed42e00fbb0d
  • Подключитесь к порталу и откройте карту:
    https://workforce.arcgis.app?portalURL=https://myportal.mycompany.com/arcgis&mapID=3ac4145c1ac44aea86e9ed42e00fbb0d

Открытие назначения

Откройте назначение на карте при помощи параметра assignmentID.

Ниже приведен пример:

https://workforce.arcgis.app?mapID=3ac4145c1ac44aea86e9ed42e00fbb0d&assignmentID=948b2bf3-f866-4516-97e7-00418d3b567d

Задайте статус назначения

Задайте статус назначения, используя параметр assignmentStatus.

Ниже приведен пример:

https://workforce.arcgis.app?mapID=3ac4145c1ac44aea86e9ed42e00fbb0d&assignmentID=948b2bf3-f866-4516-97e7-00418d3b567d&assignmentStatus=2
Примечание:

Можно, но не рекомендуется, использовать этот параметр для задания статуса назначения способами, которые не подходят для мобильных приложений. Например, если назначение имеет статус Назначено, ссылка Workforce может использоваться для присвоения статуса Приостановлено, с пропуском статуса В процессе, который задается полевым сотрудником. Пропуск этого статуса в мобильном приложении невозможен.

Откройте веб-приложение Workforce по ссылке

Вы можете упростить развертывание веб-приложения Workforce, предоставив доступ к ссылке по электронной почте, через текстовое сообщение, веб-страницу, QR-код или другое приложение. Ссылки можно настроить с параметрами URL-адреса, чтобы открыть существующее назначение или новое назначение с уже заполненной информацией о назначении.

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

Структура ссылки

Ссылки на веб-приложение Workforce всегда начинаются в следующем формате: http://<portal-url>/apps/workforce/projects/<project-id>.

Чтобы открыть определенное задание, добавьте /dispatch/assignments/<assignment-id> к ссылке: http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/<assignment-id>.

Чтобы запустить создание нового назначения, добавьте к ссылке /dispatch/assignments/new? и включите один или несколько параметров, разделенных амперсандом (&):

http://<your portal url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=repair&lat=34.057170&lon=-117.194150&location=Esri
Примечание:

project-id можно найти в URL-адресе, когда открыт проект Workforce. Например, если URL равно http://arcgis.com/apps/workforce/projects/a0f297f949f549f0ade07eee562d9934, значение project-id будет a0f297f949f549f0ade07eee562d9934.

Кодировка параметров

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

Например, следующая ссылка имеет незакодированные параметры:

http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=repair hydrant&lat=34.057170&lon=-117.194150&location=Esri Campus

Далее показана та же ссылка с кодированными параметрами:

http://<portal-url>/apps/workforce/<project-id>new?assignmentType=repair%20hydrant&lat=34.057170&lon=-117.194150&location=Esri%20Campus

Существует множество бесплатных веб-сайтов и инструментов для создания закодированных URL-адресов. Например, на сайте Albion Research Ltd. имеются страницы URLEncode и URLDecode.

Создание назначения

Создайте ссылку, которая запускает веб-приложение Workforce с уже заполненной информацией о новом назначении. Например, если у вас есть пользовательское приложение для создания проверок состояния деревьев, вы можете создать ссылку, которая открывает Workforce с типом назначения и информацией о местоположении, уже заполненными для нового назначения проверки состояния деревьев.

Параметры

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

ПараметрЗначенияПримечания

assignmentType

Тип назначения, присвоенный назначению

  • Вы можете использовать значение GlobalID или имя типа назначения.
    Примечание:

    Если вы создаете ссылку для Классического проекта, можно использовать домен кодированных значений или имя типа назначения.

  • Значения не чувствительны к регистру.

lat

Координата Y назначения в WGS84 (WKID: 4326)

  • Необходимо значение lon.

lon

Координата X назначения в WGS84 (WKID: 4326)

  • Необходимо значение lat.

location

Текст местоположения, используемый для назначения

  • Этот параметр игнорируется, если lat и lon не заполнены.

priority

Приоритет, заданный назначению

  • Поддерживаются следующие целочисленные значения:
    • 0 (Нет)
    • 1 (Низкий)
    • 2 (Средний)
    • 3 (Высокий)
    • 4 (Критический)

dueDateTime

Срок и время выполнения назначения

  • В числовых миллисекундах с эпохи Unix.

workOrderId

Ключ, ссылающийся на рабочий наряд из внешней или сторонней системы

  • Значение из вашей внешней системы.

description

Информация о назначении

  • Пояснительный текст.

assignee

Пользователь, которому назначено назначение

  • Вы можете использовать значение GlobalID работника или его имя пользователя.
    Примечание:

    Если вы создаете ссылку для проекта Classic, можно использовать значение objectid или имя пользователя.

  • Значения не чувствительны к регистру.
Примечание:

Все параметры являются необязательными; однако параметры assignmentType, lat, lon и location должны быть заполнены до создания нового назначения.

Если вы используете ArcGIS Enterprise, lat и lon являются единственными поддерживаемыми параметрами при создании назначения из ссылки. Веб-приложение Workforce на ArcGIS Enterprise использует обратное геокодирование для заполнения параметра location.

Примеры

Ниже приведены примеры использования параметров в ссылке приложения для заполнения информации при создании назначения Workforce:

  • Создайте назначение, используя координаты:
    http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?lat=34.057170&lon=-117.194150
  • Создайте назначение проверки состояния деревьев со средним уровнем приоритета и назначьте его мобильному работнику:
    http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=inspect%20tree&lat=34.057170&lon=-117.194150&location=esri&priority=2&assignee=mobile_worker
  • Создайте назначение на ремонт трубопровода сроком выполнения до 15:00 23 мая:
    http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=pipe%20repair&lat=34.057170&lon=-117.194150&location=esri&dueDateTime=1621782000000
  • Создайте назначение на ремонт с описанием проблемы:
    http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=repair&&lat=34.057170&lon=-117.194150&location=esri&description=Repair%20the%20valve.

Управление мобильным устройством

Управление мобильным устройством (MDM) - программное обеспечение, используемое для администрирования мобильных устройств в организации. MDM используется для повышения безопасности данных и сети, а также для установки и применения для мобильных устройств специальных политик. Кроме того, использование MDM повышает эффективность развертывания приложений и управления ими на мобильных устройствах, включая контроль за тем, как и когда обновляется приложение. Дополнительные сведения о подходе Esri к MDM, см. в разделе Техническая документация по безопасности мобильных решений ArcGIS в ArcGIS Trust Center.

При подготовке к развертыванию Workforce на мобильных устройствах вашей организации через MDM, существует ряд настроек приложения и профиля, которые вы можете настроить. К ним относятся URL-адрес портала и настройки VPN для каждого приложения.

Внимание:

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

Конфигурация приложения Workforce

Конфигурация приложения (также называемая AppConfig) описывает формат предоставления параметров приложения, в том числе таких как URL портала. Вместо того чтобы настраивать эти параметры вручную при каждой установке мобильного приложения, вы можете использовать MDM для автоматического задания и применения настроек приложения. Эти настройки задаются словарем, состоящим из пар «ключ-значение», находящимся в файле .xml. Порядок создания словаря зависит от используемого MDM. Для получения подробной информации о настройке приложения посетите веб-страницу Сообщество AppConfig.

Workforce имеет следующие настройки, которые можно задать с помощью конфигурации приложения в MDM:

КлючЗначениеПримечания

portalURL

URL портала вашей организации

  • Когда Workforce запущен, он напрямую переходит на экран входа в ваш портал организации.
  • Например, https://myportal.mycompany.com/gis.
  • Тип значения - строковый.

Виртуальная частная сеть для приложения

Настройка виртуальной частной сети для приложения (per-app VPN) в MDM позволяет ограничить доступ к внутренним ресурсам для определенных управляемых приложений. Workforce может быть развернут в этой конфигурации. Чтобы настроить использование VPN на уровне приложения для Workforce, см. документацию к ПО используемого MDM.

Внимание:

Если вы работаете с iOS, Safari используется для отображения в Workforce экрана входа на портал. Чтобы обеспечить корректную работу при включенной VPN для приложения, домен вашего портала (например, mycompany.com) должен быть указан в настройке Домены Safari в профиле VPN приложения, которую вы используете. Если Домены Safari заданы некорректно, то назначенные мобильные устройства не смогут получить к экрану входа на портал в Workforce.

Если вы задали Домены Safari в профиле VPN для приложения, как описано выше, браузер Safari также может получить доступ к домену портала, который вы указали в Доменах Safari. Чтобы заблокировать такой доступ, настройте Ограничение iOS (если это доступно в вашем MDM) на Блокировать приложение браузера Safari на соответствующих устройствах.

После настройки в MDM параметров VPN для каждого приложения для Workforce, приложение автоматически подключается к назначенному VPN для каждого приложения, когда приложение открывается на управляемом мобильном устройстве. Когда Workforce работает в фоновом режиме, VPN для каждого приложения подключается только к Workforce. Когда Workforce закрыт, мобильное устройство автоматически отключается от VPN на уровне приложения.