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