Настройка действий запуска для приложений Indoors—ArcGIS Pro

Доступно с порталом, лицензированным функциональными возможностями Indoors.

ArcGIS Indoors включает поддержку действий запуска сторонних приложений непосредственно из информационной панели в Indoor Viewer и информационной карточки в ArcGIS Indoors for iOS и ArcGIS Indoors for Android. Эти действия запуска позволяют организациям Indoors легко интегрировать информацию, связанную с элементами Indoors или элементами, доступными в дополнительных рабочих заданиях, активах и других слоях объектов интереса, которые могут быть включены в карту Indoors, из других бизнес-систем, позволяя пользователям приложений Indoors напрямую запускать сторонние приложения. Действие запуска можно настроить на открытие веб-страницы или исходного мобильного приложения, чтобы пользователи могли отправлять инциденты или запросы к выбранному элементу в Indoors и автоматически заполнять поля формы информацией из элемента или открывать веб-страницу или мобильное приложение непосредственно с информацией, связанной с выбранным элементом в Indoors.

Возможность включать действия запуска упрощает работу пользователей приложения Indoors отчитываться об объектах и других элементах на карте Indoors, а также находить дополнительные сведения, связанные с этими элементами, не теряясь при переходе между приложениями, поддерживающими несколько бизнес-систем. Это можно сделать, настроив параметр APP_LAUNCH_ACTIONS в таблице Indoors Configuration в ArcGIS Pro.

При подготовке базы данных Indoors для публикации веб-карт и пакетов мобильной карты, которые используются в приложениях Indoors, вы можете дополнительно указать действия запуска для выбранных слоев и/или категорий, включив правильно отформатированную строку JSON в параметр конфигурации APP_LAUCH_ACTIONS перед публикацией веб-карты или пакета мобильного приложения.

Примечание:

Если сотрудники вашей организации, которые используют Viewer, не работают с нативными мобильными приложениями Indoors, то вы можете пропустить этот шаг и использовать панель конфигурации, который идет вместе с Viewer, для настройки действий запуска, которые должны быть включены в экземпляр настраиваемого приложения ArcGIS Indoors. Если же вы ожидаете, что сотрудники вашей организации будут пользоваться обоими мобильными приложениями - Viewer и Indoors, - то вам лучше выбрать эту панель конфигурации в Viewer, для начала настроив действия запуска в веб-приложении, а затем скопировав получившуюся строку JSON в параметр конфигурации APP_LAUNCH_ACTIONS перед публикацией пакета мобильной карты на портал ArcGIS Enterprise.

Синтаксис JSON

Действия запуска включаются с помощью определенным образом настроенной строки JSON в параметре APP_LAUNCH_ACTIONS в таблице Indoors Configuration в ArcGIS Pro. При определении действий запуска вы можете применить эти действия как к отдельным слоям на карте, так и отдельным категориям и подкатегориям, заданным в таблице Categories.

Синтаксис этой строки JSON выглядит следующим образом:


Ключ JSON	Описание
actions	Список действий, доступных для выбранных слоев и/или категорий.
label	Название каждого действия, которое будет отображаться в списке доступных действий. Если для работы с веб-картой или пакетом мобильной карты Indoors настроено только одно действие, то для действия появится универсальный значок. Если настроено несколько действий, появится значок “больше”, а список доступных действий появится в ниспадающем меню при нажатии кнопки в приложении.
url	Соответствующим образом форматированный URL запуска.
layers	Список слоев карты, к которым будет применяться действие.
categories	Список настроенных категорий, к которым будет применяться действие.

Пример:
{
  "actions": [
    {
      "label": "Fill out survey",
      "url": " https://survey123.arcgis.com/share/surveyformGUID?portalUrl=https://myportal.myorg.com/portal?field:room={Units.NAME}",
      "layers": [
        "Units",
        "Levels"
      ],
      "categories": [
        "Places + Things",
        "Fire Extinguisher"
      ]
    },
    {
      "label": "Report Incident",
      "url": "https://servicenow.com/report?username={user.username}",
      "layers": ["*"],
      "categories": ["*"]
    },
    {
      "label": "Make Request",
      "url": "https://servicenow.com/report?username={user.username}&room={Units.NAME}",
      "layers": ["Units"]
    }
  ]
}

Обратите внимание, что в примере ниже приведены три отдельных действия. Первая категория, “Fill out survey”, была ограничена только выбранными элементами, которые находятся в слоях Units или Levels , либо категории Places + Things уровня 1, либо подкатегории Fire Extinguisher уровня 2. Это различие важно, поскольку Indoors дает вам возможность гибко ограничивать различные действия для разных типов элементов. Это особенно удобно, когда в рамках одной системы нужно поддерживать работу с разными устройствами и действиями.

Следующее действие, “Report Incident”, включает ключевые понятия для всех слоев и всех категорий в определении. Включение понятия “*” в эти списки слоев и категорий гарантирует, что любой элемент в любом слое или категории при выборе в приложениях Indoors поддерживает этот тип действия на панели информации.

Третье действие, “Make Request”, ограничено для элементов, которые находятся в одном слое и не имеют связанных категорий.

Примечание:

Действия могут назначаться как к слоям, так и к категориям, так и к их сочетанию. Однако не рекомендуется назначать действие одновременно к слою и категории. Назначение действия слою, представленному категориями, приведет к применению этого действия ко всем категориям и подкатегориям, настроенным для этого слоя.
Действия, назначенные категории уровня 1 будут автоматически доступны для связанных с ним категорий уровня 2 и их не нужно будет дублировать в списке категории. Действия, назначенные для подкатегории уровня 2 доступны только для элементов, указанных в этой подкатегории.
Действия, для которых не настроены слои или категории, не будут отображаться в приложениях 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 Поддерживает передачу рабочих заданий и атрибутов слоя Indoors в виде строки запроса в URL. Синтаксис должен соответствовать схеме 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.

Задайте строку конфигурации действия запуска в таблице Конфигурации Indoors

Один или несколько URL-адресов сторонних приложений должны быть добавлены в таблицу Конфигурации Indoors, чтобы отобразить кнопку действия на информационной карточке Indoors for iOS или Indoors for Android. Действия запускаViewer можно настроить на панели конфигурации, но если в Таблице конфигурации Indoors содержится допустимая строка конфигурации JSON, панель конфигурации будет использовать это значение в качестве настройки по умолчанию. Таблица Indoors Configuration - автономная таблица Информационной модели ArcGIS Indoors. Она должна быть добавлена при создании пакета мобильной карты для мобильных приложений Indoors, но необязательна для веб-карты для Viewer.

Выполните следующие действия, чтобы настроить действие запуска с одним или несколькими URL-адресами в таблице Конфигурации Indoors:

На панели Содержание ArcGIS Pro щелкните правой кнопкой Конфигурация Indoors и выберите Открыть.
Откроется вид таблицы Конфигурация Indoors.
Дважды щелкните поле Значение конфигурации для APP_LAUCH_ACTIONS (под значением конфигурации) и задайте строку конфигурации JSON для настроенных вами действий.
Примечание:
Если действия APP_LAUCH_ACTIONS не заданы,кнопка действия запуска будет выключена на карточке информации в Indoors for Android и Indoors for iOS.

Отзыв по этому разделу?