Available for an ArcGIS organization licensed with the Indoors extension.
ArcGIS Indoors включает поддержку действий запуска сторонних приложений непосредственно из информационной панели в Indoor Viewer. Эти действия запуска позволяют организациям Indoors легко интегрировать информацию из других бизнес-систем. Действие запуска можно настроить на открытие веб-страницы или исходного мобильного приложения. Это позволяет пользователям отправлять инциденты или запросы к выбранному элементу в Indoors. Пользователи могут просматривать информацию о выбранном элементе из Indoors и автоматически заполнять поля формы обновленной информацией с помощью веб-страницы или мобильного приложения.
Синтаксис 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 на мобильных устройствах
"url": "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 в виде строки запроса в 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.
Задание строки конфигурации действия запуска
Действия запуска для Viewer можно настроить несколькими способами. Допустимая строка конфигурации JSON может быть указана в таблице Настройка Indoors в ArcGIS Pro.
Действия запуска также можно задать в конфигураторе на портале, когда приложение создается из шаблона Indoor Viewer. В этом случае, если строка действия запуска присутствует в таблице Настройка Indoors, она предоставляет значения по умолчанию для действий запуска. Любые изменения, внесенные на панели конфигуратора, переопределяют настройки в таблице Настройка Indoors.
После настройки действий запуска приложения в конфигураторе Viewer они могут быть экспортированы для использования в ArcGIS Indoors for iOS и ArcGIS Indoors for Android.