Настройка действий запуска для Indoor Viewer

Доступно с дополнительным модулем ArcGIS Indoors Maps.

ArcGIS Indoors включает поддержку действий запуска сторонних приложений непосредственно из информационной панели в Indoor Viewer. Действия запуска приложений - это способ интеграции важных бизнес-систем с ArcGIS Indoors.

Действие запуска может быть настроено для открытия веб-страницы или собственного мобильного приложения и автоматической передачи данных indoor в целевую систему или приложение. Это позволит людям отправлять инциденты или запросы к выбранному элементу в Viewer. Пользователи могут просматривать информацию о выбранном в приложении Viewer элементе и автоматически заполнять поля формы обновленной информацией с помощью веб-страницы или мобильного приложения.

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

  • Использование панели Настройка действий запуска Indoors в ArcGIS Pro. Действия запуска, настроенные в ArcGIS Pro, можно впоследствии изменить в ходе настройки приложения.
    Примечание:

    Изменения панели Настроить приложения влияют только на действия запуска в приложении Viewer.

  • Использование панели Настроить приложение при создании и изменении приложения. На панели конфигурации вы можете изменить действия запуска, созданные в ArcGIS Pro, или создать новые.

Примечание:

Indoors позволяет размещать булавки для местоположений, находящихся вне здания, например, садов кампуса или придомовых территорий. Если действие запуска применяется ко Всем слоям на панели конфигурации, для этих поставленных булавок также будет доступно действие.

Настройка действий запуска на панели конфигурации

В ходе настройки приложения Viewer выполните следующие шаги для изменения этих действий запуска приложения, созданных в ArcGIS Pro, или создания новых действий:

  1. На панели Настроить приложение перейдите в раздел Запуск приложения.
    Примечание:

    Если вы настроите действия запуска в ArcGIS Pro, они появляются в разделе Запуск приложения. При желании их можно обновить.

  2. По желанию добавьте новое действие.
    1. Щелкните Добавить, чтобы добавить новое действие.
    2. Укажите имя действия в текстовом поле Надпись.
    3. Добавьте URL-ссылку для действия в текстовом поле URL.
    4. Щелкните Выбрать категории и слои и поставьте отметки для слоев и категорий, с которыми вы хотите связать это действие.

      По умолчанию выбраны все слои и подкатегории.

    5. Нажмите OK.
    6. Повторите шаги для любых дополнительных действий.
  3. Щелкните кнопку Удалить Удалить рядом с действиями запуска, которые вы хотите удалить.
  4. При необходимости измените порядок действий с помощью стрелок вверх и вниз.
  5. Щелкните Сохранить, чтобы сохранить обновления в шаблоне приложения.

Действия запуска отображаются в списке, когда вы нажимаете на кнопку Дополнительно Больше на информационной панели для возможностей категорий и слоев с настроенными действиями запуска.

Синтаксис URL

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

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

?arg={Layer.Attribute}&arg={Attribute}

Примечание:

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

См. примеры ниже:

Одно значение

?Name={KNOWNAS}&building={facility_name}&space={Units.Name}

Несколько значений

?center={shape.y},{shape.x}

Значение из другого класса объектов

&site={FACILITIES.SITE_ID}

Передача значения в указанное поле

&field:room={units.name}

Поддерживаемые форматы аргументов и значений

URL действия запуска может поддерживать как передачу значения с универсальным аргументом (field={Units.UNIT_ID}), так или передачу значения в нужно поле в форме Survey123 (field:room={Units.Name}).

Кроме того, можно одновременно перечислить вместе несколько аргументов и вы можете добавить текст между ними.

Пример

https://<MySurveyURL>?Name={knownas}&office=office%3A%20{units.NAME}&loc={shape.x},{shape.y},{shape.z}

Интеграция с Survey123

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

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

Когда вы создаете опрос в своей организации ArcGIS Online, URL-адрес для общего доступа к этому опросу по умолчанию укорачивается. Чтобы включить запуск действий, вы должны использовать полный URL-адрес при добавлении аргументов и пар. Чтобы получить полный URL-адрес существующего опроса, выполните следующие действия:

  1. В Survey123 щелкните вкладку Мои опросы и выберите опрос, для которого вы желаете создать действие запуска.
  2. Щелкните вкладку Сотрудничество и выберите Опубликовать опрос.
  3. Скопируйте укороченный URL-адрес, вставьте его в браузер и загрузите опрос.

    Полный URL-адрес появится в адресной строке.

  4. Скопируйте полный URL-адрес из адресной строки.

Теперь вы можете добавлять аргументы и пары к этому URL-адресу по мере необходимости при настройке действий запуска

Пример: Базовый URL для поведения по умолчанию

https://survey123.arcgis.com/share/surveyformGUID?portalUrl=https://myportal.myorg.com/portal

Пример: Пользовательская настройка

В этом примере перезаписывается входное значение комнаты по умолчанию на поле с именами из слоя Units.

https://survey123.arcgis.com/share/surveyformGUID?portalUrl=https://myportal.myorg.com/portal&field:room={Units.NAME}

Пример: Запуск нативного приложения Survey123 на мобильных устройствах

arcgis-survey123://?itemID=surveyformGUID&portalUrl=https://myportal.myorg.com/portal&field:comments={Units.NAME}

Примечание:

Будьте аккуратны при использовании специальных URL в нативных мобильных приложениях при настройке действий запуска для использования в Viewer, поскольку они не поддерживаются в настольных клиентах. Когда будете задавать действия запуска для рабочих процессов, поддерживающих свои приложения Indoors или Viewer из мобильного браузера, используйте URL-адрес только своих приложений.

Интеграция со сторонними системами

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

При работе со сторонними системами помните о следующем:

  • Операторы field: могут быть разными.
  • Веб-формы, которые поддерживают аргументы URL, могут потребовать дополнительной настройки.
  • Посмотрите документацию по интегрируемой системе, чтобы получить дополнительную информацию об особенностях ее работы.

Примечание:

В некоторых случаях, в зависимости от используемой бизнес-системы, ряд символов может не поддерживаться, например, символы # или +.

Интеграция с системами управления рабочими заказами

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

Indoors поддерживает передачу рабочих заданий и атрибутов слоя Indoors в виде строки запроса в URL. Синтаксис должен соответствовать схеме URL/URI Indoors и системе приложений заказов на работу для поддержки действий запуска.

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

?arg={Work order Attribute}&arg={Layer.Attribute}

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

Одно значение из слоя рабочих заданий

?arg={workorderid}

Несколько значений из слоя рабочих заданий

?arg={workorderid}&arg={priority}

Значение из рабочих заданий и слоя Indoors

?arg={workorderid}&arg={Layer.Attribute}

ServiceNow URL

В примере ниже номер рабочего задания передается в виде параметра и открывается нужное существующее задание:

https://<MyServerURL>/nav_to.do?uri=task.do?sysparm_query=number={workorderid}

См. больше примеров по настройке действий запуска для ServiceNow.