Доступно для организации ArcGIS, имеющей лицензию на дополнительный модуль Indoors.
ArcGIS Indoors включает поддержку действий запуска сторонних приложений непосредственно из информационной панели в Indoor Viewer и информационные карточки в мобильных приложениях Indoors. Действия запуска можно настроить на панели Настройка действий запуска Indoors в ArcGIS Pro, и их можно изменить при настройке приложения Viewer в вашей организации ArcGIS.
Синтаксис 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-адрес существующего опроса, выполните следующие действия:
- В Survey123 щелкните вкладку Мои опросы и выберите опрос, для которого вы желаете создать действие запуска.
- Щелкните вкладку Сотрудничество и выберите Опубликовать опрос.
- Скопируйте укороченный URL-адрес, вставьте его в браузер и загрузите опрос.
Полный URL-адрес появится в адресной строке.
- Скопируйте полный 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 поддерживает передачу рабочих заданий и атрибутов слоя 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.