Настройка действий запуска
Доступно с дополнительным модулем ArcGIS Indoors Maps.
ArcGIS Indoors включает поддержку действий запуска сторонних приложений непосредственно из информационной панели в Indoors Viewer. Действия запуска приложений позволяют интегрировать ваши ключевые бизнес‑системы с ArcGIS Indoors.
Действие запуска может быть настроено для открытия веб-страницы или собственного мобильного приложения и автоматической передачи данных indoor в целевую систему или приложение. Это позволит пользователям отправлять инциденты или запросы к выбранному элементу в Viewer. Пользователи могут просматривать информацию о выбранном в приложении Viewer объекте и автоматически заполнять поля формы обновлёнными данными с помощью веб‑страницы или мобильного приложения.
Вы можете настроить действия запуска в Viewer следующими способами:
Использование панели Настройка действий запуска Indoors в ArcGIS Pro. Действия запуска, настроенные в ArcGIS Pro, можно впоследствии изменить в ходе настройки приложения.
Примечание:
Изменения, внесённые на панели Настроить приложения, влияют только на действия запуска в приложении Viewer. Любые изменения действий запуска, выполненные в приложении Viewer, имеют приоритет над действиями запуска, настроенными в ArcGIS Pro.
Использование панели Настроить приложение при создании и изменении приложения. На панели конфигурации вы можете изменить действия запуска, созданные в ArcGIS Pro, или создать новые.
Примечание:
Indoors позволяет размещать булавки для местоположений, находящихся вне здания, например, садов кампуса или придомовых территорий. Если действие запуска применяется ко Всем слоям на панели конфигурации, для этих поставленных булавок также будет доступно действие.
Настройка действий запуска на панели конфигурации
Во время настройки приложения Viewer выполните следующие действия, чтобы изменить действия запуска, созданные в ArcGIS Pro, или создать новые:
На панели Настроить приложение перейдите в раздел Запуск приложения.
Примечание:
Если вы настроили действия запуска в ArcGIS Pro, они отображаются в разделе Запуск приложения. При желании их можно обновить.
По желанию добавьте новое действие.
Щелкните Добавить, чтобы добавить новое действие.
Укажите имя действия в текстовом поле Надпись.
Добавьте URL-ссылку для действия в текстовом поле URL.
Щелкните Выбрать категории и слои и поставьте отметки для слоев и категорий, с которыми вы хотите связать это действие.
По умолчанию выбраны все слои и подкатегории.
Нажмите OK.
Повторите шаги для любых дополнительных действий.
Нажмите кнопку Удалить
рядом с действиями запуска, которые вы хотите удалить.При необходимости измените порядок действий с помощью стрелок вверх и вниз.
Щелкните Сохранить, чтобы сохранить обновления в шаблоне приложения.
Действия запуска отображаются в списке, когда вы нажимаете на кнопку Дополнительно
на информационной панели для возможностей категорий и слоев с настроенными действиями запуска.
Синтаксис 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}
Примечание:
Если слои Sites, Facilities или Levels из модели Indoors переименованы, вы все равно можете использовать имена слоев модели Indoors для свойства LayerName в синтаксисе {LayerName.Attribute}. Например, если слой Facilities переименован в Buildings, атрибут из этого слоя можно включить в URL-адрес действия запуска, используя синтаксис {Buildings.Name} или {Facilities.Name}.
Интеграция с Survey123
Доступ к ArcGIS Survey123 могут получить определенные типы пользователей. Действия запуска можно настроить на использование 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 и способна управлять действиями при запуске. Используйте 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.