Синтаксис действий запуска

Доступно с порталом, лицензированным функциональными возможностями Indoors.​

ArcGIS Indoors включает поддержку действий запуска сторонних приложений непосредственно из информационной панели Indoor Viewer и информационной карточки в Indoors. Действия запуска можно настроить на панели Настроить действия запуска Indoors в ArcGIS Pro и изменить при конфигурировании приложения Viewer на вашем портале ArcGIS Enterprise или в организации ArcGIS Online.

Синтаксис 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.

Пример: Базовый 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, поскольку они не поддерживаются в настольных клиентах. Использование URL нативных приложений при определении действий запуска должно быть ограничено рабочими процессами, которые поддерживают нативные приложения Indoors или Viewer либо получены из мобильного браузера.

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

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

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

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

Примечание:

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

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

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

Indoors Поддерживает передачу рабочих заданий и атрибутов слоя Indoors в виде строки запроса в URL. Синтаксис должен соответствовать схеме URL / URL для 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.