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

Доступно для организации 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-адрес существующего опроса, выполните следующие действия:

  1. В Survey123 щелкните вкладку Мои опросы и выберите опрос, для которого вы желаете создать действие запуска.
  2. Щелкните вкладку Сотрудничество и выберите Опубликовать опрос.
  3. Скопируйте укороченный URL-адрес, вставьте его в браузер и загрузите опрос.

    Полный URL-адрес появится в адресной строке.

  4. Скопируйте полный 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.