Настройка действий запуска для Indoor Viewer

ArcGIS Enterprise (10.9.1)    |

Доступно для организации ArcGIS, имеющей лицензию на дополнительный модуль Indoors.

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

Действие запуска может быть настроено для открытия веб-страницы или собственного мобильного приложения и автоматической передачи данных indoor в целевую систему или приложение. Это позволит людям отправлять инциденты или запросы к выбранному элементу в Viewer. Пользователи могут просматривать информацию о выбранном в приложении Viewer элементе и автоматически заполнять поля формы обновленной информацией с помощью веб-страницы или мобильного приложения.

Вы можете настроить действия запуска в Viewer следующими способами:

  • Использование панели Настройка действий запуска Indoors в ArcGIS Pro. Действия запуска, настроенные в ArcGIS Pro, можно впоследствии изменить в ходе настройки приложения.
    Примечание:

    Изменения панели Настроить приложения влияют только на действия запуска в приложении Viewer.

  • Использование панели Настроить приложение при создании и изменении приложения. На панели конфигурации вы можете изменить действия запуска, созданные в ArcGIS Pro, или создать новые.

Примечание:

Indoors позволяет размещать булавки для местоположений, находящихся вне здания, например, садов кампуса или придомовых территорий. Если действие запуска применяется ко Всем слоям на панели конфигурации, для этих поставленных булавок также будет доступно действие.

Настройка действий запуска на панели конфигурации

В ходе настройки приложения Viewer выполните следующие шаги для изменения этих действий запуска приложения, созданных в ArcGIS Pro, или создания новых действий:

  1. На панели Настроить приложение перейдите в раздел Запуск приложения.
    Примечание:

    Если вы настроите действия запуска в ArcGIS Pro, они появляются в разделе Запуск приложения, и вы при необходимости сможете их обновить.

  2. По желанию добавьте новое действие.
    1. Щелкните Добавить, чтобы добавить новое действие.
    2. Укажите имя действия в текстовом поле Надпись.
    3. Добавьте URL-ссылку для действия в текстовом поле URL.
    4. Щелкните Выбрать категории и слои и поставьте отметки для слоев и категорий, с которыми вы хотите связать это действие.

      По умолчанию выбраны все слои и подкатегории.

    5. Нажмите OK.
    6. Повторите шаги для любых дополнительных действий.
  3. Щелкните кнопку Удалить Удалить рядом с действиями запуска, которые вы хотите удалить.
  4. При необходимости измените порядок действий с помощью стрелок вверх и вниз.
  5. Щелкните Сохранить, чтобы сохранить обновления в шаблоне приложения.

Действия запуска отображаются в списке, когда вы нажимаете на кнопку Дополнительно Больше на информационной панели для возможностей категорий и слоев с настроенными действиями запуска.

URL syntax

Launch actions are enabled by URLs, and the syntax must follow common URL conventions. For example, special characters in the arguments must be URL encoded, and the argument or value pairs must be separated with standard URL conventions.

For Indoors, values must be contained in curly brackets and match the following syntax:

?arg={Layer.Attribute}&arg={Attribute}

Примечание:

The layer is optional and, if not included, defaults to the active item in the Indoors app. Many use cases require passing attributes from a different layer in the map or scene. This is supported with the layer operator. Arguments and values are not case sensitive.

See the following samples:

Single value

?Name={KNOWNAS}&building={facility_name}&space={Units.Name}

Multiple values

?center={shape.y},{shape.x}

Value from another feature class

&site={FACILITIES.SITE_ID}

Pass value to a specific field

&field:room={units.name}

Supported argument and value formats

The launch action URL can support either passing a value with a generic argument (field={Units.UNIT_ID}) or pointing the value at a specific field in the Survey123 form (field:room={Units.Name}).

In addition, multiple arguments can be listed together, and you can add text between them.

Example

https://<MySurveyURL>?Name={knownas}&office=office%3A%20{units.NAME}&loc={shape.x},{shape.y},{shape.z}

Интеграция с Survey123

Survey123 is included with your Indoors license. In the absence of any other supported work order or ticketing system, launch actions can be configured to use Survey123.

To customize the experience of the action button with Survey123, append valid argument or value pairs onto the URL.

When you create a survey in your ArcGIS Online organization, the URL to share the survey is shortened by default. To enable launch actions, you must use the full URL when appending arguments and pairs. To get the full URL for an existing survey, complete the following:

  1. In Survey123, click the My Surveys tab and click the survey for which you want to create a launch action.
  2. Click the Collaborate tab and click Share survey.
  3. Copy the shortened URL, paste it into a browser, and load the survey.

    The full URL appears in the address bar.

  4. Copy the full URL from the address bar.

You can now append arguments and pairs to this URL as necessary when configuring launch actions.

Example: Base URL for default behavior

https://survey123.arcgis.com/share/surveyformGUID?portalUrl=https://myportal.myorg.com/portal

Example: Custom

This example overrides the default room input with the name field from the Units layer.

https://survey123.arcgis.com/share/surveyformGUID?portalUrl=https://myportal.myorg.com/portal&field:room={Units.NAME}

Example: Launch the Survey123 native app on mobile devices

arcgis-survey123://?itemID=surveyformGUID&portalUrl=https://myportal.myorg.com/portal&field:comments={Units.NAME}

Примечание:

Be careful when using URLs specific to native mobile apps when configuring launch actions for use in Viewer as these are not supported for desktop users. Using a native app's URL when defining launch actions should be limited to workflows supporting the native Indoors apps or Viewer accessed from a mobile browser.

Integration with third-party systems

The action button can also be configured to open a third-party URL and pass attribute values to it, provided that the third-party system supports URL configurable forms or parameters to drive actions upon launch. In this case, use a URL that calls the system in the Indoors app configuration with an appropriate URL for the integrated system. Some common uses are linking to third-party work order management systems or asset management systems.

Consider the following when working with third-party systems:

  • The field: operator may be different.
  • Web forms that support URL arguments may require additional configuration.
  • Consult the integrated system vendor for details on whether and how this works.

Примечание:

In some cases, depending on the business system being used, some characters may not be supported, such as the # or + characters.

Интеграция с системами управления рабочими заказами

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

Indoors supports passing work order and Indoors layer attributes as a query string in the URL. The syntax must follow the URL/URI schema for Indoors and work order app system to support launch actions.

The attribute value must be enclosed in curly brackets and match the following syntax:

?arg={Work order Attribute}&arg={Layer.Attribute}

The following are additional syntax samples:

Single value from work order layer

?arg={workorderid}

Multiple values from work order layer

?arg={workorderid}&arg={priority}

Value from work order and Indoors layer

?arg={workorderid}&arg={Layer.Attribute}

ServiceNow URL

The following sample passes the work order number as a parameter and opens an existing work order:

https://<MyServerURL>/nav_to.do?uri=task.do?sysparm_query=number={workorderid}

See more examples of configuring launch actions for ServiceNow.